Amazon CloudFront monitoring integration

Important

Enable the AWS CloudWatch Metric Streams integration to monitor all CloudWatch metrics from your AWS services, including custom namespaces. Individual integrations are no longer our recommended option.

New Relic infrastructure integrations include an integration for reporting Amazon CloudFront service data to New Relic. This document explains how to activate this integration and describes the data that can be reported.

Features

Amazon CloudFront is an Amazon web service that speeds up the distribution of your web content. With the New Relic CloudFront integration, you can track CloudFront data in New Relic, including error rates, request counts, and uploaded/downloaded bytes. You can track your CloudFront configuration and see how configuration changes impact performance. You can also create custom queries of your CloudFront integration data and custom charts.

Activate integration

To enable this integration follow standard procedures to Connect AWS services to New Relic.

Configuration and polling

You can change the polling frequency and filter data using configuration options.

Default polling information for the Amazon CloudFront integration:

New Relic polling interval: 5 minutes
Amazon CloudWatch data interval: 1 minute, with up to 1 minute delay because CloudFront sometimes reports partial data

If you're using Lambda@Edge to customize content that CloudFront delivers so to execute Lambda functions in AWS locations closer to your clients, you can enable the Collect Lambda@Edge data filter in order to get Lambda execution location metadata.

Find and use data

To find your integration data, go to one.newrelic.com > Infrastructure > AWS and select one of the CloudFront integration links.

You can query and explore your data using the LoadBalancerSample event type, with a provider value of CloudFrontDistribution.

For more on how to use your data, see Understand and use integration data.

Metric data

The following data is collected for CloudFront Web distributions. Data is not available for RTMP distributions.

Metric	Description
`requests`	The number of requests for all HTTP methods and for both HTTP and HTTPS requests.
`bytesDownloaded`	The number of bytes downloaded by viewers for `GET`, `HEAD`, and `OPTIONS requests`.
`bytesUploaded`	The number of bytes uploaded to your origin with CloudFront using `POST` and `PUT` requests.
`totalErrorRate`	The percentage of all requests for which the HTTP status code is `4xx` or `5xx`.
`4xxErrorRate`	The percentage of all requests for which the HTTP status code is `4xx`.
`5xxErrorRate`	The percentage of all requests for which the HTTP status code is `5xx`.

Inventory data

EOL NOTICE

After March 2022, we're discontinuing support for several capabilities, including inventory data for cloud integrations. For more details, including how you can easily prepare for this transition, see our Explorers Hub post.

CloudFront configuration options are reported as inventory data. For more on inventory data and how to find it and use it, see Understand integration data.

Name	Description
`aliases`	For more information, see Using alternate domain names (CNAMEs).
`domainName`	When you create a distribution, CloudFront returns a domain name for the distribution. For more information, see Using alternate domain names (CNAMEs).
`enabled`	A boolean. For the distribution state, `enabled` allows CloudFront to process requests as soon as the distribution is created. For more information, see Getting started with CloudFront: create a CloudFront Web Distribution.
`origins`	JSON format. For more information, see Origin settings.
`priceClass`	For more information, see Choosing the Price Class for a CloudFront Distribution.
`status`	For more information, see Distribution status.
`cacheBehaviours`	JSON format. For more information, see Cache behavior settings.
`certificateIsDefault`	A boolean. For viewers to use HTTPS to access your objects, you can choose to use the default CloudFront HTTPS certificate.
`certificateMinProtocolVersion`	The minimum version of the SSL protocol that you want CloudFront to use for HTTPS connections. CloudFront serves your objects only to browsers or devices that support at least the SSL version that you specify. For valid values, see the `MinimumProtocolVersion` content for the ViewerCertificate data type.
`customErrors`	A JSON string that contains a variety of information about the CloudFront instance configuration. For more information, see Customizing error responses.
`defaultCacheBehaviour`	A JSON string representing the default cache behavior for all CloudFront requests. For more information, see Cache behavior settings.
`restriction`	A JSON string that contains a variety of information about the CloudFront instance configuration. For more information, see Restricting the geographic distribution of your content.
`restrictionType`	For more information, see CloudFront distributionConfig restrictions.
`webAclId`	The AWS WAF web ACL to associate with this distribution. AWS WAF is a web application firewall that enables you to monitor the HTTP and HTTPS requests that are forwarded to CloudFront and to control who can access your content.