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.
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).
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).
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 :
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 :
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.
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
.
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
.
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.
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
.
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
.
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.
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
.
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.
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 :
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
Documentation, liens et articles supplémentaires utiles: