AWS Health monitoring integration

New Relic infrastructure integrations include an integration for reporting your AWS Health data to New Relic. 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 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 AWS Health integration:

New Relic polling interval: 5 minutes

Explore integration data

To use this integration's data:

Go to one.newrelic.com > Infrastructure > AWS.
Select any of the available AWS Health integration links.
To view a complete list of open issues, select the Inventory page.
To view a timeline when an AWS Health inventory event is created, modified, or deleted, use the Events page.

Events monitoring and alerts

AWS Health events are ingested in New Relic One as AwsHealthNotification events. You can query, create widgets, and define NRQL alert policies based on these events.

The following table shows the main attributes available for AwsHealthNotification events:

Event Attribute	Description
`affectedEntityArn`	The AWS resource ARN.
`arn`	The ARN of the AWS Health event itself.
`affectedRegion`	The AWS affected region.
`affectedResources`	Number of affected resources. Auto-generated metric that can be used to define New Relic alert conditions.
`description`	Detailed description of the event.
`eventTypeCategory`	AWS Health category: Issue, ScheduledChange, AccountNotification, Investigation.
`eventTypeCode`	A list of unique identifiers for event types. For example,`AWS_EC2_SYSTEM_MAINTENANCE_EVENT` or `AWS_RDS_MAINTENANCE_SCHEDULED`.
`service`	The AWS services associated with the event. For example, EC2, RDS.
`statusCode`	The AWS health event status: `Open`, `Closed`, `Upcoming`.
`startTime`	Date and time the event began.

NRQL alert conditions can be defined to receive notifications when health events are reported by AWS.

For example, the following query monitors any open issues on EC2 by resource:

SELECT uniqueCount(affectedEntityArn) FROM AwsHealthNotification where statusCode = 'open' and eventTypeCategory = 'Issue' and service = 'EC2'

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 inventory data:

aws/health/issue/
aws/health/scheduled-change/
aws/health/notification/

Name	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

If you need more help, check out these support and learning resources:

Browse the Explorers Hub to get help from the community and join in discussions.
Find answers on our sites and learn how to use our support portal.
Run New Relic Diagnostics, our troubleshooting tool for Linux, Windows, and macOS.
Review New Relic's data security and licenses documentation.