Extraction de tags Amazon ECS

Docs > Surveillance des conteneurs > Amazon ECS > Extraction de tags Amazon ECS

Présentation

L’Agent Datadog peut créer et appliquer des tags à l’ensemble des métriques, des traces et des logs envoyés par un conteneur en fonction de ses étiquettes ou de ses variables d’environnement.

Tags par défaut

L’Agent peut découvrir automatiquement et associer des tags à toutes les données émises par la tâche entière ou par un conteneur individuel au sein de cette tâche. La liste des tags associés automatiquement dépend de la configuration de cardinalité de l’Agent.

Tag	Cardinalité	Source
`container_name`	Élevée	Docker
`container_id`	Élevée	Docker
`docker_image`	Faible	Docker
`image_name`	Faible	Docker
`short_image`	Faible	Docker
`image_tag`	Faible	Docker
`aws_account`	Faible	ECS API
`cluster_arn`	Faible	ECS API
`service_arn`	Faible	ECS API
`region`	Faible	ECS API
`ecs_cluster_name`	Faible	ECS API
`ecs_container_name`	Faible	ECS API
`ecs_service_name`	Faible	ECS API
`task_arn`	Orchestrator	ECS API
`task_definition_arn`	Orchestrator	ECS API
`task_family`	Faible	ECS API
`task_name`	Faible	ECS API
`task_version`	Faible	ECS API

Tagging de service unifié

En tant que meilleure pratique dans les environnements conteneurisés, Datadog recommande d’utiliser le tagging de service unifié lors de l’attribution de tags. Le tagging de service unifié relie les données de télémétrie Datadog grâce à l’utilisation de trois tags standard : env, service et version. Pour découvrir comment configurer votre environnement avec le tagging unifié, consultez la documentation sur le tagging de service unifié Amazon ECS.

Collecte de tags de ressource

Si vous n’avez pas activé le tagging de service unifié, effectuez les étapes suivantes pour collecter des tags de ressource ECS :

Vérifiez que vos instances de conteneur Amazon ECS sont associées à un rôle IAM. Cette opération peut être effectuée lors de la création d’un cluster via l’assistant de création de clusters ECS ou via la configuration de lancement utilisée par un groupe autoscaling.
Remplacez le rôle IAM utilisé par vos instances de conteneur Amazon ECS par : ecs:ListTagsForResource.
Modifiez votre fichier datadog-agent-ecs.json (datadog-agent-ecs1.json si vous utilisez une AMI Amazon Linux d’origine) afin d’activer la collecte de tags de ressource en ajoutant la variable d’environnement suivante :
```
    {
      "name": "DD_ECS_COLLECT_RESOURCE_TAGS_EC2",
      "value": "true"
    }
    
```

Remarques

Vérifiez que le rôle IAM est associé à vos instances de conteneur Amazon ECS et non pas au rôle de tâche du conteneur de l’Agent Datadog.
Les tags de ressource ECS peuvent être recueillis à partir d’instances EC2, mais pas à partir d’AWS Fargate.
Cette fonctionnalité nécessite la version 6.17+ ou 7.17+ de l’Agent Datadog.
L’Agent prend en charge la collecte de tags ECS à partir des ressources ECS tasks, services et container instances.
Si les tags AWS n’apparaissent pas dans Datadog, assurez-vous que les tags sont appliqués à la fois à l’instance et à la ressource cloud AWS correspondante.