--- title: Amazon ECS Container Insights description: >- Amazon ECS Container Insights provides detailed metrics about containerized applications and microservices. breadcrumbs: Docs > Integrations > Amazon ECS Container Insights --- > For the complete documentation index, see [llms.txt](https://docs.datadoghq.com/llms.txt). # Amazon ECS Container Insights Integration version1.0.0 {% callout %} # Important note for users on the following Datadog sites: us2.ddog-gov.com {% alert level="info" %} To find out if this integration is available in your organization, see your [Datadog Integrations](https://app.datadoghq.com/integrations) page or ask your organization administrator. To initiate an exception request to enable this integration for your organization, email [support@ddog-gov.com](mailto:support@ddog-gov.com). {% /alert %} {% /callout %} ## Overview{% #overview %} Amazon ECS Container Insights provides detailed metrics about containerized applications and microservices. Enable this integration to see all your Amazon ECS Container Insights metrics in Datadog. ## Setup{% #setup %} ### Installation{% #installation %} If you haven't already, set up the [Amazon Web Services integration](https://docs.datadoghq.com/integrations/amazon_web_services.md) first. ### Metric collection{% #metric-collection %} 1. On the [AWS integration tile](https://app.datadoghq.com/integrations/amazon-web-services), under **Metric Collection**, confirm that `ECS/ContainerInsights` is enabled. 1. Install the [Datadog - Amazon ECS Container Insights integration](https://app.datadoghq.com/integrations/amazon-ecs-container-insights). ## Data Collected{% #data-collected %} ### Metrics{% #metrics %} | | | | | **ecs.containerinsights.container_instance_count**(gauge) | The number of EC2 instances running the Amazon ECS agent that are registered with the cluster.*Shown as instance* | | **ecs.containerinsights.cpu_utilized**(gauge) | The amount of CPU units used by tasks in the service. | | **ecs.containerinsights.family.cpu_utilized**(gauge) | The amount of CPU units used by tasks in the task definition family. | | **ecs.containerinsights.cpu_reserved**(gauge) | The amount of CPU units reserved by tasks in the service. | | **ecs.containerinsights.family.cpu_reserved**(gauge) | The amount of CPU units reserved by tasks in the task definition family. | | **ecs.containerinsights.deployment_count**(gauge) | The number of deployments in the service. | | **ecs.containerinsights.desired_task_count**(gauge) | The desired number of tasks for the service.*Shown as task* | | **ecs.containerinsights.ebs_filesystem_size**(gauge) | The total amount of Amazon EBS filesystem storage allocated to the deployments within the service.*Shown as gigabyte* | | **ecs.containerinsights.family.ebs_filesystem_size**(gauge) | The total amount of Amazon EBS filesystem storage allocated to the volume.*Shown as gigabyte* | | **ecs.containerinsights.ebs_filesystem_utilized**(gauge) | The total amount of Amazon EBS filesystem storage used by deployments within the service.*Shown as gigabyte* | | **ecs.containerinsights.family.ebs_filesystem_utilized**(gauge) | The total amount of Amazon EBS filesystem storage used on the volume.*Shown as gigabyte* | | **ecs.containerinsights.ephemeral_storage_reserved**(gauge) | The amount of ephemeral storage reserved in the service or task.*Shown as gigabyte* | | **ecs.containerinsights.family.ephemeral_storage_reserved**(gauge) | The amount of ephemeral storage reserved in the task definition family or task.*Shown as gigabyte* | | **ecs.containerinsights.ephemeral_storage_utilized**(gauge) | The amount of ephemeral storage used in the service or task.*Shown as gigabyte* | | **ecs.containerinsights.family.ephemeral_storage_utilized**(gauge) | The amount of ephemeral storage used in the task definition family or task.*Shown as gigabyte* | | **ecs.containerinsights.instance_os_filesystem_utilization**(gauge) | The percentage of total disk space used for the OS volume.*Shown as percent* | | **ecs.containerinsights.instance_data_filesystem_utilization**(gauge) | The percentage of total disk space used for the data volume.*Shown as percent* | | **ecs.containerinsights.memory_utilized**(gauge) | The memory used by tasks in the service.*Shown as mebibyte* | | **ecs.containerinsights.family.memory_utilized**(gauge) | The memory used by tasks in the task definition family.*Shown as mebibyte* | | **ecs.containerinsights.memory_reserved**(gauge) | The memory reserved by tasks in the service.*Shown as mebibyte* | | **ecs.containerinsights.family.memory_reserved**(gauge) | The memory reserved by tasks in the task definition family.*Shown as mebibyte* | | **ecs.containerinsights.network_rx_bytes**(gauge) | The number of bytes received by the service or task.*Shown as byte* | | **ecs.containerinsights.network_rx_bytes.maximum**(gauge) | The maximum number of bytes received by the service or task.*Shown as byte* | | **ecs.containerinsights.family.network_rx_bytes**(gauge) | The number of bytes received by the task definition family or task.*Shown as byte* | | **ecs.containerinsights.family.network_rx_bytes.maximum**(gauge) | The maximum number of bytes received by the task definition family or task.*Shown as byte* | | **ecs.containerinsights.network_tx_bytes**(gauge) | The number of bytes transmitted by the service or task.*Shown as byte* | | **ecs.containerinsights.network_tx_bytes.maximum**(gauge) | The maximum number of bytes transmitted by the service or task.*Shown as byte* | | **ecs.containerinsights.family.network_tx_bytes**(gauge) | The number of bytes transmitted by the task definition family or task.*Shown as byte* | | **ecs.containerinsights.family.network_tx_bytes.maximum**(gauge) | The maximum number of bytes transmitted by the task definition family or task.*Shown as byte* | | **ecs.containerinsights.pending_task_count**(gauge) | The number of tasks currently in the PENDING state.*Shown as task* | | **ecs.containerinsights.running_task_count**(gauge) | The number of tasks currently in the RUNNING state.*Shown as task* | | **ecs.containerinsights.restart_count**(count) | The number of times a container in the task has been restarted. | | **ecs.containerinsights.family.restart_count**(count) | The number of times a container in the task definition family has been restarted. | | **ecs.containerinsights.service_count**(gauge) | The number of services in the cluster.*Shown as service* | | **ecs.containerinsights.storage_read_bytes**(count) | The number of bytes read from storage on the instance in the service or task.*Shown as byte* | | **ecs.containerinsights.family.storage_read_bytes**(count) | The number of bytes read from storage on the instance in the task definition family or task.*Shown as byte* | | **ecs.containerinsights.storage_write_bytes**(count) | The number of bytes written to storage on the instance in the service or task.*Shown as byte* | | **ecs.containerinsights.family.storage_write_bytes**(count) | The number of bytes written to storage on the instance in the task definition family or task.*Shown as byte* | | **ecs.containerinsights.task_count**(gauge) | The number of tasks running in the cluster.*Shown as task* | | **ecs.containerinsights.task_set_count**(gauge) | The number of task sets in the service.*Shown as task* | | **ecs.containerinsights.instance_cpu_limit**(gauge) | The maximum number of CPU units that can be assigned to the EC2 instance. | | **ecs.containerinsights.instance_cpu_reserved_capacity**(gauge) | The percentage of CPU currently reserved on the EC2 instance.*Shown as percent* | | **ecs.containerinsights.instance_cpu_usage_total**(gauge) | The number of CPU units used on the EC2 instance. | | **ecs.containerinsights.instance_cpu_utilization**(gauge) | The total percentage of CPU units used on the EC2 instance.*Shown as percent* | | **ecs.containerinsights.instance_cpu_utilization.maximum**(gauge) | The maximum total percentage of CPU units used on the EC2 instance.*Shown as percent* | | **ecs.containerinsights.instance_filesystem_utilization**(gauge) | The total percentage of file system capacity used on the EC2 instance.*Shown as percent* | | **ecs.containerinsights.instance_filesystem_utilization.maximum**(gauge) | The maximum total percentage of file system capacity used on the EC2 instance.*Shown as percent* | | **ecs.containerinsights.instance_memory_limit**(gauge) | The maximum amount of memory that can be assigned to the EC2 instance.*Shown as byte* | | **ecs.containerinsights.instance_memory_reserved_capacity**(gauge) | The percentage of memory currently reserved on the EC2 instance.*Shown as percent* | | **ecs.containerinsights.instance_memory_utilization**(gauge) | The total percentage of memory used on the EC2 instance.*Shown as percent* | | **ecs.containerinsights.instance_memory_utilization.maximum**(gauge) | The maximum total percentage of memory used on the EC2 instance.*Shown as percent* | | **ecs.containerinsights.instance_memory_working_set**(gauge) | The amount of memory used on the EC2 instance.*Shown as byte* | | **ecs.containerinsights.instance_network_total_bytes**(gauge) | The total number of bytes per second transmitted and received over the network on the EC2 instance.*Shown as byte* | | **ecs.containerinsights.instance_number_of_running_tasks**(gauge) | The number of running tasks on the EC2 instance.*Shown as task* | | **ecs.containerinsights.container_cpu_utilization**(gauge) | The total percentage of CPU units used by containers in the service or task.*Shown as percent* | | **ecs.containerinsights.family.container_cpu_utilization**(gauge) | The total percentage of CPU units used by containers in the task definition family or task.*Shown as percent* | | **ecs.containerinsights.container_cpu_reserved**(gauge) | The amount of CPU units reserved by containers in the service or task. | | **ecs.containerinsights.family.container_cpu_reserved**(gauge) | The amount of CPU units reserved by containers in the task definition family or task. | | **ecs.containerinsights.container_cpu_utilized**(gauge) | The amount of CPU units used by containers in the service or task. | | **ecs.containerinsights.family.container_cpu_utilized**(gauge) | The amount of CPU units used by containers in the task definition family or task. | | **ecs.containerinsights.container_memory_utilized**(gauge) | The memory used by containers in the service or task.*Shown as mebibyte* | | **ecs.containerinsights.family.container_memory_utilized**(gauge) | The memory used by containers in the task definition family or task.*Shown as mebibyte* | | **ecs.containerinsights.container_memory_reserved**(gauge) | The memory reserved by containers in the service or task.*Shown as mebibyte* | | **ecs.containerinsights.family.container_memory_reserved**(gauge) | The memory reserved by containers in the task definition family or task.*Shown as mebibyte* | | **ecs.containerinsights.container_memory_utilization**(gauge) | The total percentage of memory used by containers in the service or task.*Shown as percent* | | **ecs.containerinsights.family.container_memory_utilization**(gauge) | The total percentage of memory used by containers in the task definition family or task.*Shown as percent* | | **ecs.containerinsights.container_network_rx_bytes**(gauge) | The number of bytes received by containers in the service or task.*Shown as byte* | | **ecs.containerinsights.container_network_rx_bytes.maximum**(gauge) | The maximum number of bytes received by containers in the service or task.*Shown as byte* | | **ecs.containerinsights.family.container_network_rx_bytes**(gauge) | The number of bytes received by containers in the task definition family or task.*Shown as byte* | | **ecs.containerinsights.family.container_network_rx_bytes.maximum**(gauge) | The maximum number of bytes received by containers in the task definition family or task.*Shown as byte* | | **ecs.containerinsights.container_network_tx_bytes**(gauge) | The number of bytes transmitted by containers in the service or task.*Shown as byte* | | **ecs.containerinsights.container_network_tx_bytes.maximum**(gauge) | The maximum number of bytes transmitted by containers in the service or task.*Shown as byte* | | **ecs.containerinsights.family.container_network_tx_bytes**(gauge) | The number of bytes transmitted by containers in the task definition family or task.*Shown as byte* | | **ecs.containerinsights.family.container_network_tx_bytes.maximum**(gauge) | The maximum number of bytes transmitted by containers in the task definition family or task.*Shown as byte* | | **ecs.containerinsights.container_storage_read_bytes**(count) | The number of bytes read from storage on the container in the service or task.*Shown as byte* | | **ecs.containerinsights.family.container_storage_read_bytes**(count) | The number of bytes read from storage on the container in the task definition family or task.*Shown as byte* | | **ecs.containerinsights.container_storage_write_bytes**(count) | The number of bytes written to storage on the container in the service or task.*Shown as byte* | | **ecs.containerinsights.family.container_storage_write_bytes**(count) | The number of bytes written to storage on the container in the task definition family or task.*Shown as byte* | | **ecs.containerinsights.task_ebs_filesystem_utilization**(gauge) | The percentage of Amazon EBS filesystem storage used by the task.*Shown as percent* | | **ecs.containerinsights.family.task_ebs_filesystem_utilization**(gauge) | The percentage of Amazon EBS filesystem storage used by tasks in the task definition family.*Shown as percent* | | **ecs.containerinsights.unhealthy_container_health_status**(count) | The number of unhealthy containers, based on container health check status.*Shown as container* | | **ecs.containerinsights.family.unhealthy_container_health_status**(count) | The number of unhealthy containers in the task definition family, based on container health check status.*Shown as container* | | **ecs.containerinsights.task_cpu_utilization**(gauge) | The total percentage of CPU units used by the task.*Shown as percent* | | **ecs.containerinsights.family.task_cpu_utilization**(gauge) | The total percentage of CPU units used by tasks in the task definition family.*Shown as percent* | | **ecs.containerinsights.task_ephemeral_storage_utilization**(gauge) | The total percentage of ephemeral storage used by the task.*Shown as percent* | | **ecs.containerinsights.family.task_ephemeral_storage_utilization**(gauge) | The total percentage of ephemeral storage used by tasks in the task definition family.*Shown as percent* | | **ecs.containerinsights.task_memory_utilization**(gauge) | The total percentage of memory used by the task.*Shown as percent* | | **ecs.containerinsights.family.task_memory_utilization**(gauge) | The total percentage of memory used by tasks in the task definition family.*Shown as percent* | | **ecs.containerinsights.container_gpu_utilization**(gauge) | The percentage utilization of the GPUs allocated to the container.*Shown as percent* | | **ecs.containerinsights.family.container_gpu_utilization**(gauge) | The percentage utilization of the GPUs allocated to containers in the task definition family.*Shown as percent* | | **ecs.containerinsights.container_gpu_memory_utilization**(gauge) | The percentage of frame buffer memory used on the GPUs allocated to the container.*Shown as percent* | | **ecs.containerinsights.family.container_gpu_memory_utilization**(gauge) | The percentage of frame buffer memory used on the GPUs allocated to containers in the task definition family.*Shown as percent* | | **ecs.containerinsights.container_gpu_memory_total**(gauge) | The total frame buffer size on the GPUs allocated to the container.*Shown as byte* | | **ecs.containerinsights.family.container_gpu_memory_total**(gauge) | The total frame buffer size on the GPUs allocated to containers in the task definition family.*Shown as byte* | | **ecs.containerinsights.container_gpu_memory_used**(gauge) | The frame buffer memory used on the GPUs allocated to the container.*Shown as byte* | | **ecs.containerinsights.family.container_gpu_memory_used**(gauge) | The frame buffer memory used on the GPUs allocated to containers in the task definition family.*Shown as byte* | | **ecs.containerinsights.container_gpu_power_draw**(gauge) | The power usage of the GPUs allocated to the container.*Shown as watt* | | **ecs.containerinsights.family.container_gpu_power_draw**(gauge) | The power usage of the GPUs allocated to containers in the task definition family.*Shown as watt* | | **ecs.containerinsights.container_gpu_temperature**(gauge) | The temperature of the GPUs allocated to the container.*Shown as degree celsius* | | **ecs.containerinsights.family.container_gpu_temperature**(gauge) | The temperature of the GPUs allocated to containers in the task definition family.*Shown as degree celsius* | | **ecs.containerinsights.container_gpu_restart_app_xid_count**(count) | The count of NVIDIA Xid errors requiring an app restart, observed on the GPUs allocated to the container.*Shown as error* | | **ecs.containerinsights.family.container_gpu_restart_app_xid_count**(count) | The count of NVIDIA Xid errors requiring an app restart, observed on the GPUs allocated to containers in the task definition family.*Shown as error* | | **ecs.containerinsights.task_gpu_utilization**(gauge) | The percentage utilization of the GPUs allocated to the task.*Shown as percent* | | **ecs.containerinsights.family.task_gpu_utilization**(gauge) | The percentage utilization of the GPUs allocated to tasks in the task definition family.*Shown as percent* | | **ecs.containerinsights.task_gpu_memory_utilization**(gauge) | The percentage of frame buffer memory used on the GPUs allocated to the task.*Shown as percent* | | **ecs.containerinsights.family.task_gpu_memory_utilization**(gauge) | The percentage of frame buffer memory used on the GPUs allocated to tasks in the task definition family.*Shown as percent* | | **ecs.containerinsights.task_gpu_memory_total**(gauge) | The total frame buffer size on the GPUs allocated to the task.*Shown as byte* | | **ecs.containerinsights.family.task_gpu_memory_total**(gauge) | The total frame buffer size on the GPUs allocated to tasks in the task definition family.*Shown as byte* | | **ecs.containerinsights.task_gpu_memory_used**(gauge) | The frame buffer memory used on the GPUs allocated to the task.*Shown as byte* | | **ecs.containerinsights.family.task_gpu_memory_used**(gauge) | The frame buffer memory used on the GPUs allocated to tasks in the task definition family.*Shown as byte* | | **ecs.containerinsights.task_gpu_power_draw**(gauge) | The power usage of the GPUs allocated to the task.*Shown as watt* | | **ecs.containerinsights.family.task_gpu_power_draw**(gauge) | The power usage of the GPUs allocated to tasks in the task definition family.*Shown as watt* | | **ecs.containerinsights.task_gpu_temperature**(gauge) | The temperature of the GPUs allocated to the task.*Shown as degree celsius* | | **ecs.containerinsights.family.task_gpu_temperature**(gauge) | The temperature of the GPUs allocated to tasks in the task definition family.*Shown as degree celsius* | | **ecs.containerinsights.task_gpu_restart_app_xid_count**(count) | The count of NVIDIA Xid errors requiring an app restart, observed on the GPUs allocated to the task.*Shown as error* | | **ecs.containerinsights.family.task_gpu_restart_app_xid_count**(count) | The count of NVIDIA Xid errors requiring an app restart, observed on the GPUs allocated to tasks in the task definition family.*Shown as error* | | **ecs.containerinsights.instance_gpu_limit**(gauge) | The total number of GPUs available on the instance. | | **ecs.containerinsights.instance_gpu_usage_total**(gauge) | The number of GPUs currently allocated to running tasks on the instance. | ### Events{% #events %} The Amazon ECS Container Insights integration does not include any events. ### Service Checks{% #service-checks %} The Amazon ECS Container Insights integration does not include any service checks. ## Troubleshooting{% #troubleshooting %} Need help? Contact [Datadog support](https://docs.datadoghq.com/help/).