Après avoir assigné des tags, utilisez-les pour filtrer et regrouper vos données au sein de la plateforme Datadog. Les tags vous permettent d’inclure et d’exclure des données. Lorsque vous choisissez d’inclure ou d’exclure plusieurs tags :

  • la fonction Include utilise la logique AND ;
  • la fonction Exclude utilise la logique OR.

Événements

Le flux d’événements affiche tous les événements de votre environnement au cours de l’intervalle spécifié. Utilisez des tags pour affiner la liste d’événements et étudier un sous-ensemble d’événements. Saisissez tags: suivi du nom d’un tag pour afficher tous les événements générés par un host, une intégration ou un service qui possèdent ce tag. Dans l’exemple ci-dessous, l’expression tags:service:coffee-house permet de rechercher le tag service:coffee-house. Pour effectuer une recherche inclusive avec plusieurs tags, séparez chaque tag par l’opérateur OR : tags:service:coffee-house OR host:coffeehouseprod. Pour effectuer une recherche exclusive avec plusieurs tags, séparez chaque tag par une virgule : tags:service:coffee-house,host:coffeehouseprod.

Liste d'événements et tags

Dashboards

Utilisez des tags pour filtrer les métriques à afficher dans un graphique de dashboard ou pour créer des groupes agrégés de métriques à afficher. Pour filtrer les métriques à afficher, saisissez les tags dans la zone de texte from. Les données de la métrique choisie s’afficheront alors pour toutes les sources qui possèdent ce tag (à savoir, service:coffee-house dans l’exemple ci-dessous).

Tags dans des dashboards avec la zone de texte from

Le filtrage avancé des valeurs de tag peut également inclure des filtres booléens. La syntaxe booléenne suivante est prise en charge :

  • NOT, !
  • AND, ,
  • OR
  • key IN (valeur_tag1, valeur_tag2, etc.)
  • key NOT IN (valeur_tag1, valeur_tag2, etc.)

Utilisez AND ou OR pour examiner une métrique en fonction de tags spécifiques :

Filtre booléen avec AND/OR

Utilisez IN ou NOT IN pour filtrer rapidement une métrique en fonction de tags spécifiques :

Filtre booléen avec IN/NOT IN

Pour créer un groupe agrégé à l’aide de tags, saisissez la clé du tag dans la zone de texte avg by. Par exemple, si vous disposez d’un graphique de séries temporelles présentant une métrique taguée avec la clé service, comme service:coffee-house, saisissez service dans la zone de texte avg by pour afficher une ligne pour chaque valeur de tag service. Chaque ligne représente la valeur moyenne de la métrique pour l’ensemble des sources qui partagent la valeur de tag service.

Tags dans des dashboards avec la zone de texte avg by

Les tags peuvent également être utilisés pour superposer des événements sur un dashboard, comme dans le flux d’événements. Saisissez tags: suivi du nom du tag. Les événements correspondants sont superposés sous la forme de barres verticales dans le graphique. L’exemple ci-dessous utilise l’expression tags:service:coffee-house.

Superposition d'événements dans des dashboards

Utilisez des template variables pour activer facilement le tag from sur les graphiques de votre dashboard. Dans l’exemple ci-dessous, service est utilisé pour représenter la clé de tag service. Ajoutez la template variable $service dans la zone de texte from de votre requête de graphique pour l’utiliser.

Template variables dashboard

Vous trouverez ci-dessous un exemple de tags avec l’éditeur de graphiques pour séries temporelles. Aucun tag n’a été appliqué dans la première capture d’écran. L’utilisation moyenne de processeur est donc affichée pour l’ensemble des hosts :

Tags_1

Les informations de l’éditeur sont ensuite mises à jour afin d’inclure un tag (region:eastus) dans la zone de texte from. Cela permet à Datadog d’afficher l’utilisation de processeur sur l’ensemble de la région Est des États-Unis. Le tag region est utilisé à titre d’exemple : vous pouvez utiliser n’importe quel tag arbitraire transmis à votre plateforme Datadog, comme application, service, environment, etc.

Tags_2

Enfin, le deuxième champ vide (la zone de texte avg by) est utilisé pour afficher une ligne de série temporelle pour chaque host. Le processeur du serveur est affiché pour chaque host exécuté dans la région Est des États-Unis.

Tags_3

Vous pouvez ajouter d’autres tags pour réduire davantage la portée, afin d’étudier par exemple les hosts dans region:eastus et env:production. Les tags peuvent être utilisés pour de nombreuses fonctionnalités de Datadog et appliqués à l’ensemble des éléments de base (métriques, traces et logs).

Infrastructure

Pour filtrer la hostmap, la liste des infrastructures, les conteneurs et les processus, saisissez un tag dans la zone de texte Filter by en haut de la page. Les hosts et conteneurs peuvent être regroupés par clé de tag à l’aide de la zone de texte Group by. Si vous saisissez service dans cette zone de texte, chaque service s’affiche sous la forme d’un en-tête de groupe.

Depuis cette section, utilisez des tags pour filtrer ou regrouper des hosts :

Tags hostmap

Ou des conteneurs :

Tags map des conteneurs

La liste d’infrastructures propose les champs de filtrage et de regroupement suivants :

Tags de la liste d'infrastructures

La page des live containers propose les champs de filtrage et de regroupement suivants :

Tags live containers

La page des live processes propose les champs de filtrage et de regroupement suivants :

Tags live processes

Monitors

Pour filtrer des monitors en fonction des tags qui leur sont assignés, utilisez la barre de recherche ou les cases des facettes. Vous devez utiliser le format suivant dans la barre de recherche : tag:<KEY>:<VALUE>. Indiquez par exemple tag:service:coffee-house. Pour exclure les monitors associés à un tag spécifique de votre recherche, utilisez - (par exemple : tag:-service:coffee-house). Remarque : les tags de monitor ne fonctionnent pas de la même façon que les tags de métrique.

Gérer les tags de monitor

Lorsque vous créez un monitor, utilisez les tags de métrique dans :

  • la zone de texte from, afin de limiter la portée du monitor et d’inclure uniquement les métriques possédant les tags indiqués ;

  • la zone de texte excluding, afin d’exclure les métriques correspondantes de la portée du monitor ;

  • la zone de texte avg by, afin de transformer le monitor en un monitor à alertes multiples pour chaque valeur de tag.

Tags nouveau monitor

Pour filtrer les downtimes en fonction d’un tag de monitor, saisissez le nom du tag dans la barre de recherche, par exemple service:coffee-house.

Gérer les tags de monitor

Métriques

Utilisez les tags dans Metrics Explorer pour filtrer les métriques en fonction de tags ou pour afficher plusieurs graphiques selon une clé de tag. L’exemple ci-dessous représente une métrique avec l’expression service:coffee-house et affiche un graphique par host.

Gérer les tags de monitor

Intégrations

Certaines intégrations vous permettent de limiter les métriques recueillies en utilisant des tags.

Le carré d’intégration AWS propose les filtres par tags to hosts with tag et to Lambdas with tag.

Ces champs acceptent une liste de tags séparés par des virgules (au format <KEY>:<VALUE>) qui, ensemble, définissent un filtre utilisé pour la collecte de vos ressources EC2 ou Lambda. Ces paires <KEY>:<VALUE> peuvent être utilisées pour inclure ou exclure des fonctions selon leurs tags. Pour exclure un tag, ajoutez ! devant la clé de tag. Les wildcards tels que ? (pour un seul caractère) et * (pour plusieurs caractères) sont également acceptés.

Si vous souhaitez qu’un filtre inclue les ressources contenant n’importe quel tag autorisé, utilisez l’opérateur OR. L’exemple de filtre suivant recueille les instances EC2 contenant le tag datadog:monitored OU env:production :

datadog:monitored,env:production

Si vous spécifiez un tag d’exclusion, cette règle est appliquée en priorité via une déclaration AND. L’exemple de filtre suivant recueille les instances EC2 qui contiennent le tag datadog:monitored, OU env:production, OU un tag instance-type avec une valeur c1.*, mais qui ne contiennent PAS le tag region:us-east-1 :

datadog:monitored,env:production,instance-type:c1.*,!region:us-east-1

Pour en savoir plus sur le tagging dans AWS, consultez la documentation sur EC2 et les fonctions Lambda.

Le carré d’intégration Azure propose le filtre par tags Optionally filter to VMs with tag.

Ce champ accepte une liste de tags séparés par des virgules (au format <KEY>:<VALUE>) qui, ensemble, définissent un filtre utilisé pour la collecte de métriques à partir des VM Azure. Les wildcards tels que ? (pour un seul caractère) et * (pour plusieurs caractères) sont également acceptés. Seules les VM qui correspondent à l’un des tags définis sont importées dans Datadog. Les autres sont ignorées.

Ajoutez ! devant un tag pour exclure les machines virtuelles correspondant à ce tag. Par exemple :

datadog:monitored,env:production,!env:staging,instance-type:c1.*

Le carré d’intégration Google Cloud propose le filtre par tags to hosts with tag.

Ce champ accepte une liste de libellés GCP séparés par des virgules (au format <KEY>:<VALUE>) qui, ensemble, définissent un filtre utilisé pour la collecte de métriques à partir de GCP. Les wildcards tels que ? (pour un seul caractère) et * (pour plusieurs caractères) sont également acceptés. Seuls les hosts qui correspondent à l’un des libellés définis sont importés dans Datadog. Les autres sont ignorés.

Ajoutez ! devant un tag pour exclure les hosts correspondant à un libellé spécifique. Par exemple :

datadog:monitored,env:production,!env:staging,instance-type:c1.*

Consultez la documentation Google Cloud pour en savoir plus sur la création et la gestion d’étiquettes.

APM

Pour les recherches de traces, filtrez les traces avec des tags à l’aide de la barre de recherche ou des cases des facettes. Vous devez utiliser le format suivant dans la barre de recherche : <KEY>:<VALUE>. Indiquez par exemple service:coffee-house. Pour effectuer une recherche avancée, consultez la page sur les recherches de traces.

Tags recherche de traces

Après avoir assigné des tags, utilisez la Service Map pour accéder à différentes sections de l’application en cliquant sur un service spécifique. L’exemple ci-dessous affiche les données Analytics, les monitors, les logs et la hostmap correspondant au tag service:coffee-house.

Tags Service Map

Notebooks

Lors de la création d’un graphique de notebook, limitez des métriques en utilisant des tags dans la zone de texte from. Vous pouvez également regrouper des métriques en ajoutant des tags dans la zone de texte avg by. Dans l’exemple ci-dessous, les métriques sont limitées à service:coffee-house et regroupées par host.

Tags notebook

Pour exclure des tags, utilisez </> afin de modifier le texte, puis ajoutez le tag en respectant le format !<KEY>:<VALUE>. Dans l’exemple ci-dessous, service:coffeehouse est exclu par l’expression !service:coffeehouse.

Logs

Pour les recherches, les analyses, les patterns et le Live Tailing de logs, filtrez les logs avec des tags à l’aide de la barre de recherche ou des cases des facettes. Vous devez utiliser le format suivant dans la barre de recherche : <KEY>:<VALUE>. Indiquez par exemple service:coffee-house. Pour effectuer une recherche avancée, consultez la page sur les recherches de logs.

Tags de recherche de logs
Tags d'analyse de logs
Tags de Log Patterns

Les tags permettent également de filtrer un pipeline de logs. Dans l’exemple ci-dessous, le pipeline filtre les logs selon le tag service:coffee-house.

Tags de pipeline

Service Level Objectives

Pour filtrer des SLO en fonction des tags qui leur sont assignés, utilisez la barre de recherche ou les cases des facettes. Vous devez utiliser le format suivant dans la barre de recherche : <KEY>:<VALUE> (par exemple : journey:add_item). Pour exclure les SLO associés à un tag spécifique de votre recherche, utilisez - (par exemple : -journey:add_item). Remarque : les tags de SLO sont différents et distincts des tags de métrique ou de monitor utilisés dans les métriques ou les monitors qui composent un SLO.

Tags de SLO

Lorsque vous créez un SLO basé sur des métriques, utilisez les tags de métrique dans les requêtes de calcul du taux de réussite du SLO (toutes les métriques doivent utiliser le même ensemble de tags de métrique) :

  • La zone de texte from permet de limiter le contexte de la métrique à ces tags uniquement.
  • La zone de texte sum by permet de créer un SLO groupé basé sur des métriques qui affiche un pourcentage de statut ainsi que la marge d’erreur restante pour le SLO global et pour chaque valeur de tag.
Tags de SLO basé sur des métriques

Lorsque vous créez un SLO basé sur des monitors à partir d’un seul monitor groupé, utilisez l’option Calculate on selected groups pour sélectionner jusqu’à 20 valeurs de tag associées au monitor sous-jacent et afficher le pourcentage de statut et la marge d’erreur restante pour le SLO global et pour chaque valeur de tag :

Tags de SLO basé sur des monitors

Développeurs

Les tags peuvent être utilisés de diverses façons avec l’API. Cliquez sur les liens ci-dessous pour accéder aux rubriques indiquées :

Pour aller plus loin