Sintaxis de búsqueda del Explorador de CI Visibility
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 pipeline
o hello
.
Una secuencia es un grupo de palabras rodeadas de 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 Y fallo |
OR | Unión: cualquiera de los dos términos está en los eventos seleccionados. | autenticación O contraseña |
- | Exclusión: el siguiente término NO figura en el evento (se aplica a cada búsqueda de texto sin formato individual). | autenticación Y contraseña |
No es obligatorio definir una faceta para buscar en atributos y etiquetas. 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 sin formato para obtener resultados que no distingan entre mayúsculas y minúsculas.
Por ejemplo, si te interesa el atributo git.repository.id
y quieres filtrar por el valor Datadog/documentation
, utiliza @git.repository.id:"github.com/Datadog/documentation"
.
Para buscar un valor de atributo que contenga caracteres especiales, escápalo con una barra invertida o utiliza comillas dobles. Por ejemplo, para un atributo my_attribute
con el valor hello:world
, realiza la búsqueda utilizando: @my_attribute:hello\:world
o @my_attribute:"hello:world"
.
Para buscar una coincidencia con un único carácter especial o espacio, utiliza el comodín ?
. Por ejemplo, para un atributo my_attribute
con los valores hello world
, realiza la búsqueda utilizando: @my_attribute:hello?world
.
Para obtener más información sobre etiquetas, consulta Uso de etiquetas.
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
.
Nota: Los comodines sólo funcionan fuera de las comillas dobles. Por ejemplo, @ci.pipeline.name:"*test*"
coincide con un pipeline cuyo nombre contiene la cadena *test*
, mientras que @ci.pipeline.name:*test*
coincide con un pipeline cuyo nombre contiene la cadena test
.
Las búsquedas con comodines funcionan dentro de etiquetas y atributos (facetados o no) con esta sintaxis.
Buscar comodín
Cuando busques un valor de atributo o etiqueta que contenga caracteres especiales o requiera caracteres de 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 todas las ejecuciones de pipelines que tengan una duración superior a una semana, utiliza: @duration:>=7days
.
Etiquetas
Tus ejecuciones de pipelines heredan las etiquetas de los hosts y las integraciones que las generan. Se pueden utilizar en las búsquedas y también como facetas:
pipeline
busca la cadena “pipeline”.env:(prod OR pipeline)
coincide con todas las ejecuciones de pipelines con la etiqueta env:prod
o la etiqueta env:pipeline
.(env:prod AND -version:beta)
coincide con todas las ejecuciones de pipelines con la etiqueta env:prod
, pero sin la etiqueta version:beta
.
Si tus etiquetas no siguen las prácticas recomendadas para etiquetas y no tienen la sintaxis key:value
, utiliza esta consulta de búsqueda: tags:<MY_TAG>
.
Referencias adicionales
Más enlaces, artículos y documentación útiles: