Skip to content

Latest commit

 

History

History
366 lines (287 loc) · 10.5 KB

aws-route-53-monitoring-integration.mdx

File metadata and controls

366 lines (287 loc) · 10.5 KB
Raw
title tags metaDescription redirects
Amazon Route 53 monitoring integration
Integrations
Amazon integrations
AWS integrations list
New Relic's Amazon Route 53 monitoring integration: how to activate it and a description of the data reported.
/docs/integrations/amazon-integrations/aws-integrations-list/aws-route-53-monitoring-integration
/docs/aws-route-53-integration
/docs/infrastructure/amazon-integrations/amazon-integrations/aws-route-53-integration
/docs/infrastructure/amazon-integrations/amazon-integrations/aws-route53-monitoring-integration
/docs/aws-route53-integration
/docs/infrastructure/amazon-integrations/amazon-integrations/aws-route-53-monitoring-integration

New Relic infrastructure integrations include an integration for reporting your Amazon Route 53 data to New Relic. 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 byte, and other metrics. Route 53 data is available in pre-built dashboards and you can also create custom queries and charts in New Relic One.

Activate integration [#activate]

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

Configuration and polling [#polling]

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

Default polling information for the Amazon Route 53 integration:

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

Find and use data [#find-data]

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

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

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

Metric data [#metrics]

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

  <th>
    Description
  </th>
</tr>

  <td>
    For a calculated health check, the number of health checks that are healthy among the health checks that Amazon Route 53 is monitoring.
  </td>
</tr>

<tr>
  <td>
    `ConnectionTime`
  </td>

  <td>
    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.
  </td>
</tr>

<tr>
  <td>
    `HealthCheckPercentageHealthy`
  </td>

  <td>
    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.
  </td>
</tr>

<tr>
  <td>
    `HealthCheckStatus`
  </td>

  <td>
    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.
  </td>
</tr>

<tr>
  <td>
    `SSLHandshakeTime`
  </td>

  <td>
    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.
  </td>
</tr>

<tr>
  <td>
    `TimeToFirstByte`
  </td>

  <td>
    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.
  </td>
</tr>
Name
`ChildHealthCheckHealthyCount`

Inventory data [#inventory]

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](https://discuss.newrelic.com).

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

/zone [#attributes-zone attributes]

  <th>
    Description
  </th>
</tr>

  <td>
    Name of the domain.
  </td>
</tr>

<tr>
  <td>
    `zoneId`
  </td>

  <td>
    ID of the hosted zone.
  </td>
</tr>

<tr>
  <td>
    `isPrivate`
  </td>

  <td>
    Boolean representing whether a zone is private or not.
  </td>
</tr>

<tr>
  <td>
    `comment`
  </td>

  <td>
    Any comments about the hosted zone.
  </td>
</tr>
Name
`domainName`

/zone/record-set [#attributes-zone-record-set attributes]

All data in /zone/record-set will only be gathered if [extended inventory](/docs/integrations/new-relic-integrations/getting-started/configure-polling-frequency-data-collection-cloud-integrations#extended) is **ON**. 
  <th>
    Description
  </th>
</tr>

  <td>
    Name of the Record Set.
  </td>
</tr>

<tr>
  <td>
    `ttl`
  </td>

  <td>
    The resource record cache time to live (TTL), in seconds.
  </td>
</tr>

<tr>
  <td>
    `type`
  </td>

  <td>
    DNS record type
  </td>
</tr>

<tr>
  <td>
    `weight`
  </td>

  <td>
    **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.
  </td>
</tr>

<tr>
  <td>
    `aliasTarget`
  </td>

  <td>
    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.
  </td>
</tr>

<tr>
  <td>
    `failover`
  </td>

  <td>
    The failover resource record.
  </td>
</tr>

<tr>
  <td>
    `geoLocation`
  </td>

  <td>
    Geolocation configuration for the record set, including country code, continent code or subdivision code. JSON format.
  </td>
</tr>

<tr>
  <td>
    `healthCheckId`
  </td>

  <td>
    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](http://docs.aws.amazon.com/Route53/latest/DeveloperGuide/dns-failover-determining-health-of-endpoints.html).
  </td>
</tr>

<tr>
  <td>
    `Region`
  </td>

  <td>
    Region where the record set resides
  </td>
</tr>

<tr>
  <td>
    `records`
  </td>

  <td>
    Structure containing specific information about the resource record. JSON format. For example: `[{"value":"\"v=spf1 include:_spf.google.com ~all\""}]`.
  </td>
</tr>
Name
`name`

/health-check [#attributes-health-check attributes]

  <th>
    Description
  </th>
</tr>

  <td>
    Name of the Record Set.
  </td>
</tr>

<tr>
  <td>
    `config`
  </td>

  <td>
    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.
  </td>
</tr>

<tr>
  <td>
    `alarmConfiguration`
  </td>

  <td>
    Including the AlarmIdentifier structure: Alarm Name, Health Check ID and Region. JSON format.
  </td>
</tr>
Name
`id`