Syntaxe de recherche de CI Visibility Explorer
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érateur | Description | Exemple |
|---|
AND | Intersection : 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 |
OR | Union : un des deux termes figure dans les événements sélectionnés. | authentication OR password |
- | Exclusion : le terme suivant ne figure PAS dans l’événement (s’applique à chaque recherche individuelle de texte brut) | authentication AND -password |
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 souhaitez rechercher l’attribut git.repository.name et filtrer les résultats en fonction de la valeur Datadog/documentation, utilisez @git.repository.name:DataDog/documentation.
Lorsque vous recherchez une valeur d’attribut qui contient des caractères spéciaux, vous devez utiliser des caractères d’échappement ou des guillemets. Par exemple, pour un attribut my_attribute ayant pour valeur hello:world, recherchez @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 facette) avec cette syntaxe. La requête suivante renvoie tous les services se terminant par le texte 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 facette1. Vous pouvez ensuite utiliser des opérateurs numériques (<,>, <= ou >=) pour effectuer une recherche sur des facettes numériques.
Par exemple, pour récupérer toutes les exécutions de tests dont la durée est supérieure à une semaine, utilisez la recherche suivante : @duration:>=7days.
Vos exécutions de test et de pipeline héritent des tags des hosts et des intégrations qui les génèrent. Ils peuvent être utilisés dans une recherche ainsi que comme facettes :
test recherche la chaîne « test ».env:(prod OR test) renvoie toutes les exécutions de test ou de pipeline avec le tag env:prod ou le tag env:test.(env:prod AND -version:beta) renvoie toutes les exécutions de test ou de pipeline 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
Documentation, liens et articles supplémentaires utiles:
