Présentation
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 de plusieurs 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.
| 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 solution Log Management |
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. |
Datadog vous conseille d’étudier les données des conteneurs, machines virtuelles et de l’infrastructure cloud dans leur ensemble, au niveau des services. Par exemple, consultez l’utilisation du 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.
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.
Voici quelques exigences en ce qui concerne l’utilisation de tags dans Datadog :
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.
Les tags peuvent comporter jusqu’à 200 caractères et prennent en charge les lettres Unicode (qui incluent la plupart des jeux de caractères, y compris les langues comme le japonais).
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.
Un tag peut être au format valeur ou <KEY>:<VALUE>. Les clés de tag env, instance et name sont couramment utilisées. La clé précède toujours le caractère « : » de la définition globale du tag. Exemple :
| Tag | Clé | Valeur |
|---|
env:staging:east | env | staging:east |
env_staging:east | env_staging | east |
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.
Les limites (comme les minuscules) s’appliquent uniquement aux tags de métrique, et non aux attributs de logs ou aux tags de span.
Méthodes de tagging
Vous pouvez utiliser l’une (ou l’ensemble) des méthodes suivantes pour assigner des tags.
| Méthode | Assignation de tags |
|---|
| Fichiers de configuration | Assignation manuelle dans les principaux fichiers de configuration de votre Agent ou des intégrations |
| Interface | Sur le site Datadog |
| API | Lors de l’utilisation de l’API Datadog |
| DogStatsD | Lors de l’envoi de métriques avec DogStatsD |
Pour en savoir plus, consultez la section Assigner des tags.
Tagging de service unifié
Datadog vous conseille d’utiliser le tagging de service unifié lorsque vous assignez des tags. Cette fonctionnalité permet de lier les données de télémétrie Datadog entre elles via trois tags standard : env, service et version. Pour découvrir comment configurer le tagging unifié pour votre environnement, consultez la section Tagging de service unifié.
Utilisation
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.
| Section | Utilité des tags |
|---|
| Événements | Filtrer le flux d’événements |
| Dashboards | Filtrer et regrouper des métriques dans 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 des services, traces et profils ou accéder à d’autres sections avec la Service Map |
| RUM et Session Replay | Filtrer des recherches d’événements, des analyses, des patterns, des replays et des problèmes avec le RUM Explorer |
| Surveillance Synthetic et tests en continu | Filtrer et regrouper des tests Synthetic ou des tests s’exécutant dans des pipelines CI avec la surveillance Synthetic et les tests en continu |
| Notebooks | Filtrer et regrouper des métriques dans 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’interface avec l’API. |
| Facturation | Obtenir des informations sur votre utilisation de Datadog en choisissant jusqu’à trois tags, tels que env, team, et account_id. |
| CI Visibility | Filtrez et regroupez les exécutions de tests ou de pipelines avec l’explorer CI Visibility. |
Pour en savoir plus, consultez la section Utiliser les tags.
Pour aller plus loin
Documentation, liens et articles supplémentaires utiles:
