AWS EC2 monitoring integration

Access to this feature depends on your subscription level.

New Relic Infrastructure's integrations include an Amazon Elastic Compute Cloud (EC2) integration for reporting your EC2 data to New Relic products. This document explains the integration's features, how to activate it, and what data can be reported.


Amazon's EC2 is a central part of Amazon's cloud-computing platform. All New Relic Infrastructure users, regardless of subscription level, can use New Relic's EC2 integration to get a comprehensive, real-time view of their host's performance and status. New Relic's EC2 integration uses the ec2Describe* policy to add data about your EC2 instances to your standard Infrastructure data. Infrastructure also imports Amazon EC2 custom tags and adds it to your data.

You can also create custom attributes to be analyzed in New Relic Insights.

Activate EC2 integration

You must install the Infrastructure agent on each EC2 host to see data from that host. Connecting your EC2 account only allows Infrastructure to access EC2 metadata, not the underlying hosts.

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

  • New Relic polling interval: 5 minutes
  • Amazon CloudWatch data interval: 1 minute or 5 minutes, depending on CloudWatch plan

Use data in Infrastructure

This table describes the locations in New Relic Infrastructure where you can find and use your EC2 data:

New Relic Infrastructure UI page You can...
Compute page Examine overall resource usage by CPU, load, and memory.
Processes page Monitor CPU, memory, and I/O read or write processes.
Network page View bandwidth and error data to examine saturation levels, compare load balances, and identify other potential performance problems.
Storage page Monitor the capacity and efficiency of overall utilization, disk usage, or I/O operations.
Inventory page Review detailed configuration data by hosts, specific EC2 instances, etc.
Events page

From a live feed of changes in your environment, search for and view EC2 events.

Integrations page

Find links to several product locations where you can find and use EC2 integration data, including links to alert condition creation and viewing your data in New Relic Insights.

Infrastructure also imports your Amazon EC2 custom tags, typically prefaced by ec2Tag_.

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

Use data in Insights

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

The EC2 integration collects the following subset of instance metrics from AWS CloudWatch.

Name Description

Reports whether the instance has passed the instance status check in a one minute period. The check result can be either 0 (passed) or 1 (failed).


Reports whether the instance has passed the system status check in a one minute period. The check result can be either 0 (passed) or 1 (failed).


Reports whether the instance has passed both the instance status check and the system status check in a one minute period. The check result can be either 0 (passed) or 1 (failed).

For more about the specific data that can be reported, see EC2 integration attributes. For complete descriptions, see the Amazon EC2 documentation.

For more help

Recommendations for learning more: