AWS Route 53 monitoring integration

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

New Relic Infrastructure's integrations include an integration for reporting your Amazon Route 53 data to New Relic products. This document explains how to activate the integration and describes the data reported.

Features

Amazon Route 53 helps you register domain names, route Internet traffic to the appropriate resources, and check the health of your resources to make sure your web app is always up and running.

For AWS health-checks, Amazon Route 53 determines whether a resource record set is healthy based on one of the following criteria:

  • By periodically sending a request to the endpoint that is specified in the health check
  • By aggregating the status of a specified group of health checks (calculated health checks)
  • By determining the current state of a CloudWatch alarm (CloudWatch metric health checks)

Data reported to New Relic includes connection time, health checks, time to first bite, and other metrics and inventory data. Route 53 data is available in pre-built dashboards and you can also create custom queries and charts in New Relic Insights.

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 Route 53 integration:

  • New Relic polling interval: 5 minutes
  • Amazon CloudWatch data interval: 1 minute

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 Route 53 integration links.

In New Relic Insights, data is attached to the HealthCheckSample event type, with a provider value of Route53HealthCheck.

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

Metric data

New Relic Infrastructure Integrations supports the following Route 53 health check metrics. For more details on these metrics, see Amazon's Route 53 documentation.

Name Description
ChildHealthCheckHealthyCount For a calculated health check, the number of health checks that are healthy among the health checks that Amazon Route 53 is monitoring.
ConnectionTime The average time, in milliseconds, that it took Amazon Route 53 health checkers to establish a TCP connection with the endpoint. You can view ConnectionTime for a health check either across all regions or for a selected geographic region.
HealthCheckPercentageHealthy The percentage of Amazon Route 53 health checkers that consider the selected endpoint to be healthy. You can view HealthCheckPercentageHealthy only across all regions; data is not available for a selected region.
HealthCheckStatus The status of the health check endpoint that CloudWatch is checking. 1 indicates healthy, and 0 indicates unhealthy. You can view HealthCheckStatus only across all regions; data is not available for a selected region.
SSLHandshakeTime The average time, in milliseconds, that it took Amazon Route 53 health checkers to complete the SSL handshake. You can view SSLHandshakeTime for a health check either across all regions or for a selected geographic region.
TimeToFirstByte The average time, in milliseconds, that it took Amazon Route 53 health checkers to receive the first byte of the response to an HTTP or HTTPS request. You can view TimeToFirstByte for a health check either across all regions or for a selected geographic region.

Inventory data

This integration collects the following Amazon Route 53 inventory attributes under the key aws/route53. For more about inventory data, see Understand integration data.

Name Description
domainName Name of the domain.
zoneId ID of the hosted zone.
isPrivate Boolean representing whether a zone is private or not.
comment Any comments about the hosted zone.
Name Description
name Name of the Record Set.
ttl The resource record cache time to live (TTL), in seconds.
type DNS record type
weight Weighted resource record sets only: Among resource record sets that have the same combination of DNS name and type, a value that determines the proportion of DNS queries that Amazon Route 53 responds to using the current resource record set. See Route53 documentation for more info.
aliasTarget Information about the CloudFront distribution, AWS Elastic Beanstalk environment, ELB load balancer, Amazon S3 bucket, or Amazon Route 53 resource record set to which you're redirecting queries. JSON format.
failover The failover resource record.
geoLocation Geolocation configuration for the record set, including country code, continent code or subdivision code. JSON format.
healthCheckId Returned in response to a DNS query when the health check is passed. For more information about Route 53 health check criteria, see Amazon's documentation on determining whether an endpoint is healthy.
Region Region where the record set resides
records

Structure containing specific information about the resource record. JSON format. For example: [{"value":"\"v=spf1 include:_spf.google.com ~all\""}].

Name Description
id Name of the Record Set.
config Including the HealthCheckConfig structure: Type of Health Check configured (or Health Check Thereshold) if health check is acting in negative logic, and the child health checks in case of calculated health checks. JSON format.
alarmConfiguration Including the AlarmIdentifier structure: Alarm Name, Health Check ID and Region. JSON format.

For more help

Recommendations for learning more: