Utiliser les tags

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

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 :

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

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.

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.

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.

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 :

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.

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.

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

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

Ou des conteneurs :

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

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

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

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.

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.

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.

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.

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.

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.

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.

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.

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 :