Menu
Amazon CloudFront
Developer Guide (API Version 2016-09-07)

CloudFront Usage Reports

The Amazon CloudFront console can display a graphical representation of your CloudFront usage that is based on a subset of the usage report data. You can display charts for a specified date range in the last 60 days, with data points every hour or every day. You can usually view data about requests that CloudFront received as recently as four hours ago, but data can occasionally be delayed by as much as 24 hours.

For more information, see How the Usage Charts Are Related to Data in the CloudFront Usage Report.

To display CloudFront usage charts

  1. Sign in to the AWS Management Console and open the CloudFront console at https://console.aws.amazon.com/cloudfront/.

  2. In navigation pane, click Usage Reports.

  3. In the CloudFront Usage Reports pane, for Start Date and End Date, select the date range for which you want to display usage charts. Available ranges depend on the value that you select for Granularity:

    • Daily — To display charts with one data point per day, select any date range in the previous 60 days.

    • Hourly — To display charts with one data point every hour, select any date range of up to 14 days within the previous 60 days.

    Dates and times are in Coordinated Universal Time (UTC).

  4. For Granularity, specify whether to display one data point per day or one data point per hour in the charts. If you specify a date range greater than 14 days, the option to specify one data point per hour is not available.

  5. For Billing Region, choose the CloudFront billing region that has the data you want to view, or choose All Regions. Usage charts include data for requests that CloudFront processes in edge locations in the specified region. The region where CloudFront processes requests might or might not correspond with the location of your users.

    Select only regions that are included in the price class for your distribution; otherwise, the usage charts probably won't contain any data. For example, if you chose Price Class 200 for your distribution, the South America and Australia billing regions are not included, so CloudFront generally won't process your requests from those regions. For more information about price classes, see Choosing the Price Class for a CloudFront Distribution.

  6. In the Distribution list, select the distributions for which you want to display data in the usage charts:

    • An individual web distribution — The charts display data for the selected CloudFront distribution. The Distribution list displays the distribution ID and alternate domain names (CNAMEs) for the distribution, if any. If a distribution has no alternate domain names, the list includes origin domain names for the distribution.

    • All Web Distributions (excludes deleted) — The charts display summed data for all web distributions that are associated with the current AWS account, excluding web distributions that you have deleted.

    • All Deleted Distributions — The charts display summed data for all web distributions that are associated with the current AWS account and that were deleted in the last 60 days.

  7. Click Update Graphs.

  8. To view data for a daily or hourly data point within a chart, move your mouse pointer over the data point.

  9. For charts that show data transferred, note that you can change the vertical scale to gigabytes, megabytes, or kilobytes for each chart.

Downloading Data in CSV Format

You can download the Usage report in CSV format. This section explains how to download the report and describes the values in the report.

To download the Usage report in CSV format

  1. While viewing the Usage report, click CSV.

  2. In the Opening file name dialog box, choose whether to open or save the file.

Information About the Report

The first few rows of the report include the following information:

Version

The version of the format for this CSV file.

Report

The name of the report.

DistributionID

The ID of the distribution that you ran the report for, ALL if you ran the report for all distributions, or ALL_DELETED if you ran the report for all deleted distributions.

StartDateUTC

The beginning of the date range for which you ran the report, in Coordinated Universal Time (UTC).

EndDateUTC

The end of the date range for which you ran the report, in Coordinated Universal Time (UTC).

GeneratedTimeUTC

The date and time on which you ran the report, in Coordinated Universal Time (UTC).

Granularity

Whether each row in the report represents one hour or one day.

BillingRegion

The continent that viewer requests originated from, or ALL, if you chose to download the report for all billing regions.

Data in the Usage Report

The report includes the following values:

DistributionID

The ID of the distribution that you ran the report for, ALL if you ran the report for all distributions, or ALL_DELETED if you ran the report for all deleted distributions.

FriendlyName

An alternate domain name (CNAME) for the distribution, if any. If a distribution has no alternate domain names, the list includes an origin domain name for the distribution.

BillingRegion

The CloudFront billing region that you ran the report for, or ALL.

TimeBucket

The hour or the day that data applies to, in Coordinated Universal Time (UTC).

HTTP

The number of HTTP requests that CloudFront responded to from edge locations in the selected region during each time interval for the specified CloudFront distribution. Values include:

  • The number of GET and HEAD requests, which cause CloudFront to transfer data to your users

  • The number of DELETE, OPTIONS, PATCH, POST, and PUT requests, which cause CloudFront to transfer data to your origin

HTTPS

The number of HTTPS requests that CloudFront responded to from edge locations in the selected region during each time interval for the specified CloudFront distribution. Values include:

  • The number of GET and HEAD requests, which cause CloudFront to transfer data to your users

  • The number of DELETE, OPTIONS, PATCH, POST, and PUT requests, which cause CloudFront to transfer data to your origin

HTTPBytes

The total amount of data transferred over HTTP from CloudFront edge locations in the selected billing region during the time period for the specified CloudFront distribution. Values include:

  • Data transferred from CloudFront to your users in response to GET and HEAD requests

  • Data transferred from CloudFront to your origin for DELETE, OPTIONS, PATCH, POST, and PUT requests

  • Data transferred from CloudFront to your users in response to DELETE, OPTIONS, PATCH, POST, and PUT requests

HTTPSBytes

The total amount of data transferred over HTTPS from CloudFront edge locations in the selected billing region during the time period for the specified CloudFront distribution. Values include:

  • Data transferred from CloudFront to your users in response to GET and HEAD requests

  • Data transferred from CloudFront to your origin for DELETE, OPTIONS, PATCH, POST, and PUT requests

  • Data transferred from CloudFront to your users in response to DELETE, OPTIONS, PATCH, POST, and PUT requests

BytesIn

The total amount of data transferred from CloudFront to your origin for DELETE, OPTIONS, PATCH, POST, and PUT requests in the selected region during each time interval for the specified CloudFront distribution.

BytesOut

The total amount of data transferred over HTTP and HTTPS from CloudFront to your users in the selected region during each time interval for the specified CloudFront distribution. Values include:

  • Data transferred from CloudFront to your users in response to GET and HEAD requests

  • Data transferred from CloudFront to your users in response to DELETE, OPTIONS, PATCH, POST, and PUT requests

How the Usage Charts Are Related to Data in the CloudFront Usage Report

The following list shows how the usage charts in the CloudFront console correspond with values in the Usage Type column in the CloudFront usage report.

Number of Requests

This chart shows the number of HTTP and HTTPS requests that CloudFront responds to from edge locations in the selected region during each time interval for the specified CloudFront distribution.

Number of HTTP Requests
  • region-Requests-HTTP-Static: Number of HTTP GET and HEAD requests served for objects with TTL ≥ 3600 seconds

  • region-Requests-HTTP-Dynamic: Number of HTTP GET and HEAD requests served for objects with TTL < 3600 seconds

  • region-Requests-HTTP-Proxy: Number of HTTP DELETE, OPTIONS, PATCH, POST, and PUT requests that CloudFront forwards to your origin

Number of HTTPS Requests
  • region-Requests-HTTPS-Static: Number of HTTPS GET and HEAD requests served for objects with TTL ≥ 3600 seconds

  • region-Requests-HTTPS-Dynamic: Number of HTTPS GET and HEAD requests served for objects with TTL < 3600 seconds

  • region-Requests-HTTPS-Proxy: Number of HTTPS DELETE, OPTIONS, PATCH, POST, and PUT requests that CloudFront forwards to your origin

Data Transferred by Protocol

This chart shows the total amount of data transferred over HTTP and HTTPS from CloudFront edge locations in the selected region during each time interval for the specified CloudFront distribution.

Data Transferred over HTTP
  • region-Out-Bytes-HTTP-Static: Bytes served via HTTP for objects with TTL ≥ 3600 seconds

  • region-Out-Bytes-HTTP-Dynamic: Bytes served via HTTP for objects with TTL < 3600 seconds

  • region-Out-Bytes-HTTP-Proxy: Bytes returned from CloudFront to viewers via HTTP in response to DELETE, OPTIONS, PATCH, POST, and PUT requests

  • region-Out-OBytes-HTTP-Proxy: Total bytes transferred via HTTP from CloudFront edge locations to your origin in response to DELETE, OPTIONS, PATCH, POST, and PUT requests

Data Transferred over HTTPS
  • region-Out-Bytes-HTTPS-Static: Bytes served via HTTPS for objects with TTL ≥ 3600 seconds

  • region-Out-Bytes-HTTPS-Dynamic: Bytes served via HTTPS for objects with TTL < 3600 seconds

  • region-Out-Bytes-HTTPS-Proxy: Bytes returned from CloudFront to viewers via HTTPS in response to DELETE, OPTIONS, PATCH, POST, and PUT requests

  • region-Out-OBytes-HTTPS-Proxy: Total bytes transferred via HTTPS from CloudFront edge locations to your origin in response to DELETE, OPTIONS, PATCH, POST, and PUT requests

Data Transferred by Destination

This chart shows the total amount of data transferred over HTTP and HTTPS from CloudFront edge locations in the selected region during each time interval for the specified CloudFront distribution.

Data Transferred from CloudFront to Your Users
  • region-Out-Bytes-HTTP-Static: Bytes served via HTTP for objects with TTL ≥ 3600 seconds

  • region-Out-Bytes-HTTPS-Static: Bytes served via HTTPS for objects with TTL ≥ 3600 seconds

  • region-Out-Bytes-HTTP-Dynamic: Bytes served via HTTP for objects with TTL < 3600 seconds

  • region-Out-Bytes-HTTPS-Dynamic: Bytes served via HTTPS for objects with TTL < 3600 seconds

  • region-Out-Bytes-HTTP-Proxy: Bytes returned from CloudFront to viewers via HTTP in response to DELETE, OPTIONS, PATCH, POST, and PUT requests

  • region-Out-Bytes-HTTPS-Proxy: Bytes returned from CloudFront to viewers via HTTPS in response to DELETE, OPTIONS, PATCH, POST, and PUT requests

Data Transferred from CloudFront to Your Origin
  • region-Out-OBytes-HTTP-Proxy: Total bytes transferred via HTTP from CloudFront edge locations to your origin in response to DELETE, OPTIONS, PATCH, POST, and PUT requests

  • region-Out-OBytes-HTTPS-Proxy: Total bytes transferred via HTTPS from CloudFront edge locations to your origin in response to DELETE, OPTIONS, PATCH, POST, and PUT requests