Información general

El Datadog Agent puede crear y asignar etiquetas a todas las métricas, trazas (traces) y logs emitidos por un contenedor en base a sus etiquetas o variables de entorno.

Etiquetas predefinidas

El Agent puede detectar automáticamente y adjuntar etiquetas a todos los datos emitidos por la tarea completa o por un contenedor individual dentro de esta tarea. La lista de etiquetas que se adjunta automáticamente depende de la configuración de la cardinalidad del Agent.

EtiquetaCardinalidadOrigen
container_nameAltaDocker
container_idAltaDocker
docker_imageBajaDocker
image_nameBajaDocker
short_imageBajaDocker
image_tagBajaDocker
ecs_cluster_nameBajaAPI ECS
ecs_container_nameBajaAPI ECS
task_arnOrchestratorAPI ECS
task_familyBajaAPI ECS
task_nameBajaAPI ECS
task_versionBajaAPI ECS

Etiquetado de servicios unificado

Como práctica recomendada para entornos contenedorizados, Datadog recomienda utilizar el etiquetado unificado de servicios al asignar etiquetas. El etiquetado unificado de servicios une la telemetría de Datadog mediante el uso de tres etiquetas estándar: env, service y version. Para saber cómo configurar tu entorno con el etiquetado unificado, consulta la documentación del etiquetado unificado de servicios de Amazon ECS.

Recopilación de etiquetas de recursos

Si no tienes el etiquetado unificado de servicios habilitado, completa los siguientes pasos para recopilar etiquetas de recursos ECS:

  1. Comprueba que tus instancias de contenedor de Amazon ECS están asociadas a un rol IAM. Esto se puede hacer al crear un nuevo clúster con el asistente de creación de clústeres ECS o en la configuración de lanzamiento utilizada por un grupo de escalado automático.

  2. Actualiza el rol IAM utilizado por tus instancias de contenedor de Amazon ECS con: ecs:ListTagsForResource.

  3. Actualiza tu archivo datadog-agent-ecs.json (datadog-agent-ecs1.json, si estás utilizando una AMI original Amazon Linux), para habilitar la recopilación de etiquetas de recursos añadiendo la siguiente variable de entorno:

        {
          "name": "DD_ECS_COLLECT_RESOURCE_TAGS_EC2",
          "value": "true"
        }
        

Notas

  • Asegúrate de que el rol IAM está asociado a tus instancias de contenedor de Amazon ECS y no al rol de la tarea del contenedor del Datadog Agent.
  • Las etiquetas de recursos ECS se pueden recopilar de instancias EC2, pero no de AWS Fargate.
  • Esta función requiere las versiones 6.17, 7.17 o posteriores del Datadog Agent.
  • El Agent admite la recopilación de etiquetas ECS de los recursos ECS tasks, services y container instances.
  • Si no aparecen etiquetas AWS en Datadog, asegúrate de que estas se aplican tanto a la instancia como al recurso en la nube AWS correspondiente.

Referencias adicionales