Amazon ECS Container Insights

Integration version1.0.0

To find out if this integration is available in your organization, see your Datadog Integrations page or ask your organization administrator.

To initiate an exception request to enable this integration for your organization, email support@ddog-gov.com.

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

Installation

If you haven’t already, set up the Amazon Web Services integration first.

Metric collection

  1. On the AWS integration tile, under Metric Collection, confirm that ECS/ContainerInsights is enabled.
  2. Install the Datadog - Amazon ECS Container Insights integration.

Data Collected

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

The Amazon ECS Container Insights integration does not include any events.

Service Checks

The Amazon ECS Container Insights integration does not include any service checks.

Troubleshooting

Need help? Contact Datadog support.