Débuter avec les tags

Introduction

Les tags sont conçus pour ajouter des caractéristiques aux données de télémétrie Datadog, afin de pouvoir les filtrer, les agréger et les comparer au sein de visualisations Datadog. Lorsque vous utilisez des tags, vous pouvez observer les performances globales d’un certain nombre de hosts et même affiner davantage les résultats selon des éléments spécifiques. En somme, les tags constituent un moyen d’observer des points de données agrégées.

Les tags relient différents types de données dans Datadog. Grâce à certaines clés de tag réservées, vous pouvez corréler différent(e)s métriques, traces et logs et déclencher des actions. Voici quelques exemples :

Clé de tag	Fonctionnalité
host	Corrélation entre des métriques, des traces, des processus et des logs
device	Séparation de métriques, traces, processus et logs selon un appareil ou un disque
source	Filtrage de spans et création automatisée de pipelines pour la gestion des logs
service	Définition du contexte des données spécifiques à l’application pour l’ensemble des métriques, traces et logs
env	Définition du contexte des données spécifiques à l’application pour l’ensemble des métriques, traces et logs
version	Définition du contexte des données spécifiques à l’application pour l’ensemble des métriques, traces et logs

Importance

Il est généralement conseillé d’étudier les données des conteneurs, machines virtuelles et de l’infrastructure dans le cloud dans leur ensemble, au niveau des services. Par exemple, il est plus pertinent de consulter l’utilisation de processeur d’un ensemble de hosts qui représentent un service, plutôt que d’analyser l’utilisation distincte d’un serveur A ou d’un serveur B.

Les conteneurs et les environnements cloud fouillent régulièrement parmi les hosts. Il est donc essentiel de les taguer pour permettre l’agrégation des métriques obtenues.

Définition des tags

Voici quelques exigences en ce qui concerne l’utilisation de tags dans Datadog :

1. Les noms des tags doivent commencer par une lettre. Ils peuvent ensuite contenir les caractères suivants :

   • Des caractères alphanumériques
   • Des underscores
   • Des moins
   • Des virgules
   • Des points
   • Des barres obliques

   Les autres caractères spéciaux sont remplacés par des underscores.

   Remarque : le nom d’un tag ne peut pas se terminer par le caractère « : », comme tag:.

2. Les noms de tags peuvent comporter jusqu’à 200 caractères et prennent en charge la norme Unicode.

3. Les tags sont convertis en minuscules. Ainsi, les tags CamelCase ne sont pas recommandés. Les intégrations reposant sur une authentification (crawler) convertissent les tags au format camel case en ajoutant des underscores. Par exemple, TestTag –> test_tag.

4. Un tag peut être au format valeur ou <KEY>:<VALUE>. Pour un fonctionnement optimal, nous recommandons de créer des tags au format <KEY>:<VALUE>. env, instance, et name sont des clés de tag couramment utilisées. La clé précède toujours le caractère « : » de la définition globale du tag. Par exemple :

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

5. Les tags ne doivent pas provenir de sources illimitées, telles que des horodatages epoch, des ID d’utilisateur ou des ID de requête. Cela pourrait accroître de façon significative le nombre de métriques de votre organisation et augmenter vos frais.

Assigner des tags

Méthodes de tagging

Vous pouvez utiliser l’une (ou l’ensemble) des méthodes suivantes pour assigner des tags. Consultez la documentation relative à l’assignation des tags pour en savoir plus :

Méthode	Assignation de tags
Fichiers de configuration	Assignation manuelle dans les principaux fichiers de configuration de votre Agent ou des intégrations
IU	Dans l’app Datadog
API	Lors de l’utilisation de l’API Datadog
DogStatsD	Lors de l’envoi de métriques via DogStatsD

Tagging de service unifié

Datadog vous conseille d’utiliser le tagging de service unifié lorsque vous assignez des tags. Le tagging de service unifié permet de lier les données de télémétrie Datadog entre elles via trois tags standards : env, service et version. Pour découvrir comment configurer le tagging unifié pour votre environnement, consultez la documentation dédiée au tagging de service unifié.

Utiliser les tags

Assignez des tags au niveau des hosts et des intégrations pour pouvoir filtrer et regrouper vos métriques, traces et logs. Les tags peuvent être utilisés dans les sections suivantes de votre plateforme Datadog. Consultez la documentation relative à l’utilisation des tags pour en savoir plus :

Section	Utilisation des tags
Événements	Filtrer le flux d’événements
Dashboards	Filtrer et regrouper des métriques sur des graphiques
Infrastructure	Filtrer et regrouper des données sur les vues de la hostmap, de la liste d’infrastructures, des live containers et des live processes
Monitors	Créer et gérer des monitors ou gérer des downtimes
Métriques	Filtrer et regrouper des données avec le Metrics Explorer
Intégrations	Définir des limites facultatives pour AWS, Google Cloud et Azure
APM	Filtrer les données Analytics ou accéder facilement à d’autres sections avec la Service map
Notebooks	Filtrer et regrouper des métriques sur des graphiques
Logs	Filtrer la recherche de logs, les analyses, les patterns, le live tailing et les pipelines
SLO	Rechercher des SLO ainsi que des SLO groupés basés sur des métriques ou sur des monitors.
Outils de développement	Récupérer des informations ou configurer différentes sections dans l’IU avec l’API
Facturation	Obtenir des informations sur votre utilisation de Datadog en choisissant jusqu’à trois tags, tels que env, team, et account_id

Pour aller plus loin