• EnglishEspañol日本語한국어Português
  • Log inStart now

Amazon ECS/ECR monitoring integration

You can report your Amazon EC2 Container Service (ECS) data and your Amazon EC2 Container Registry (ECR) data to New Relic.

Recommended alternatives

As a preferred alternative to this integration, you can monitor all CloudWatch metrics from your AWS services, including custom namespaces. To do this, enable the AWS CloudWatch Metric Streams integration.

We also offer an ECS on-host integration, which reports a different data set than this cloud-based integration.

Overview of integration

New Relic ECS/ECR monitoring integration allows you to monitor reserved vs. utilized capacity, task execution, and registry of containers. AWS integration data is also available for analysis and chart creation.

Activate the integration

To enable this integration, follow our documentation to connect AWS services to New Relic.

If you have services running on ECS, you can also enable monitoring of those services.


In AWS, you have to opt-in for the new ARN format (announcement) to distinguish between services with the same name in different clusters. Otherwise, you could have data collision.

Configuration and polling

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

The default polling values for the Amazon ECS/ECR integration are:

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

Find and use data

To find this integration's data, go to one.newrelic.com > All capabilities > Infrastructure > AWS and select one of the Amazon ECS/ECR integration links.

You can query and explore your data using the ComputeSample event type. Use a provider value of EcsCluster for cluster data, or a provider value of EcsService for cluster-service data.

The integration collects these ECR/ECS definitions:




This dimension filters the data you request for all resources in a specified cluster. All Amazon ECS metrics are filtered by ClusterName.


This dimension filters the data you request for all resources in a specified service within a specified cluster.

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

Metric data

The ECS/ECR integration collects the following data:


For full descriptions of these metrics, see Amazon's documentation on ECS and ECR.

Cluster and service metrics


Data type





Cluster metrics


Data type





Service metrics



Active Service

The number of services that are running on the cluster in an ACTIVE state

Pending Tasks

Number of tasks in the cluster that are in PENDING state

Running Tasks

Number of tasks in the cluster that are in RUNNING state

Registered Instances

Number of container instances registered into the cluster

Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.