---
title: Amazon ECS/ECR monitoring integration
source: https://docs.newrelic.com/docs/infrastructure/amazon-integrations/aws-integrations-list/aws-ecsecr-monitoring-integration
---

You can report your [Amazon EC2 Container Service (ECS)](https://aws.amazon.com/documentation/ecs/) data and your [Amazon EC2 Container Registry (ECR)](http://docs.aws.amazon.com/AmazonECR/latest/userguide/Registries.html) data to New Relic.

## Recommended alternatives [#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](https://docs.newrelic.com/docs/infrastructure/amazon-integrations/aws-integrations-list/aws-metric-stream).

We also offer an [ECS on-host integration](https://docs.newrelic.com/docs/integrations/elastic-container-service-integration/get-started/introduction-amazon-ecs-integration), which reports a different data set than this cloud-based integration.

## Overview of integration [#overview]

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](https://docs.newrelic.com/docs/infrastructure/infrastructure-integrations/getting-started/connect-aws-integrations-infrastructure#insights).

## Activate the integration [#activate]

To enable this integration, follow our documentation to [connect AWS services to New Relic](https://docs.newrelic.com/docs/infrastructure/infrastructure-integrations/getting-started/connect-aws-integrations-infrastructure).

If you have services running on ECS, you can also [enable monitoring of those services](https://docs.newrelic.com/docs/integrations/host-integrations/host-integrations-list/monitor-services-running-amazon-ecs).

> #### ⚠️ IMPORTANT
>
> In AWS, you have to [opt-in](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-account-settings.html#ecs-resource-arn-timeline) for the new ARN format ([announcement](https://aws.amazon.com/blogs/compute/migrating-your-amazon-ecs-deployment-to-the-new-arn-and-resource-id-format-2/)) to distinguish between services with the same name in different clusters. Otherwise, you could have data collision.

## Configuration and polling [#polling]

You can change the polling frequency and filter data using [configuration options](https://docs.newrelic.com/docs/integrations/new-relic-integrations/getting-started/configure-polling-frequency-data-collection-cloud-integrations).

The [default polling](https://docs.newrelic.com/docs/infrastructure/amazon-integrations/aws-integrations-list/aws-polling-intervals-infrastructure-integrations) 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 [#find-data]

To find this integration's data, go to **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Infrastructure > AWS** and select one of the Amazon ECS/ECR integration links.

You can [query and explore your data](https://docs.newrelic.com/docs/using-new-relic/data/understand-data/query-new-relic-data) using the `ComputeSample` [event type](https://docs.newrelic.com/docs/data-apis/understand-data/new-relic-data-types/#event-data). 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:

| Name          | Description                                                                                                                                 |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| `ClusterName` | This dimension filters the data you request for all resources in a specified cluster. All Amazon ECS metrics are filtered by `ClusterName`. |
| `ServiceName` | 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](https://docs.newrelic.com/docs/infrastructure/integrations/find-use-infrastructure-integration-data).

## Metric data [#metrics]

The ECS/ECR integration collects the following data:

> #### 💡 TIP
>
> For full descriptions of these metrics, see Amazon's documentation on [ECS](https://aws.amazon.com/documentation/ecs/) and [ECR](https://aws.amazon.com/documentation/ecr/).

### Cluster and service metrics

| Name                | Data type |
| ------------------- | --------- |
| `CPUUtilization`    | percent   |
| `MemoryUtilization` | percent   |

### Cluster metrics [#cluster]

| Name                | Data type |
| ------------------- | --------- |
| `CPUReservation`    | percent   |
| `MemoryReservation` | percent   |

### Service metrics [#service]

| Name                   | Description                                                                 |
| ---------------------- | --------------------------------------------------------------------------- |
| `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                   |