Filtros de seguimiento

Utiliza los filtros de seguimiento para seleccionar un conjunto de seguimiento en Stackdriver Trace. Utiliza un filtro de seguimiento de una de las siguientes maneras:

  • Como el parámetro filtro en una consulta con el método de API projects.traces.list

  • Como el parámetro Filtro de solicitud cuando utilizas la consola de Trace para ver una lista de seguimientos o crear un informe de análisis

    Ir a la consola de Trace

Sintaxis de filtro

Los filtros de seguimiento contienen una secuencia de comparaciones denominadas términos. Los seguimientos deben coincidir con todos los términos en el filtro para seleccionar. Por ejemplo, el siguiente filtro coincide con los seguimientos que tienen una latencia de un segundo o más y tienen un intervalo denominado /modules.GetNumInstances:

+span:/modules.GetNumInstances latency:1s

Todas las comparaciones de string distinguen mayúsculas de minúsculas. A continuación, se definen los términos del filtro.

root:[NAME_PREFIX]

El nombre del intervalo raíz del seguimiento debe comenzar con [NAME_PREFIX]. Por ejemplo, el siguiente filtro coincidirá con el seguimiento denominado "/_ah/background", pero no uno denominado "/_ahx/background":

root:/_ah/
+root:[NAME]

El nombre del intervalo raíz del seguimiento debe ser [NAME], exactamente. Por ejemplo:

+root:/_ah/background
[NAME_PREFIX]

Esta es la combinación de teclas para root:[NAME_PREFIX].

+[NAME]

Esta es la combinación de teclas para +root:[NAME].

span:[NAME_PREFIX]

El seguimiento debe tener al menos un intervalo cuyo nombre comience con [NAME_PREFIX]. Por ejemplo:

span:/modules.
+span:[NAME]

El seguimiento debe tener al menos un intervalo cuyo nombre sea [NAME], exactamente. Por ejemplo:

span:/modules.GetNumInstances
latency:[DURATION]

El seguimiento debe tener una latencia general mayor o igual que [DURATION]. La duración se expresa como un número entero seguido de un especificador de unidades: s para segundos, ms para milisegundos o ns para nanosegundos. Si no existe un especificador de unidades, se supone que la unidad es milisegundos. Por ejemplo, las siguientes cuatro duraciones son iguales:

 12s 12000ms 12000000ns 12000
label:[LABEL_KEY]

El seguimiento debe contener la clave de etiqueta especificada exactamente. No importa el valor de la etiqueta (si existe). Por ejemplo:

label:/http/url
[LABEL_KEY]:[VALUE_PREFIX]

El seguimiento debe contener la clave de etiqueta especificada exactamente, y el valor de la etiqueta debe comenzar con [VALUE_PREFIX]. Por ejemplo, el siguiente término coincide con los seguimientos cuya versión de App Engine comienza con "2017".

g.co/gae/app/module_version:2017
+[LABEL_KEY]:[VALUE]

El seguimiento debe contener el valor y de la clave de etiqueta especificada, exactamente. Por ejemplo:

+g.co/gae/app/module_version:201750925t173233.387410594824284458
method:[VALUE_PREFIX]

Esta es la combinación de teclas para la prueba de etiqueta, /http/method:[VALUE_PREFIX].

+method:[VALUE]

Esta es la combinación de teclas para la prueba de etiqueta, +/http/method:[VALUE].

url:[VALUE_PREFIX]

Esta es la combinación de teclas para la prueba de etiqueta, /http/url:[VALUE_PREFIX].

+url:[VALUE]

Esta es la combinación de teclas para la prueba de etiqueta, +/http/url:[VALUE].

Atributos booleanos

Si deseas especificar valores en los atributos booleanos, usa 0 para falso y 1 para verdadero. Por ejemplo:

Client:0

Caracteres especiales

Para buscar un valor que contenga el carácter de espacio en blanco o dos puntos (:), escribe el valor entre comillas dobles ("). Por ejemplo:

    label:"Notice: This value contains spaces and a colon"

Para buscar el carácter de comillas dobles o barra diagonal inversa (``) dentro de una string entre comillas, reemplaza el carácter con una barra diagonal inversa. Por ejemplo:

    label:"Notice: This value contains spaces, a colon, a \"quote\", and a backslash (\\)"

Agregar el símbolo (^) antes del término de búsqueda y después de (+) opcional restringe el término de búsqueda al intervalo raíz.

A continuación, se muestran algunos términos de búsqueda del intervalo raíz y sus equivalencias.

^label:[LABEL_KEY]
Esta es la búsqueda del intervalo raíz para label:[LABEL_KEY].
^[LABEL_KEY]:[VALUE_PREFIX]
Esta es la búsqueda del intervalo raíz para [LABEL_KEY]:[VALUE_PREFIX].
+^[LABEL_KEY]:[VALUE]
Esta es la búsqueda del intervalo raíz para +[LABEL_KEY]:[VALUE].
^method:[VALUE_PREFIX]
Esta es la búsqueda del intervalo raíz para method:[VALUE_PREFIX].
+^method:[VALUE]
Esta es la búsqueda del intervalo raíz para +method:[VALUE].
^url:[VALUE_PREFIX]
Esta es la búsqueda del intervalo raíz para url:[VALUE_PREFIX].
+^url:[VALUE]
Esta es la búsqueda del intervalo raíz para +url:[VALUE].
^span:[NAME_PREFIX]
Esto equivale a root:[NAME_PREFIX].
+^span:[NAME]
Esto equivale a +root:[NAME].

Cuando creas una consulta con términos mixtos, la búsqueda se puede personalizar aún más. Por ejemplo:

    +^url:/main /images method:200

coincidirá con los seguimientos cuyas etiquetas de intervalo raíz /http/url tengan "/main" como el valor exacto, el nombre del intervalo raíz tenga imágenes como el valor de prefijo y cualquier intervalo tenga la etiqueta /http/method configurada en 200.

Solución de problemas

Rendimiento lento

Si el filtro de seguimiento es difícil, tardará más tiempo para ejecutarse y puede agotar tiempo de espera. Para mejorar el rendimiento, simplifica el filtro.

Sin resultados

Si tu filtro no muestra ningún seguimiento, verifica las siguientes condiciones:

  • Asegúrate de que no haya espacios en el filtro, salvo los que separan las comparaciones.

  • Asegúrate de que el tamaño de la letra y la ortografía de todas las palabras en el filtro sean correctos. Por ejemplo, si no escribiste correctamente una palabra clave, como method:GET, el filtro se interpretará como label:method:GET, que no coincide con ningún seguimiento.

  • Utiliza el filtro Lista de seguimiento o el Explorador de API para probar los términos del filtro uno a la vez. Si ninguno de los términos muestra resultados, estas podrían ser las causas.

¿Te sirvió esta página? Envíanos tu opinión:

Enviar comentarios sobre…

Documentación de Stackdriver Trace