Amazon ECS Container Insights metrics
The following table lists the metrics and dimensions that Container Insights collects
for Amazon ECS. These metrics are in the ECS/ContainerInsights
namespace. For more
information, see Metrics.
If you do not see any Container Insights metrics in your console, be sure that you have completed the setup of Container Insights. Metrics do not appear before Container Insights has been set up completely. For more information, see Setting up Container Insights.
When you use Container Insights to collect the following metrics, the metrics are
charged as custom metrics. For more information about CloudWatch pricing, see Amazon CloudWatch Pricing
The following metrics are available when you complete the steps in Setting up Container Insights on Amazon ECS for cluster- and service-level metrics
Metric name | Dimensions | Description |
---|---|---|
|
ClusterName |
The number of EC2 instances running the Amazon ECS agent that are registered with a cluster. Unit: Count |
|
TaskDefinitionFamily, ClusterName ServiceName, ClusterName ClusterName |
The CPU units used by tasks in the resource that is specified by the dimension set that you're using. This metric is collected only for tasks that have a defined CPU reservation in their task definition. Unit: None |
|
TaskDefinitionFamily, ClusterName ServiceName, ClusterName ClusterName |
The CPU units reserved by tasks in the resource that is specified by the dimension set that you're using. This metric is collected only for tasks that have a defined CPU reservation in their task definition. Unit: None |
|
ServiceName, ClusterName |
The number of deployments in an Amazon ECS service. Unit: Count |
|
ServiceName, ClusterName |
The desired number of tasks for an Amazon ECS service. Unit: Count |
EphemeralStorageReserved
1
|
TaskDefinitionFamily, ClusterName ServiceName, ClusterName ClusterName |
The number of bytes reserved from ephemeral storage in the resource that is specified by the dimensions that you're using. Ephemeral storage is used for the container root filesystem and any bind mount host volumes defined in the container image and task definition. The amount of ephemeral storage can’t be changed in a running task. This metric is only available for tasks that run on Fargate Linux platform version 1.4.0 or later. Unit: Gibibytes (GiB) |
EphemeralStorageUtilized
1
|
TaskDefinitionFamily, ClusterName ServiceName, ClusterName ClusterName |
The number of bytes used from ephemeral storage in the resource that is specified by the dimensions that you're using. Ephemeral storage is used for the container root filesystem and any bind mount host volumes defined in the container image and task definition. The amount of ephemeral storage can’t be changed in a running task. This metric is only available for tasks that run on Fargate Linux platform version 1.4.0 or later. Unit: Gibibytes (GiB) |
|
TaskDefinitionFamily, ClusterName ServiceName, ClusterName ClusterName |
The memory being used by tasks in the resource that is specified by the dimension set that you're using. This metric is collected only for tasks that have a defined memory reservation in their task definition. Unit: Megabytes |
|
TaskDefinitionFamily, ClusterName ServiceName, ClusterName ClusterName |
The memory that is reserved by tasks in the resource that is specified by the dimension set that you're using. This metric is collected only for tasks that have a defined memory reservation in their task definition. Unit: Megabytes |
|
TaskDefinitionFamily, ClusterName ServiceName, ClusterName ClusterName |
The number of bytes received by the resource that is specified by the dimensions that you're using. This metric is available only for containers in tasks using the
Unit: Bytes/Second |
|
TaskDefinitionFamily, ClusterName ServiceName, ClusterName ClusterName |
The number of bytes transmitted by the resource that is specified by the dimensions that you're using. This metric is available only for containers in tasks using the
Unit: Bytes/Second |
|
ServiceName, ClusterName |
The number of tasks currently in the Unit: Count |
|
ServiceName, ClusterName |
The number of tasks currently in the Unit: Count |
|
ClusterName |
The number of services in the cluster. Unit: Count |
|
TaskDefinitionFamily, ClusterName ServiceName, ClusterName ClusterName |
The number of bytes read from storage in the resource that is specified by the dimensions that you're using. Unit: Bytes |
|
TaskDefinitionFamily, ClusterName ServiceName, ClusterName ClusterName |
The number of bytes written to storage in the resource that is specified by the dimensions that you're using. Unit: Bytes |
|
ClusterName |
The number of tasks running in the cluster. Unit: Count |
|
ServiceName, ClusterName |
The number of task sets in the service. Unit: Count |
Note
The
EphemeralStorageReserved
and EphemeralStorageUtilized
metrics
are only available for tasks that run on Fargate Linux platform version 1.4.0 or
later.
Fargate reserves space on disk. It is only used by Fargate. You aren't billed for it.
It isn't shown in these metrics. However, you can see this additional storage in other
tools such as df
.
The following metrics are available when you complete the steps in Deploying the CloudWatch agent to collect EC2 instance-level metrics on Amazon ECS
Metric name | Dimensions | Description |
---|---|---|
|
ClusterName |
The maximum number of CPU units that can be assigned to a single EC2 Instance in the cluster. Unit: None |
|
ClusterName InstanceId, ContainerInstanceId,ClusterName |
The percentage of CPU currently being reserved on a single EC2 instance in the cluster. Unit: Percent |
|
ClusterName |
The number of CPU units being used on a Single EC2 instance in the cluster. Unit: None |
|
ClusterName InstanceId, ContainerInstanceId,ClusterName |
The total percentage of CPU units being used on a single EC2 instance in the cluster. Unit: Percent |
|
ClusterName InstanceId, ContainerInstanceId,ClusterName |
The total percentage of file system capacity being used on a single EC2 instance in the cluster. Unit: Percent |
|
ClusterName |
The maximum amount of memory, in bytes, that can be assigned to a single EC2 Instance in this cluster. Unit: Bytes |
|
ClusterName InstanceId, ContainerInstanceId,ClusterName |
The percentage of Memory currently being reserved on a single EC2 Instance in the cluster. Unit: Percent |
|
ClusterName InstanceId, ContainerInstanceId,ClusterName |
The total percentage of memory being used on a single EC2 Instance in the cluster. Unit: Percent |
|
ClusterName |
The amount of memory, in bytes, being used on a single EC2 Instance in the cluster. Unit: Bytes |
|
ClusterName |
The total number of bytes per second transmitted and received over the network on a single EC2 Instance in the cluster. Unit: Bytes/second |
|
ClusterName |
The number of running tasks on a single EC2 Instance in the cluster. Unit: Count |