Aperçu

Les étiquettes sont un moyen d’ajouter des dimensions aux télémetries de Datadog afin qu’elles puissent être filtrées, agrégées et comparées dans les visualisations de Datadog. L’utilisation d’étiquettes vous permet d’observer la performance agrégée sur plusieurs hôtes et (optionnellement) de restreindre davantage l’ensemble en fonction d’éléments spécifiques. En résumé, l’étiquetage est une méthode pour observer des points de données agrégés.

Une étiquette peut être formatée comme <key>:<value> ou <value>. Datadog recommande d’utiliser le format <key>:<value>, car il est souvent sémantiquement plus clair et permet des capacités de requête plus riches (par exemple, le regroupement par clé). Lors de l’utilisation d’une paire <key>:<value> :

• L’étiquette clé est l’identifiant. Les clés d’étiquette couramment utilisées sont env, instance et name.
• L’étiquette valeur est les données ou informations spécifiques associées à la clé. Les valeurs d’étiquette ne sont pas uniques par ressource et peuvent être utilisées sur de nombreuses ressources dans une paire <key>:<value>.

L’étiquetage lie différents types de données dans Datadog, permettant la corrélation et les appels à l’action entre les métriques, les traces et les journaux. Cela est réalisé avec des clés d’étiquette réservées :

Datadog recommande d’examiner les conteneurs, les machines virtuelles et l’infrastructure cloud au niveau service dans son ensemble. Par exemple, examinez l’utilisation du CPU à travers un ensemble d’hôtes représentant un service, plutôt que l’utilisation du CPU pour le serveur A ou le serveur B séparément.

Puisque les conteneurs et les environnements cloud changent régulièrement de hosts, il est important d’utiliser des tags pour agréger vos métriques.

Définir des étiquettes

Les chaînes d’étiquettes (c’est-à-dire, le contenu entier de <key>:<value> ou <value>) doivent répondre aux exigences suivantes :

• Les chaînes d’étiquettes doivent commencer par une lettre (cela s’applique indépendamment du fait que l’étiquette utilise le format <key>:<value> ou <value>). Après la lettre initiale, la chaîne d’étiquette peut contenir les caractères énumérés ci-dessous :

  • Lettres (toutes les lettres Unicode sont prises en charge—par exemple, a, ó, 気, 녕, ك, et ดี)
  • Chiffres
  • Underscores (les underscores en début et en fin sont supprimés, et les underscores contigus sont réduits à un seul)
  • Tirets
  • Deux-points
  • Points
  • Barres obliques
  • (Uniquement pour les étiquettes sur les journaux ingérées via HTTP) signes @ (@)

  Tous les autres caractères (y compris les virgules, les émojis, les barres obliques inverses et les espaces) sont convertis en underscores.

  Remarques :

  • Une étiquette qui commence par un chiffre peut être acceptée dans certains contextes, tels que les étiquettes env définies au niveau de l’Agent. Cependant, les balises qui ne respectent pas les règles de nommage standard peuvent ne pas fonctionner de manière cohérente dans tous les produits Datadog et peuvent augmenter la cardinalité des balises. Commencez les balises par une lettre, sauf si un produit spécifique le prend explicitement en charge.
  • La variable d’environnement DD_TAGS utilise des espaces comme séparateur entre les balises. Les espaces dans les valeurs DD_TAGS ne sont pas convertis en underscores. Par exemple, DD_TAGS="test:this is a test" produit quatre balises distinctes : test:this, is, a et test. Pour définir une valeur de balise contenant des espaces, utilisez un fichier de configuration YAML ou des annotations d’intégration, où les espaces sont convertis en underscores.

• Les balises peuvent avoir une longueur allant jusqu’à 200 caractères. Si la balise a le format <key>:<value>, la clé, :, et la valeur comptent toutes pour la limite de caractères.

• Les balises de span et les balises de métriques sont normalisées en minuscules, donc évitez d’utiliser le camel case dans les clés de balises. Les fournisseurs de cloud normalisent le camel case de manière incohérente. Par exemple, AWS convertit TestTag en testtag, tandis qu’Alibaba Cloud convertit TestTag en test_tag.

  • Contrairement aux balises, les attributs de span et les attributs de log sont sensibles à la casse et ne sont pas normalisés.

• Lors de l’utilisation du format <key>:<value>, la clé précède toujours le premier deux-points de la définition de balise globale. Exemple :

  Balise	Clé	Valeur
  env:staging:east	env	staging:east
  env_staging:east	env_staging	east

• Les balises ne doivent pas provenir de sources non bornées, telles que des horodatages d’époque, des identifiants d’utilisateur ou des identifiants de requête. Cela peut entraîner une croissance illimitée de votre nombre de métriques.

Attribuer des balises

Méthodes de balisage

Vous pouvez utiliser l’une (ou l’ensemble) des méthodes suivantes pour assigner des tags.

Pour en savoir plus, consultez la section Assigner des tags.

Étiquetage de service unifié

En tant que meilleure pratique, Datadog recommande d’utiliser l’étiquetage de service unifié lors de l’attribution des étiquettes. L’étiquetage de service unifié relie la télémétrie de Datadog grâce à l’utilisation de trois étiquettes standard : env, service et version. Pour apprendre à configurer votre environnement avec l’étiquetage unifié, consultez Étiquetage de service unifié.

Héritage des étiquettes

Toutes les métriques, journaux, traces et intégrations passent par un processus d’host-tag héritage lors de l’ingestion des données dans Datadog. Étant donné que les données sont associées à un nom d’hôte donné, ces composants héritent de toutes les host-level étiquettes associées à cet hôte. Ces étiquettes sont visibles dans la liste d’infrastructure pour un hôte donné, provenant soit du fournisseur de cloud, soit de l’Agent Datadog. Consultez les étiquettes host-level manquantes sur les nouveaux hôtes ou nœuds pour plus d’informations.

Parce que les étiquettes peuvent être héritées de plusieurs sources, choisissez des noms de clés uniques et spécifiques pour éviter de les dupliquer entre les sources. Par exemple, si vous avez défini une clé service sur un hôte (service:my-host) et une clé service sur un pod s’exécutant sur cet hôte (service:my-service), vos données héritent des deux étiquettes. Optez pour des noms de clés plus différenciés (comme infra_service) pour éviter les clés d’étiquettes en double.

Priorité des étiquettes

L’Agent Datadog ne pas impose un ordre de priorité pour les étiquettes définies à partir de différentes sources. Au lieu de cela, l’Agent collecte toutes les étiquettes de chaque source disponible, stocke chaque valeur unique pour une clé d’étiquette donnée et les émet toutes avec la télémétrie.

Cela signifie qu’une seule clé d’étiquette peut avoir plusieurs valeurs si elle est configurée différemment entre les sources. Par exemple, si l’étiquette service est définie sur payments dans une variable d’environnement, checkout dans le YAML de l’Agent, et orders dans une configuration de client de traçage, la télémétrie pour ce service pourrait inclure :

service:payments
service:checkout
service:orders

Les filtres ou tableaux de bord en aval doivent explicitement filtrer sur la valeur souhaitée si vous n’en attendez qu’une seule.

Utilisation

Après avoir attribué des étiquettes au niveau de l’hôte et de l’intégration, commencez à les utiliser pour filtrer et regrouper vos métriques, traces et journaux. Les étiquettes sont utilisées dans les domaines suivants de votre plateforme Datadog.

Pour en savoir plus, consultez la section Utiliser les tags.

Lectures complémentaires

Documentation, liens et articles supplémentaires utiles:

Apprendre à assigner des tagsDOCUMENTATION Apprendre à configurer le tagging de service unifiéDOCUMENTATION Apprendre à assigner des tagsDOCUMENTATION Participer à une session interactive sur le tagging efficace avec DatadogVALIDATION DES BASES Concevez des tableaux de bord exécutifs efficaces avec DatadogBLOG Meilleures pratiques de balisageCENTRE D'APPRENTISSAGE