Introduction to the Amazon ECS integration

Our ECS integration reports and displays performance data from your Amazon ECS environment. The ECS integration works well with other integrations, so you can also monitor services running on ECS.


Amazon Elastic Container Service (ECS) is a scalable container management service that makes it easy to run, stop, and manage Docker containers on Amazon EC2 clusters. Our ECS integration instruments the underlying container instance (EC2 launch type) and the container layer by reporting metrics from ECS objects. The integration gives you insight into your ECS instances, tasks, services, and containers.

New Relic ECS integration dashboard > Entity explorer > ECS dashboard: The ECS integration reports performance data about your Amazon ECS containers.

Features include:

  • View your data in pre-built dashboards for immediate insight into your ECS environment.

  • Create your own queries and charts in the query builder from automatically reported data.

  • Create alert conditions on ECS data.

  • Explore entities using the entity explorer.

New Relic also offers an ECS cloud integration, which reports a different data set than our on-host integration. For complete ECS monitoring, we recommend enabling both integrations.

Compatibility and requirements


  • Amazon ECS container agent 1.21.0 or higher.
  • Windows not supported.
  • This integration uses our infrastructure agent and our Docker instrumentation: applicable requirements and restrictions of those systems apply.


To install, see Install integration.

Check the source code

This integration is open source software. That means you can browse its source code and send improvements, or create your own fork and build it.

For more help

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