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. Cette métrique s’affiche alors pour toutes les sources qui possèdent ce tag (à savoir, service:web-store 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érie temporelle présentant une métrique taguée avec la clé service, comme service:web-store, 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 servir à superposer des événements sur un dashboard, comme dans l’Events Explorer. Les événements correspondants sont superposés sous la forme de barres verticales dans le graphique. L’exemple ci-dessous utilise l’expression service:web-store.

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 du CPU 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 du CPU 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 ou environment.

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 CPU 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 :

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.

Depuis le Trace Explorer, vous pouvez filtrer les traces avec des tags à l’aide de la barre de recherche ou les 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 section Syntaxe de requête.

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.

La page Synthetic Tests répertorie la liste de vos tests Synthetic.

Pour filtrer des tests en fonction de tags, utilisez la barre de recherche ou les cases de facettes. Vous devez utiliser le format suivant dans la barre de recherche : <KEY>:<VALUE>. Indiquez par exemple tag:mini-website. Pour effectuer une recherche avancée, consultez la section Rechercher et gérer des tests Synthetic.

La vue Synthetic Monitoring & Testing Results Explorer présente vos exécutions de test et lots d’exécutions au sein d’un pipeline de CI.

Pour filtrer des exécutions de test en fonctions de tags, utilisez la barre de recherche ou les cases de facettes. Vous devez utiliser le format suivant dans la barre de recherche : <KEY>:<VALUE>. Indiquez par exemple @ci.provider.name:github. Pour effectuer une recherche avancée, consultez la section Rechercher des lots de tests.

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>. Indiquez par exemple journey:add_item. Pour exclure les SLO associées à un tag spécifique de votre recherche, utilisez - (par exemple : -journey:add_item).

Les tags de SLO ne fonctionnent pas de la même façon que les tags appliqués aux métriques ou monitors sous-jacents d’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 :

La vue CI Visibility Explorer affiche vos exécutions de test dans un pipeline de CI.

Pour filtrer des exécutions de test en fonction de tags, utilisez la barre de recherche ou les cases de facettes. Vous devez utiliser le format suivant dans la barre de recherche : <KEY>:<VALUE>. Indiquez par exemple @test.status:failed. Pour effectuer une recherche avancée, consultez la section Rechercher et gérer des tests CI.

La vue CI Visibility Explorer affiche vos exécutions de pipeline de CI.

Pour filtrer des exécutions de pipeline en fonctions de tags, utilisez la barre de recherche ou les cases de facettes. Vous devez utiliser le format suivant dans la barre de recherche : <KEY>:<VALUE>. Indiquez par exemple @ci.provider.name:gitlab. Pour effectuer une recherche avancée, consultez la section Rechercher des lots de tests.