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 prêts à l’emploi

L’Agent peut découvrir automatiquement des tags et les ajouter à toutes les données générées par toute une tâche ou par un conteneur spécifique dans cette tâche. La liste des tags ajoutés automatiquement dépend de la configuration de cardinalité de l’Agent.

TagCardinalitéSource
container_nameForteDocker
container_idForteDocker
docker_imageFaibleDocker
image_nameFaibleDocker
short_imageFaibleDocker
image_tagFaibleDocker
ecs_cluster_nameFaibleAPI ECS
ecs_container_nameFaibleAPI ECS
task_arnOrchestrateurAPI ECS
task_familyFaibleAPI ECS
task_nameFaibleAPI ECS
task_versionFaibleAPI ECS

Tagging de service unifié

Datadog vous conseille d’utiliser le tagging de service unifié lorsque vous assignez des tags dans des environnements conteneurisés. Le tagging de service unifié permet de lier les données de télémétrie Datadog entre elles à l’aide de trois tags standards : env, service et version. Pour découvrir comment configurer le tagging unifié pour votre environnement, consultez la documentation dédiée pour 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 :

  1. 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.

  2. Remplacez le rôle IAM utilisé par vos instances de conteneur Amazon ECS par : ecs:ListTagsForResource.

  3. 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.

Pour aller plus loin

Documentation, liens et articles supplémentaires utiles:

Débuter avec les tagsDOCUMENTATION more more Utiliser des tags avec DatadogDOCUMENTATION more more Limiter la collecte de données à un sous-ensemble de conteneursDOCUMENTATION more more