Présentation

Un filtre de requête est composé de termes et d’opérateurs.

Il existe deux types de termes :

  • Un terme unique est un mot unique comme test ou hello.

  • Une séquence est un groupe de mots entre guillemets, comme hello dolly.

Pour combiner plusieurs termes dans une requête complexe, vous pouvez utiliser l’un des opérateurs booléens suivants (sensibles à la casse) :

OpérateurDescriptionExemple
ANDIntersection : les deux termes figurent dans les événements sélectionnés (si aucun opérateur n’est ajouté, AND est utilisé par défaut).authentication AND failure
ORUnion : un des deux termes figure dans les événements sélectionnés.authentication OR password
-Exclusion : le terme suivant l’opérateur ne figure PAS dans l’événement (s’applique à chaque recherche de texte brute).authentication AND -password

Rechercher des attributs et des tags

Vous n’avez pas besoin de définir une facette pour rechercher des attributs et des tags. Pour rechercher un attribut spécifique, ajoutez @ pour indiquer que vous recherchez un attribut. Les recherches d’attributs sont sensibles à la casse. Effectuez une recherche en texte libre pour obtenir des résultats non sensibles à la casse.

Par exemple, si vous êtes intéressé par l’attribut git.repository.name et que vous souhaitez utiliser la valeur Datadog/documentation pour le filtre, utilisez @git.repository.id:"github.com/Datadog/documentation".

La recherche d’une valeur d’attribut contenant des caractères spéciaux nécessite un échappement ou des guillemets doubles. Par exemple, pour un attribut my_attribute avec la valeur hello:world, utilisez ceci pour la recherche : @my_attribute:hello\:world ou @my_attribute:"hello:world".

Pour rechercher un caractère spécial ou une espace unique, utilisez le wildcard ?. Par exemple, pour un attribut my_attribute ayant pour valeur hello world, recherchez @my_attribute:hello?world.

Pour en savoir plus sur les tags, consultez la section Utiliser les tags.

Wildcards

Wildcard pour plusieurs caractères

Afin d’effectuer une recherche avec un wildcard pour plusieurs caractères, utilisez le symbole * comme illustré ci-dessous :

  • service:web* renvoie tous les messages de log dont le service commence par web.
  • web* renvoie tous les messages de log commençant par web.
  • *web renvoie tous les messages de log finissant par web.

Les wildcards peuvent être utilisés au sein de tags et d’attributs (avec ou sans facettes) avec cette syntaxe. La requête suivante renvoie tous les services se terminant par le texte mongo :

test.service:*mongo

Wildcard de recherche

Lorsque vous recherchez une valeur d’attribut ou de tag qui contient des caractères spéciaux ou qui nécessite des caractères d’échappement ou des guillemets, utilisez le wildcard ? pour renvoyer un caractère spécial ou une espace unique. Par exemple, pour rechercher un attribut my_attribute avec la valeur hello world, utilisez @my_attribute:hello?world.

Valeurs numériques

Pour rechercher un attribut numérique, commencez par l’ajouter en tant que facette. Vous pouvez ensuite utiliser les opérateurs numériques (<,>, <=, ou >=) pour effectuer une recherche dans les facettes numériques.

Par exemple, pour récupérer tous les tests dont la durée est supérieure à une semaine, utilisez : @duration:>=7days.

Tags

Vos exécutions de tests héritent des tags des hosts et des intégrations qui les génèrent. Elles peuvent être utilisées dans une recherche ainsi que comme facettes :

  • test recherche la chaîne « test ».
  • env:(prod OR test) renvoie toutes les exécutions de test avec le tag env:prod ou le tag env:test.
  • (env:prod AND -version:beta) renvoie toutes les exécutions de test avec le tag env:prod et sans le tag version:beta.

Si vos tags ne respectent pas les recommandations relatives aux tags et n’utilisent pas la syntaxe key:value, utilisez cette requête de recherche : tags:<MON_TAG>.

Pour aller plus loin