AWS CloudFront monitoring integration

Access to this feature depends on your subscription level. Requires Infrastructure Pro.

New Relic Infrastructure integrations include an integration for reporting AWS CloudFront service data to New Relic products. 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 Infrastructure, including error rates, request counts, and uploaded/downloaded bytes. You can track your CloudFront configuration and see how configuration changes impact performance. And, with New Relic Insights, you can create custom queries of your CloudFront integration data and custom charts.

Activate integration

To enable this integration:

  1. Make sure you have installed the Infrastructure agent before you activate AWS integrations from your Infrastructure account.
  2. Follow standard procedures to Connect AWS services to Infrastructure.

Configuration and polling

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

Default polling information for the AWS 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 in Infrastructure, go to infrastructure.newrelic.com > Integrations > Amazon Web Services and select one of the CloudFront integration links.

In New Relic Insights, data is attached to 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

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.

Inventory 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.

For more help

Recommendations for learning more: