Sintaxis de búsqueda del Explorador de visibilidad de tests
Un filtro de consulta se compone de términos y operadores.
Existen dos tipos de términos:
Un término único es una sola palabra, como test
o hello
.
Una secuencia es un grupo de palabras delimitadas por comillas dobles, como "hello dolly"
.
Para combinar varios términos en una consulta compleja, puedes utilizar cualquiera de los siguientes operadores booleanos que distinguen entre mayúsculas y minúsculas:
Operador | Descripción | Ejemplo |
---|
AND | Intersección: ambos términos están en los eventos seleccionados (si no se añade nada, se toma AND por defecto). | autenticación AND error |
OR | Unión: cualquiera de los dos términos está en los eventos seleccionados. | autenticación OR contraseña |
- | Exclusión: el término siguiente NO figura en el evento (se aplica a cada búsqueda individual de texto sin formato). | autenticación AND -contraseña |
Buscar en atributos y etiquetas
No es obligatorio definir una faceta para buscar en atributos y etiquetas (tags). Para buscar en un atributo específico, añade @
para especificar que estás buscando en un atributo. Las búsquedas de atributos distinguen entre mayúsculas y minúsculas. Utiliza la búsqueda de texto libre para obtener resultados que no distingan entre mayúsculas y minúsculas.
Por ejemplo, si te interesa el atributo git.repository.name
y quieres filtrar por el valor Datadog/documentation
, utiliza @git.repository.id:"github.com/Datadog/documentation"
.
La búsqueda del valor de un atributo que contiene caracteres especiales requiere escapes o comillas dobles. Por ejemplo, para un atributo my_attribute
con el valor hello:world
, busca utilizando: @my_attribute:hello\:world
o @my_attribute:"hello:world"
.
Para que coincida con un único carácter especial o espacio, utiliza el comodín ?
. Por ejemplo, para un atributo my_attribute
con el valor hello world
, busca utilizando: @my_attribute:hello?world
.
Para obtener más información sobre las etiquetas, consulta Usar etiquetas (tags).
Comodines
Comodín de varios caracteres
Para realizar una búsqueda con un comodín de varios caracteres, utiliza el símbolo *
como se indica a continuación:
service:web*
coincide con cada mensaje de log que tenga un servicio que empiece con web
.web*
coincide con todos los mensajes de log que empiecen con web
.*web
coincide con todos los mensajes de log que terminan con web
.
Las búsquedas con comodines funcionan dentro de etiquetas y atributos (con o sin facetas) con esta sintaxis. Esta consulta devuelve todos los servicios que terminan con la cadena mongo
:
Buscar comodín
Cuando busques un valor de atributo o etiqueta que contenga caracteres especiales o requiera escape o comillas dobles, utiliza el comodín ?
para que coincida con un único carácter especial o espacio. Por ejemplo, para buscar un atributo my_attribute
con el valor hello world
: @my_attribute:hello?world
.
Valores numéricos
Para buscar en un atributo numérico, primero añádelo como faceta. A continuación, puedes utilizar operadores numéricos (<
, >
, <=
o >=
) para buscar en facetas numéricas.
Por ejemplo, para recuperar todos los tests que tengan una duración superior a una semana, utiliza: @duration:>=7days
.
Etiquetas
Las ejecuciones de tests heredan las etiquetas de los hosts y las integraciones que las generan. Pueden utilizarse para buscar y también como facetas:
test
busca la cadena “test”.env:(prod OR test)
coincide con todas las ejecuciones de tests que contienen la etiqueta env:prod
o la etiqueta env:test
.(env:prod AND -version:beta)
coincide con todas las ejecuciones de tests que contienen la etiqueta env:prod
y que no contienen la etiqueta version:beta
.
Si tus etiquetas no siguen las prácticas recomendadas de etiquetas y no tienen la sintaxis key:value
, utiliza esta consulta de búsqueda: tags:<MY_TAG>
.
Referencias adicionales
Additional helpful documentation, links, and articles: