Amazon CloudFront

Crawler

Overview

Amazon CloudFront is a global content delivery network (CDN) service that accelerates delivery of your websites, APIs, video content or other web assets.

Enable this integration to see in Datadog all your CloudFront metrics.

Setup

Installation

If you haven’t already, set up the Amazon Web Services integration first.

Metric collection

In the AWS integration tile, ensure that CloudFront is checked under metric collection.
Install the Datadog - AWS CloudFront integration.
Optional: Enable Additional CloudFront Distribution Metrics for more visibility into the performance of your CloudFront traffic.

Log collection

Enable Cloudfront Logging

When you enable logging for a distribution, specify the Amazon S3 bucket that you want CloudFront to store log files in. If you’re using Amazon S3 as your origin, we recommend that you do not use the same bucket for your log files; using a separate bucket simplifies maintenance.

Important note: Store the log files for multiple distributions in the same bucket. When enabling logging, specify cloudfront as prefix for the file names, to keep track of which log files are associated with which distributions.

Send Logs to Datadog

If you haven’t already, set up the Datadog log collection AWS Lambda function.
Once the lambda function is installed, manually add a trigger on the S3 bucket that contains your Cloudfront logs in the AWS console, in your Lambda, click on S3 in the trigger list:

Configure your trigger by choosing the S3 bucket that contains your Cloudfront logs and change the event type to Object Created (All) then click on the add button.

Once done, go in your Datadog Log section to start exploring your logs!

Data Collected

Metrics

aws.cloudfront.4xx_error_rate (gauge)	The percentage of all requests for which the HTTP status code is 4xx. Shown as percent
aws.cloudfront.5xx_error_rate (gauge)	The percentage of all requests for which the HTTP status code is 5xx. Shown as percent
aws.cloudfront.bytes_downloaded (count)	The number of bytes downloaded by viewers for GET, HEAD, and OPTIONS requests. Shown as byte
aws.cloudfront.bytes_uploaded (count)	The number of bytes uploaded to your origin with CloudFront using POST and PUT requests. Shown as byte
aws.cloudfront.requests (count)	The number of requests for all HTTP methods and for both HTTP and HTTPS requests.
aws.cloudfront.total_error_rate (gauge)	The percentage of all requests for which the HTTP status code is 4xx or 5xx. Shown as percent
aws.cloudfront.401_error_rate (gauge)	The percentage of all viewer requests for which the response’s HTTP status code is 401 (Additional Metrics must be enabled). Shown as percent
aws.cloudfront.403_error_rate (gauge)	The percentage of all viewer requests for which the response’s HTTP status code is 402 (Additional Metrics must be enabled). Shown as percent
aws.cloudfront.404_error_rate (gauge)	The percentage of all viewer requests for which the response’s HTTP status code is 404 (Additional Metrics must be enabled). Shown as percent
aws.cloudfront.502_error_rate (gauge)	The percentage of all viewer requests for which the response’s HTTP status code is 502 (Additional Metrics must be enabled). Shown as percent
aws.cloudfront.503_error_rate (gauge)	The percentage of all viewer requests for which the response’s HTTP status code is 503 (Additional Metrics must be enabled). Shown as percent
aws.cloudfront.504_error_rate (gauge)	The percentage of all viewer requests for which the response’s HTTP status code is 504 (Additional Metrics must be enabled). Shown as percent
aws.cloudfront.origin_latency (gauge)	The total time spent from when CloudFront receives a request to when it starts providing a response to the network (not the viewer) for requests that are served from the origin (not the CloudFront cache). This is also known as first byte latency or time-to-first-byte (Additional Metrics must be enabled). Shown as second
aws.cloudfront.cache_hit_rate (gauge)	The percentage of all cacheable requests for which CloudFront served the content from its cache. HTTP POST and PUT requests (and errors) are not considered cacheable requests (Additional Metrics must be enabled). Shown as percent

Each of the metrics retrieved from AWS will be assigned the same tags that appear in the AWS console, including but not limited to aws_account, region, and distributionid.

Events

The AWS Cloudfront integration does not include any events.

Service Checks

The AWS Cloudfront integration does not include any service checks.

Troubleshooting

Need help? Contact Datadog support.