Uso de expresiones de filtro

Use expresiones de filtro para ver un mapa de rastreo o los rastros de una solicitud, servicio, conexión entre dos servicios específicos (un borde) o solicitudes que cumplan una condición. X-Ray proporciona un lenguaje de expresiones de filtro para filtrar solicitudes, servicios y periferias teniendo en cuenta los datos presentes en los encabezados de la solicitud, el estado de la respuesta y los campos indexados en los segmentos originales.

Al elegir un periodo de tiempo de registros de seguimiento para ver en la consola de X-Ray, puede obtener más resultados que los que la consola puede mostrar. En la esquina superior derecha, la consola muestra el número de registros de seguimiento que analiza y si hay más registros de seguimiento disponibles. Puede utilizar una expresión de filtro para reducir el número de resultados a tan solo los rastros que desea encontrar.

Detalles de expresión de filtro

Al elegir un nodo en el mapa de rastreo, la consola crea una expresión de filtro en función del nombre del servicio del nodo y de los tipos de error presentes en función de la selección. Para encontrar registros de seguimiento que muestren problemas de rendimiento o relacionados con solicitudes específicas, puede ajustar la expresión proporcionada por la consola, o bien crear la suya propia. Si añade anotaciones con el X-RaySDK, también puede filtrar en función de la presencia de una clave de anotación o del valor de una clave.

Si sigue habiendo más resultados disponibles de los que la consola puede mostrar, la consola muestra cuántos registros de seguimiento han coincidido y el número de registros de seguimiento analizados. El porcentaje que se muestra es el porcentaje del marco temporal seleccionado que se analizó. Para asegurarse de ver todos los registros de seguimiento coincidentes representados en los resultados, filtre aún más la expresión de filtro o seleccione un marco temporal más corto.

Para obtener los resultados más recientes en primer lugar, la consola comienza a analizar al final del intervalo de tiempo y va hacia atrás. Si hay un gran número de registros de seguimiento, pero pocos resultados, la consola divide el intervalo de tiempo en porciones y las analiza en paralelo. La barra de progreso muestra las partes del intervalo de tiempo que se han analizado.

Uso de expresiones de filtro con grupos

Los grupos son una colección de registros de seguimiento que se definen mediante una expresión de filtro. Puedes usar grupos para generar gráficos de servicios adicionales y proporcionar CloudWatch métricas de Amazon.

Los grupos se identifican por su nombre o por un nombre de recurso de Amazon (ARN) y contienen una expresión de filtro. El servicio compara los registros de seguimiento de entrada con la expresión y los almacena en consecuencia.

Puede crear y modificar grupos mediante el menú desplegable situado a la izquierda de la barra de búsqueda de expresiones de filtro.

Para obtener más información acerca de los grupos, consulte Configuración de grupos.

Sintaxis de expresiones de filtro

Las expresiones de filtro pueden incluir una palabra clave, un operador único o binario y un valor para la comparación.

keyword operator value

Cada tipo de palabra clave tiene sus propios operadores. Por ejemplo, responsetime es una palabra clave numérica que se puede comparar con operadores relacionados con números.

responsetime > 5

Puede combinar varias expresiones en una expresión compuesta utilizando los operadores AND u OR.

duration >= 5 AND duration <= 8

Solo se detectan problemas con las palabras clave y los operadores sencillos en el nivel de registro de seguimiento. Si se produce un error posterior, pero la aplicación lo gestiona y no se muestra al usuario, este problema no se detectará al buscar con la palabra error.

Para encontrar registros de seguimiento con problemas posteriores, use las palabras clave complejas service() y edge(). Estas palabras clave permiten aplicar un filtro de expresión a todos los nodos posteriores, a un único nodo posterior o a un límite entre dos nodos. Para obtener un mayor nivel de detalle, puede filtrar los servicios y los bordes con la función id().

Palabras clave booleanas

Los valores de palabra clave booleana son true o false. Utilícelas para encontrar registros de seguimiento que resultaron erróneos.

Los operadores booleanos encuentran aquellos segmentos en los que la clave especificada es true o false.

ok

!ok

ok = false

rootcause.fault.entity { last and name = "deserialize" }

rootcause.responsetime.entity { remote and coverage > 0.7 and name = "traces" }

rootcause.fault.service { inferred and name = traces and type = "AWS::DynamoDB" }

service("data-plane") {root = true and fault = true}

Palabras clave numéricas

Utilice palabras clave numéricas para buscar solicitudes con un tiempo de respuesta, duración o estado de respuesta específico.

http.status != 200

duration >= 5 AND duration <= 8

ok !partial duration <3

rootcause.fault.service { index > 5 }

rootcause.responsetime.entity { last and coverage > 0.8 }

Palabras clave de cadenas

Utilice cadenas de palabras clave para buscar trazas con un texto específico en los encabezados de las solicitudes o para encontrar un usuario específico. IDs

Los operadores de cadena permiten encontrar valores iguales a un texto determinado o que contienen dicho texto. Estos valores se deben escribir siempre entre comillas.

http.url CONTAINS "/api/game/"

Para probar si un registro de seguimiento incluye un campo, independientemente de su valor, compruebe si la cadena está vacía.

user CONTAINS ""

rootcause.fault.service { name = "Auth" }

rootcause.responsetime.service { last and type = "AWS::DynamoDB" }

rootcause.fault.exception { last and message = "Access Denied for account_id: 1234567890" 

Palabras clave complejas

Utilice palabras clave complejas para buscar solicitudes basadas en nombre del servicio, nombre de borde o valor de anotación. Para servicios y límites, puede especificar una expresión de filtro adicional que se aplica al servicio o al límite. Para anotaciones, puede filtrar por el valor de una anotación con una clave específica, utilizando operadores booleanos, numéricos o de cadena.

Usa la palabra clave service para buscar los rastros de las solicitudes que lleguen a un nodo determinado del mapa de rastreo.

Los operadores de palabras clave complejas buscan segmentos en los que se haya establecido o no se haya establecido la clave especificada.

Utilice la palabra clave service para buscar los rastros de las solicitudes que lleguen a un nodo determinado del mapa de rastreo.

service("api.example.com") { fault }

Puede excluir el nombre del servicio para aplicar un filtro de expresión a todos los nodos de su mapa de servicios.

service() { fault }

La palabra clave edge aplica una expresión de filtro a una conexión entre dos nodos.

edge("api.example.com", "backend.example.com") { error }

También puede utilizar el operador ! con las palabras clave service y edge para excluir un servicio o un límite de los resultados de otra expresión de filtro.

http.url BEGINSWITH "http://api.example.com/" AND http.url CONTAINS "/v2/" AND !service("api.example.com")

http.url AND responseTime > 2

Para las anotaciones, puede llamar a todos los rastros en los que esté establecido annotation[key] o utilizar los operadores de comparación que correspondan al tipo de valor.

annotation[gameid] = "817DL6VO"

annotation[age]

!annotation[age]

annotation[age] > 29

service { annotation[request.id] = "917DL6VO" }

edge { source.annotation[request.id] = "916DL6VO" }

edge { destination.annotation[request.id] = "918DL6VO" }

group.name = "high_response_time" AND user = "alice"

rootcause.json = #[{ "Services": [ { "Name": "GetWeatherData", "EntityPath": [{ "Name": "GetWeatherData" }, { "Name": "get_temperature" } ] }, { "Name": "GetTemperature", "EntityPath": [ { "Name": "GetTemperature" } ] } ] }]

función id

Cuando se proporciona un nombre de servicio a las palabras clave service o edge, se obtienen resultados de todos los nodos que tienen ese nombre. Si desea filtrar de manera más precisa, puede utilizar la función id para especificar un tipo de servicio, además de un nombre, para diferenciar los nodos con el mismo nombre.

Utilice la función account.id para especificar una cuenta concreta para el servicio cuando consulte rastros de varias cuentas de una cuenta de supervisión.

id(name: "service-name", type:"service::type", account.id:"account-ID")

Puede utilizar la función id en lugar de un nombre de servicio en los filtros service y edge.

service(id(name: "service-name", type:"service::type")) { filter }

edge(id(name: "service-one", type:"service::type"), id(name: "service-two", type:"service::type")) { filter }

Por ejemplo, AWS Lambda las funciones dan como resultado dos nodos en el mapa de rastreo: uno para la invocación de la función y otro para el servicio Lambda. Los dos nodos tienen el mismo nombre pero son de diferente tipo. Un filtro service estándar permite encontrar registros de seguimiento para ambos.

service("function-name") { error }

Utilice la función id para limitar la búsqueda a los errores de la propia función, sin incluir los errores del servicio.

service(id(name: "random-name", type: "AWS::Lambda::Function")) { error }

Si desea buscar nodos por tipo, también puede excluir el nombre por completo.

service(id(type: "AWS::Lambda::Function")) { error }

Para buscar nodos para un nodo concreto Cuenta de AWS, especifique un ID de cuenta.

service(id(account.id: "account-id"))