Amazon ECS

¿Quieres desplegar el Datadog Agent contenedorizado en tu clúster ECS? Consulta la documentación del Agent con Amazon ECS.

Información general

Amazon ECS en EC2 es un servicio de gestión de contenedores de gran escalabilidad y alto rendimiento para contenedores Docker que se ejecutan en instancias EC2.

Recopila métricas ECS automáticamente desde CloudWatch utilizando la integración Amazon ECS en Datadog. Amplía esas métricas consultando la API de ECS para ver eventos ECS, etiquetas (tags) y el estado de instancias de contenedor, tareas y servicios.

Configuración

Instalación

Si aún no lo has hecho, configura primero la integración Amazon Web Services.

Recopilación de métricas

  1. Sigue las instrucciones para configurar la delegación de roles de la integración AWS.
  2. Asegúrate de que los siguientes permisos de tu política IAM Datadog están configurados para recopilar métricas de Amazon ECS. Para obtener más información sobre las políticas de ECS, consulta Acciones, recursos y condiciones clave del servicio de contenedores Amazon Elastic en la documentación de AWS.
Permiso de AWSDescripción
ecs:ListClustersDevuelve una lista de los clústeres existentes.
ecs:ListContainerInstancesDevuelve una lista de instancias de contenedor en un clúster especificado.
ecs:ListServicesEnumera los servicios que se están ejecutando en un clúster especificado.
ecs:DescribeContainerInstancesDescribe las instancias de contenedor Amazon ECS.
  1. En la página de la integración AWS, asegúrate de que ECS está habilitado en la pestaña Metric Collection.

    Amazon ECS Configuration

Cuando la recopilación de métricas está activada, hay un dashboard predefinodo disponible para esta integración que proporciona información detallada sobre tus métricas de ECS. Consulta Monitorización de ECS con Datadog para obtener más detalles.

Datos recopilados

Métricas

aws.ecs.cpureservation
(gauge)
Porcentaje de unidades de CPU reservadas por tareas en ejecución en el clúster.
Se muestra como porcentaje
aws.ecs.cpureservation.maximum
(gauge)
Porcentaje máximo de unidades de CPU reservadas por tareas en ejecución en el clúster.
Se muestra como porcentaje
aws.ecs.cpureservation.minimum
(gauge)
Porcentaje mínimo de unidades de CPU reservadas por tareas en ejecución en el clúster.
Se muestra como porcentaje
aws.ecs.cpureservation.samplecount
(count)
Recuento de muestra de unidades de CPU reservadas por tareas en ejecución en el clúster.
aws.ecs.cpuutilization
(gauge)
Porcentaje de unidades CPU que se utilizan en el clúster o servicio, filtradas por ClusterName y ServiceName.
Se muestra como porcentaje
aws.ecs.cpuutilization.maximum
(gauge)
Porcentaje máximo de unidades de CPU que se utilizan en el clúster o servicio.
Se muestra como porcentaje
aws.ecs.cpuutilization.minimum
(gauge)
Porcentaje mínimo de unidades de CPU que se utilizan en el clúster o servicio.
Se muestra como porcentaje
aws.ecs.cpuutilization.samplecount
(count)
Recuento de muestra de unidades de CPU que se utilizan en el clúster o servicio.
aws.ecs.memory_reservation
(gauge)
Porcentaje de memoria reservado por tareas en ejecución en el clúster.
Se muestra como porcentaje
aws.ecs.memory_reservation.maximum
(gauge)
Porcentaje máximo de memoria reservado por tareas en ejecución en el clúster.
Se muestra como porcentaje
aws.ecs.memory_reservation.minimum
(gauge)
Porcentaje mínimo de memoria reservado por tareas en ejecución en el clúster.
Se muestra como porcentaje
aws.ecs.memory_utilization
(gauge)
Porcentaje de memoria utilizado en el clúster o servicio.
Se muestra como porcentaje
aws.ecs.memory_utilization.maximum
(gauge)
Porcentaje máximo de memoria utilizado en el clúster o servicio.
Se muestra como porcentaje
aws.ecs.memory_utilization.minimum
(gauge)
Porcentaje mínimo de memoria utilizado en el clúster o servicio.
Se muestra como porcentaje
aws.ecs.cluster.cpureservation
(gauge)
Porcentaje de unidades de CPU reservadas por tareas en ejecución en el clúster.
Se muestra como porcentaje
aws.ecs.cluster.cpureservation.maximum
(gauge)
Porcentaje máximo de unidades de CPU reservadas por tareas en ejecución en el clúster.
Se muestra como porcentaje
aws.ecs.cluster.cpureservation.minimum
(gauge)
Porcentaje mínimo de unidades de CPU reservadas por tareas en ejecución en el clúster.
Se muestra como porcentaje
aws.ecs.cluster.cpuutilization
(gauge)
Porcentaje de unidades de CPU que se utilizan en el cluster o servicio, filtradas por ClusterName.
Se muestra como porcentaje
aws.ecs.cluster.cpuutilization.maximum
(gauge)
Porcentaje máximo de unidades de CPU que se utilizan en el clúster o servicio.
Se muestra como porcentaje
aws.ecs.cluster.cpuutilization.minimum
(gauge)
Porcentaje mínimo de unidades de CPU que se utilizan en el clúster o servicio.
Se muestra como porcentaje
aws.ecs.cluster.memory_reservation
(gauge)
Porcentaje de memoria reservado por tareas en ejecución en el clúster.
Se muestra como porcentaje
aws.ecs.cluster.memory_reservation.maximum
(gauge)
Porcentaje máximo de memoria reservado por tareas en ejecución en el clúster.
Se muestra como porcentaje
aws.ecs.cluster.memory_reservation.minimum
(gauge)
Porcentaje mínimo de memoria reservado por tareas en ejecución en el clúster.
Se muestra como porcentaje
aws.ecs.cluster.memory_utilization
(gauge)
Porcentaje de memoria utilizado en el clúster o servicio.
Se muestra como porcentaje
aws.ecs.cluster.memory_utilization.maximum
(gauge)
Porcentaje máximo de memoria utilizado en el clúster o servicio.
Se muestra como porcentaje
aws.ecs.cluster.memory_utilization.minimum
(gauge)
Porcentaje mínimo de memoria utilizado en el clúster o servicio.
Se muestra como porcentaje
aws.ecs.pending_tasks_count
(gauge)
Número de tareas en la instancia de contenedor que están en estado PENDIENTE.
Se muestra como tarea
aws.ecs.registered_cpu
(gauge)
Número de unidades de CPU registradas en la instancia de contenedor
aws.ecs.registered_memory
(gauge)
Número de unidades de memoria registradas en la instancia de contenedor
aws.ecs.remaining_cpu
(gauge)
Número de unidades de CPU restantes en la instancia de contenedor
aws.ecs.remaining_memory
(gauge)
Número de unidades de memoria restantes en la instancia de contenedor
aws.ecs.running_tasks_count
(gauge)
Número de tareas en la instancia de contenedor que están en estado EN EJECUCIÓN.
Se muestra como tarea
aws.ecs.service.cpuutilization
(gauge)
Porcentaje medio de unidades de CPU que se utilizan en el servicio.
Se muestra como porcentaje
aws.ecs.service.cpuutilization.maximum
(gauge)
Porcentaje máximo de unidades CPU que se utilizan en el servicio.
Se muestra como porcentaje
aws.ecs.service.cpuutilization.minimum
(gauge)
Porcentaje mínimo de unidades de CPU que se utilizan en el servicio.
Se muestra como porcentaje
aws.ecs.service.desired
(gauge)
Número de tareas del clúster que se encuentran en el estado deseado
aws.ecs.service.memory_utilization
(gauge)
Porcentaje medio de memoria que se utiliza en el servicio.
Se muestra como porcentaje
aws.ecs.service.memory_utilization.maximum
(gauge)
Porcentaje máximo de memoria que se utiliza en el servicio.
Se muestra como porcentaje
aws.ecs.service.memory_utilization.minimum
(gauge)
Porcentaje mínimo de memoria que se utiliza en el servicio.
Se muestra como porcentaje
aws.ecs.service.pending
(gauge)
Número de tareas del clúster que se encuentran en estado pendiente
Se muestra como tarea
aws.ecs.service.running
(gauge)
Número de tareas del clúster que se encuentran en estado de ejecución
Se muestra como tarea
aws.ecs.services
(gauge)
Número de servicios que se ejecutan por clúster
ecs.containerinsights.container_instance_count
(count)
Número de instancias EC2 que ejecutan el agente de Amazon ECS, registradas en un clúster.
Se muestra como instancia
ecs.containerinsights.container_instance_count.maximum
(count)
Número máximo de instancias EC2 que ejecutan el agente de Amazon ECS, registradas en un clúster.
Se muestra como instancia
ecs.containerinsights.container_instance_count.minimum
(count)
Número mínimo de instancias EC2 que ejecutan el agente de Amazon ECS, registradas en un clúster.
Se muestra como instancia
ecs.containerinsights.container_instance_count.samplecount
(count)
Recuento de muestra de las instancias EC2 que ejecutan el agente de Amazon ECS y que están registradas en un clúster.
Se muestra como instancia
ecs.containerinsights.container_instance_count.sum
(count)
Suma de instancias EC2 que ejecutan el agente de Amazon ECS y que están registradas en un clúster.
Se muestra como instancia
ecs.containerinsights.cpu_reserved
(gauge)
Unidades de CPU reservadas por tareas en el recurso especificado para la dimensión elegida.
ecs.containerinsights.cpu_reserved.maximum
(gauge)
Unidades de CPU máximas reservadas por tareas en el recurso especificado para la dimensión elegida.
ecs.containerinsights.cpu_reserved.minimum
(gauge)
Unidades de CPU mínimas reservadas por tareas en el recurso especificado para la dimensión elegida.
ecs.containerinsights.cpu_reserved.samplecount
(gauge)
Recuento de muestra de unidades de CPU reservadas por tareas en el recurso especificado para la dimensión elegida.
ecs.containerinsights.cpu_reserved.sum
(gauge)
Suma de unidades de CPU reservadas por tareas en el recurso especificado para la dimensión elegida.
ecs.containerinsights.cpu_utilized
(gauge)
Unidades de CPU utilizadas por tareas en el recurso especificado para la dimensión elegida.
Se muestra como porcentaje
ecs.containerinsights.cpu_utilized.maximum
(gauge)
Unidades de CPU máximas utilizadas por tareas en el recurso especificado para la dimensión elegida.
Se muestra como porcentaje
ecs.containerinsights.cpu_utilized.minimum
(gauge)
Unidades de CPU mínimas utilizadas por tareas en el recurso especificado para la dimensión elegida.
Se muestra como porcentaje
ecs.containerinsights.cpu_utilized.samplecount
(gauge)
Recuento de muestra de unidades de CPU utilizadas por tareas en el recurso especificado para la dimensión elegida.
Se muestra como porcentaje
ecs.containerinsights.cpu_utilized.sum
(gauge)
Suma de unidades de CPU utilizadas por tareas en el recurso especificado para la dimensión elegida.
Se muestra como porcentaje
ecs.containerinsights.deployment_count
(count)
Número de despliegues en un servicio de Amazon ECS.
ecs.containerinsights.deployment_count.maximum
(count)
Número máximo de despliegues en un servicio de Amazon ECS.
ecs.containerinsights.deployment_count.minimum
(count)
Número mínimo de despliegues en un servicio de Amazon ECS.
ecs.containerinsights.deployment_count.samplecount
(count)
Recuento de muestra de despliegues en un servicio de Amazon ECS.
ecs.containerinsights.deployment_count.sum
(count)
Suma de despliegues en un servicio de Amazon ECS.
ecs.containerinsights.desired_task_count
(count)
Número de tareas deseadas para un servicio de Amazon ECS.
Se muestra como tarea
ecs.containerinsights.desired_task_count.maximum
(count)
Número máximo de tareas deseadas para un servicio de Amazon ECS.
Se muestra como tarea
ecs.containerinsights.desired_task_count.minimum
(count)
Número mínimo de tareas deseadas para un servicio de Amazon ECS.
Se muestra como tarea
ecs.containerinsights.desired_task_count.samplecount
(count)
Recuento de muestra de tareas deseadas para un servicio de Amazon ECS.
Se muestra como tarea
ecs.containerinsights.desired_task_count.sum
(count)
Suma de tareas deseadas para un servicio de Amazon ECS.
Se muestra como tarea
ecs.containerinsights.memory_reserved
(gauge)
Memoria reservada por las tareas en el recurso especificado para la dimensión elegida.
Se muestra como megabytes
ecs.containerinsights.memory_reserved.maximum
(gauge)
Memoria máxima reservada por las tareas en el recurso especificado para la dimensión elegida.
Se muestra como megabytes
ecs.containerinsights.memory_reserved.minimum
(gauge)
Memoria mínima reservada por las tareas en el recurso especificado para la dimensión elegida.
Se muestra como megabytes
ecs.containerinsights.memory_reserved.samplecount
(gauge)
Recuento de muestra de la memoria reservada por tareas en el recurso especificado para la dimensión elegida.
Se muestra como megabytes
ecs.containerinsights.memory_reserved.sum
(indicador)
Suma de la memoria reservada por tareas en el recurso especificado para la dimensión elegida.
Se muestra como megabytes
ecs.containerinsights.memory_utilized
(gauge)
Memoria que están utilizando las tareas en el recurso especificado para la dimensión elegida.
Se muestra como megabytes
ecs.containerinsights.memory_utilized.maximum
(gauge)
Memoria máxima utilizada por las tareas en el recurso especificado para la dimensión elegida.
Se muestra como megabytes
ecs.containerinsights.memory_utilized.minimum
(gauge)
Memoria mínima utilizada por las tareas en el recurso especificado para la dimensión elegida.
Se muestra como megabytes
ecs.containerinsights.memory_utilized.samplecount
(gauge)
Recuento de muestra de la memoria utilizada por tareas en el recurso especificado para la dimensión elegida.
Se muestra como megabytes
ecs.containerinsights.memory_utilized.sum
(gauge)
Suma de la memoria utilizada por tareas en el recurso especificado para la dimensión elegida.
Se muestra como megabytes
ecs.containerinsights.pending_task_count
(count)
Número de tareas actualmente en estado PENDIENTE.
Se muestra como tarea
ecs.containerinsights.pending_task_count.maximum
(count)
Número máximo de tareas actualmente en estado PENDIENTE.
Se muestra como tarea
ecs.containerinsights.pending_task_count.minimum
(count)
Número mínimo de tareas actualmente en estado PENDIENTE.
Se muestra como tarea
ecs.containerinsights.pending_task_count.samplecount
(count)
Recuento de muestra de las tareas actualmente en estado PENDIENTE.
Se muestra como tarea
ecs.containerinsights.pending_task_count.sum
(count)
Suma de tareas actualmente en estado PENDIENTE.
Se muestra como tarea
ecs.containerinsights.running_task_count
(count)
Número de tareas actualmente en estado EN EJECUCIÓN.
Se muestra como tarea
ecs.containerinsights.running_task_count.maximum
(count)
Número máximo de tareas actualmente en estado EN EJECUCIÓN.
Se muestra como tarea
ecs.containerinsights.running_task_count.minimum
(count)
Número mínimo de tareas actualmente en estado EN EJECUCIÓN.
Se muestra como tarea
ecs.containerinsights.running_task_count.samplecount
(count)
Recuento de muestra de las tareas actualmente en estado EN EJECUCIÓN.
Se muestra como tarea
ecs.containerinsights.running_task_count.sum
(count)
Suma de tareas actualmente en estado EN EJECUCIÓN.
Se muestra como tarea
ecs.containerinsights.service_count
(count)
Número de servicios en el clúster.
Se muestra como servicio
ecs.containerinsights.service_count.maximum
(count)
Número máximo de servicios en el clúster.
Se muestra como servicio
ecs.containerinsights.service_count.minimum
(count)
Número mínimo de servicios en el clúster.
Se muestra como servicio
ecs.containerinsights.service_count.samplecount
(count)
Recuento de muestra de los servicios en el clúster.
Se muestra como servicio
ecs.containerinsights.service_count.sum
(count)
Suma de servicios en el cluster.
Se muestra como servicio
ecs.containerinsights.storage_read_bytes
(gauge)
Número de bytes leídos del almacenamiento en el recurso especificado para la dimensión elegida.
Se muestra como bytes
ecs.containerinsights.storage_read_bytes.maximum
(gauge)
Número máximo de bytes leídos del almacenamiento en el recurso especificado para la dimensión elegida.
Se muestra como bytes
ecs.containerinsights.storage_read_bytes.minimum
(gauge)
Número mínimo de bytes leídos del almacenamiento en el recurso especificado para la dimensión elegida.
Se muestra como bytes
ecs.containerinsights.storage_read_bytes.samplecount
(gauge)
Recuento de muestra de bytes leídos del almacenamiento en el recurso especificado para la dimensión elegida.
Se muestra como bytes
ecs.containerinsights.storage_read_bytes.sum
(gauge)
Suma de bytes leídos del almacenamiento en el recurso especificado para la dimensión elegida.
Se muestra como bytes
ecs.containerinsights.storage_write_bytes
(gauge)
Número de bytes escritos en el almacenamiento en el recurso especificado para la dimensión elegida.
Se muestra como bytes
ecs.containerinsights.storage_write_bytes.maximum
(gauge)
Número máximo de bytes escritos en el almacenamiento en el recurso especificado para la dimensión elegida.
Se muestra como bytes
ecs.containerinsights.storage_write_bytes.minimum
(gauge)
Número mínimo de bytes escritos en el almacenamiento en el recurso especificado para la dimensión elegida.
Se muestra como bytes
ecs.containerinsights.storage_write_bytes.samplecount
(gauge)
Recuento de muestra de bytes escritos en el almacenamiento en el recurso especificado para la dimensión elegida.
Se muestra como bytes
ecs.containerinsights.storage_write_bytes.sum
(gauge)
Suma de bytes escritos en el almacenamiento en el recurso especificado para la dimensión elegida.
Se muestra como bytes
ecs.containerinsights.task_count
(count)
Número de tareas en ejecución en el servicio.
Se muestra como tarea
ecs.containerinsights.task_count.maximum
(count)
Número máximo de tareas en ejecución en el servicio.
Se muestra como tarea
ecs.containerinsights.task_count.minimum
(count)
Número mínimo de tareas en ejecución en el servicio.
Se muestra como tarea
ecs.containerinsights.task_count.samplecount
(count)
Recuento de muestra de tareas en ejecución en el servicio.
Se muestra como tarea
ecs.containerinsights.task_count.sum
(count)
Suma de tareas en ejecución en el servicio.
Se muestra como tarea
ecs.containerinsights.task_set_count
(count)
Número de conjuntos de tareas en el servicio.
Se muestra como tarea
ecs.containerinsights.task_set_count.maximum
(count)
Número máximo de conjuntos de tareas en ejecución en el servicio.
Se muestra como tarea
ecs.containerinsights.task_set_count.minimum
(count)
Número mínimo de conjuntos de tareas en ejecución en el servicio.
Se muestra como tarea
ecs.containerinsights.task_set_count.samplecount
(count)
Recuento de muestra de conjuntos de tareas en el servicio.
Se muestra como tarea
ecs.containerinsights.task_set_count.sum
(count)
Suma de conjuntos de tareas en el servicio.
Se muestra como tarea

A cada una de las métricas recuperadas de AWS se le asignan las mismas etiquetas que aparecen en la consola de AWS, donde se incluyen el nombre del host y los grupos de seguridad, entre otras cosas.

Nota: Las métricas prefijadas con ecs.containerinsights.* pueden recopilarse activando Collect custom metrics en la pestaña Metric Collection de la página de la integración AWS.

Eventos

Para reducir el ruido, la integración Amazon ECS se configura automáticamente para incluir sólo eventos que contengan las siguientes palabras: drain, error, fail, insufficient memory, pending, reboot terminate. Consulta el siguiente ejemplo de eventos:

Amazon ECS Events

Para eliminar la lista de inclusión y recibir todos los eventos de tu integración con Datadog Amazon ECS, ponte en contacto con el servicio de asistencia de Datadog.

Checks de servicio

aws.ecs.agent_connected

Si el ECS Agent está conectado.

Estados: ok, crítico

Solucionar problemas

¿Necesitas ayuda? Ponte en contacto con el servicio de asistencia de Datadog.