AWS Health monitoring integration

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

New Relic Infrastructure integrations include an integration for reporting your AWS Health data to New Relic products. This document explains how to activate this integration and describes the data that can be reported.

Features

This integration collects information from AWS Health about events that can affect the AWS resources and services globally or in a specific account. This data can help you anticipate potential application outages.

AWS Health reports three types of events:

  • Open issues: Shows issues that might affect your AWS infrastructure.
  • Scheduled changes: Informs you in advance of scheduled activities that might have an impact on AWS services and resources.
  • Notifications: Provides additional information.

Requirements

This integration is available only for AWS customers who have a Business or Enterprise support plan, because this is a requirement for using the AWS Health API.

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 Health integration:

  • New Relic polling interval: 5 minutes

Explore integration data

This integration does not fetch metrics, only inventory information. To use this integration's data in Infrastructure:

  1. Go to infrastructure.newrelic.com > Integrations > Amazon Web Services.
  2. Select any of the available AWS Health integration links.
  3. To view a complete list of open issues, select the Infrastructure Inventory page.
  4. To view a timeline when an AWS Health inventory event is created, modified, or deleted, use the Infrastructure Events page.

Inventory data

Inventory data provides information about active AWS Health events. New Relic's AWS Health integration generates three types of entities, each of which have the same attributes:

  • aws/health/issue/
  • aws/health/scheduled-change/
  • aws/health/notification/
Attribute Description
affectedAvailabilityZone The AWS Availability Zone of the event.

affectedEntities

The ARNs of the entities that are affected by the event. Entities can refer to individual customer resources, groups of customer resources, or any other construct, depending on the AWS service.

affectedRegion

The AWS region of the affected entities.

arn

The unique identifier for the event.
awsRegion The Personal Health Dashboard region.
description

The most recent description of the event.

endTime

The date and time that the event ended.

eventTypeCategory The category of the event type. Possible values are issue, scheduledChange, or accountNotification.
eventTypeCode The unique identifier for the event type.
service The AWS service that is affected by the event.
startTime

The date and time that the event began.

statusCode The most recent status of the event. Examples of possible values are open, closed, and upcoming.

For more help

Recommendations for learning more: