Usa un AWS Management Console

Vea el mapa de rastreo de X-Ray para identificar los servicios en los que se producen errores, las conexiones con alta latencia o los rastreos de las solicitudes que no se realizaron correctamente.

Consulta del mapa de seguimiento

El mapa de rastreo es una representación visual de los datos de rastreo que generan sus aplicaciones. El mapa muestra nodos de servicios que atienden solicitudes, nodos cliente principales que representan los orígenes de las solicitudes, y nodos de servicios posteriores que representan los servicios web y los recursos utilizados porque utiliza una aplicación mientras procesa una solicitud.

El mapa de rastreo muestra una vista conectada de los rastreos en las aplicaciones basadas en eventos que utilizan Amazon SQS y Lambda. Para obtener más información, consulte la siguiente sección sobre aplicaciones basadas en eventos de Trace. El mapa de rastreo también admite el rastreo entre cuentas, que muestra los nodos de varias cuentas en un solo mapa.

Filtrar el mapa de rastreo por grupo

Mediante una expresión de filtro, puede definir los criterios por los que incluir rastros en un grupo. Para obtener más información sobre las expresiones de filtro, consulte Usar expresiones de filtro. A continuación, siga los pasos siguientes para mostrar ese grupo específico en el mapa de rastreo.

Entonces se filtrará el mapa de servicio para mostrar los rastros que coincidan con la expresión de filtro del grupo seleccionado.

Rastrea la leyenda y las opciones del mapa

El mapa de rastreo incluye una leyenda y varias opciones para personalizar la visualización del mapa.

Utilice la página Rastros de la consola de X-Ray para encontrar rastros por URL, código de respuesta u otros datos a partir del resumen de rastros. Tras seleccionar una traza de la lista de trazas, la página de detalles de la traza muestra un mapa de los nodos de servicio que están asociados a la traza seleccionada y una cronología de los segmentos de la traza.

Consulta de registros de seguimiento

Exploración de la escala de tiempo del rastro

La sección Cronología muestra una jerarquía de segmentos y subsegmentos junto a una barra horizontal que corresponde al tiempo que utilizaron para completar sus tareas. La primera entrada de la lista es el segmento, que representa todos los datos registrados por el servicio para una misma solicitud. Los subsegmentos están indentados y se enumeran a continuación del segmento. Las columnas contienen información sobre cada segmento.

Cuando utilizas un AWS SDK o un SQL cliente instrumentado para realizar llamadas a recursos externos, el SDK de X-Ray graba subsegmentos automáticamente. HTTP También puedes usar el SDK de X-Ray para grabar subsegmentos personalizados para cualquier función o bloque de código. Los subsegmentos adicionales que se graban mientras un subsegmento personalizado está abierto se convierten en elementos secundarios del subsegmento personalizado.

Consulta de detalles de segmentos

En la línea de tiempo del rastreo, elija el nombre de un segmento para ver sus detalles.

El panel de detalles del segmento muestra las pestañas Descripción general, Recursos, Anotaciones, Metadatos, Excepciones y SQL. Se aplica lo siguiente:

Consulta de detalles de subsegmentos

En la escala de tiempo del rastro, elija el nombre de un segmento para ver sus detalles:

En los subsegmentos personalizados, la pestaña Información general muestra el nombre del subsegmento, que se puede establecer de modo que especifique el área de código o la función que registra. Para obtener más información, consulte el enlace específico del idioma que aparece en la sección Cómo instrumentar la aplicación con los SDK incluidos. AWS X-Ray Generación de subsegmentos personalizados con el SDK de X-Ray para Java

La siguiente imagen muestra la pestaña Descripción general de un subsegmento personalizado. El resumen contiene el identificador del subsegmento, el identificador principal, el nombre, las horas de inicio y finalización, la duración, el estado y los errores o errores.

La pestaña Metadatos de un subsegmento personalizado contiene información en JSON formato sobre los recursos utilizados por ese subsegmento.

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.

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 SDK de X-Ray, también puede filtrar en función de la presencia de una clave de anotación o el valor de una clave.

nota

Si elige un rango de tiempo relativo en el mapa de rastreo y elige un nodo, la consola convierte el rango de tiempo en una hora absoluta de inicio y finalización. Para asegurarse de que los registros de seguimiento del nodo aparezcan en los resultados de búsqueda y evitar los tiempos de examen cuando el nodo no estaba activo, el intervalo de tiempo solo incluye las horas a las que el nodo envió registros de seguimiento. Si desea buscar con relación a la hora actual, puede volver a un intervalo de tiempo relativo en la página de registros de seguimiento y volver a analizar.

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.

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 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.

nota

Si el servicio encuentra un error al evaluar un grupo, ese grupo deja de estar incluido en el procesamiento de los registros de seguimiento de entrada y se registra una métrica de error.

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

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.

ejemplo – solicitudes con tiempo de respuesta de más de 5 segundos

responsetime > 5

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

ejemplo – solicitudes con duración total de 5 a 8 segundos

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 rastros con problemas posteriores, puedes usar las palabras clave complejas service() yedge(). 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 más información sobre estas palabras clave, consulta la siguiente sección de palabras clave complejas. Para obtener un mayor nivel de detalle, puede filtrar los servicios y los bordes con la función id(). Para obtener más información, consulta la siguiente sección sobre la función de identificación.

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

Palabras clave booleanas

• ok: el código de estado de la respuesta fue 2XX Success.

• error: el código de estado de la respuesta fue 4XX Client Error.

• throttle: el código de estado de la respuesta fue 429 Too Many Requests.

• fault: el código de estado de la respuesta fue 5XX Server Error.

• partial: la solicitud tiene segmentos incompletos.

• inferred: la solicitud tiene segmentos inferidos.

• first: el elemento es el primero de una lista enumerada.

• last: el elemento es el último de una lista enumerada.

• remote: la entidad de causa raíz es remota.

• root: la solicitud es el punto de entrada o el segmento raíz de un registro de seguimiento.

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

Operadores booleanos

• none: la expresión es verdadera si la palabra clave es verdadera.

• !: la expresión es verdadera si la palabra clave es falsa.

• =,!=: compara el valor de la palabra clave con la cadena true o false. Estos operadores actúan igual que los demás, pero son más explícitos.

ejemplo – estado de respuesta es 2XX OK

ok

ejemplo – el estado de respuesta no es 2XX OK

!ok

ejemplo – el estado de respuesta no es 2XX OK

ok = false

ejemplo – el último registro de seguimiento de error enumerado tiene el nombre de error "deserialize"

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

ejemplo – solicitudes con segmentos remotos donde la cobertura es mayor que 0.7 y el nombre del servicio es "rastros"

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

ejemplo : solicitudes con segmentos inferidos donde el tipo de servicio "AWS:DynamoDB"

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

ejemplo – solicitudes que tienen un segmento con el nombre "data-plane" como raíz.

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

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

Palabras clave numéricas

• responsetime: tiempo que tardó el servidor en enviar una respuesta.

• duration: duración total de la solicitud, incluidas las llamadas posteriores.

• http.status: código de estado de respuesta.

• index: posición de un elemento en una lista.

• coverage: porcentaje decimal del tiempo de respuesta de una entidad con respecto al tiempo de respuesta del segmento raíz. Aplicable únicamente a las entidades de causa raíz de tiempo de respuesta.

Operadores numéricos

Las palabras clave numéricas usan los operadores de comparación y de igualdad estándar.

• =,!=: la palabra clave es igual o no a un valor numérico.

• <,<=, >,>=: la palabra clave es menor o igual a un valor numérico.

ejemplo – el estado de respuesta no es 200 OK

http.status != 200

ejemplo – solicitud con duración total de 5 a 8 segundos

duration >= 5 AND duration <= 8

ejemplo – solicitudes que se completaron sin errores en menos de 3 segundos, incluidas todas las llamadas posteriores

ok !partial duration <3

ejemplo – entidad de lista enumerada que tiene un índice mayor que 5

rootcause.fault.service { index > 5 }

ejemplo : solicitudes en las que la última entidad tiene una cobertura superior a 0.8

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

Utilice palabras clave de cadena para encontrar registros de seguimiento con texto específico en los encabezados de solicitud o ID de usuario específicos.

Palabras clave de cadenas

• http.url: URL de solicitud.

• http.method: método de solicitud.

• http.useragent: cadena del agente de usuario de la solicitud.

• http.clientip: dirección IP del solicitante.

• user: valor del campo de usuario en cualquier segmento incluido en el registro de seguimiento.

• name: el nombre de un servicio o excepción.

• type: tipo de servicio.

• message: mensaje de excepción.

• availabilityzone: valor del campo availabilityzone de cualquier segmento incluido en el registro de seguimiento

• instance.id: valor del campo de ID de instancia de cualquier segmento incluido en el registro de seguimiento

• resource.arn: valor de campo ARN del recurso de cualquier segmento incluido en el registro de seguimiento

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.

Operadores de cadena

• =,!=: la palabra clave es igual o no a un valor numérico.

• CONTAINS: la palabra clave contiene una cadena concreta.

• BEGINSWITH , ENDSWITH: la palabra clave comienza o termina con una cadena concreta.

ejemplo – filtro http.url

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.

ejemplo – filtro user

Encuentre todos los registros de seguimiento con ID de usuario.

user CONTAINS ""

ejemplo – seleccione los registros de seguimiento con una causa raíz de error que incluyan el servicio denominado "Auth"

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

ejemplo – seleccione los registros de seguimiento con una causa raíz de tiempo de respuesta cuyo último servicio tenga un tipo de DynamoDB

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

ejemplo – seleccione los registros de seguimiento con una causa raíz de error cuya última excepción tenga el mensaje "access denied for account_id: 1234567890"

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

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.

Palabras clave complejas

• annotation.key: valor de anotación con campo key. Una anotación puede tener un valor booleano, numérico o de cadena, por lo que puede usar cualquiera de estos tipos de operadores de comparación. Puede utilizar esta palabra clave en combinación con la palabra clave service o edge.

• edge(source, destination) {filter}:conexión entre los servicios origen y destino. Las llaves opcionales pueden contener una expresión de filtro que se aplica a los segmentos de esta conexión.

• group.name / group.arn:l valor de la expresión de filtro de un grupo, al que se hace referencia mediante el nombre del grupo o el ARN del grupo.

• json: objeto de causa raíz JSON. Consulte Obtener datos de AWS X-Ray para ver los pasos para crear entidades JSON mediante programación.

• service(name) {filter}: servicio denominado nombre. Las llaves opcionales pueden contener una expresión de filtro que se aplica a los segmentos que creó el servicio.

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.

Operadores de palabras clave complejas

• none: la expresión es verdadera si la palabra clave está establecida. Si la palabra clave es de tipo booleano, se evaluará en función del valor booleano.

• !: la expresión es verdadera si la palabra clave no está establecida. Si la palabra clave es de tipo booleano, se evaluará en función del valor booleano.

• =,!=: compara el valor de la palabra clave.

• edge(source, destination) {filter}:conexión entre los servicios origen y destino. Las llaves opcionales pueden contener una expresión de filtro que se aplica a los segmentos de esta conexión.

• annotation.key: valor de anotación con campo key. Una anotación puede tener un valor booleano, numérico o de cadena, por lo que puede usar cualquiera de estos tipos de operadores de comparación. Puede utilizar esta palabra clave en combinación con la palabra clave service o edge.

• json: objeto de causa raíz JSON. Consulte Obtener datos de AWS X-Ray para ver los pasos para crear entidades JSON mediante programación.

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

ejemplo – filtro Service

Solicitudes que incluyen una llamada a api.example.com con un error (error de la serie 500).

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.

ejemplo – filtro service

Solicitudes que hayan provocado un error en cualquier parte del mapa de rastreo.

service() { fault }

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

ejemplo – filtro edge

Solicitud en la que el servicio api.example.com hizo una llamada a backend.example.com que resultó errónea.

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.

ejemplo – filtro service y de solicitud

Solicitud cuya URL comienza por http://api.example.com/ y contiene /v2/, pero no llega al servicio denominado api.example.com.

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

ejemplo — filtro service y de tiempo de respuesta

Busque rastros en los que esté establecido http url y el tiempo de respuesta sea superior a 2 segundos.

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.

ejemplo – anotación con un valor de cadena

Las solicitudes con una anotación denominada gameid que tiene el valor de cadena "817DL6VO".

annotation.gameid = "817DL6VO"

ejemplo – la anotación está establecida

Solicitudes que tienen establecida una anotación denominada age.

annotation.age

ejemplo – la anotación no está establecida

Solicitudes que no tienen establecida una anotación denominada age.

!annotation.age

ejemplo – anotación con un valor numérico

Solicitudes con una edad de anotación con valor numérico mayor que 29.

annotation.age > 29

ejemplo – anotación en combinación con service o edge

service { annotation.request_id = "917DL6VO" }

edge { source.annotation.request_id = "916DL6VO" }

edge { destination.annotation.request_id = "918DL6VO" }

ejemplo – grupo con usuario

Solicitudes en las que los rastros cumplan los criterios del filtro de grupo high_response_time (p. ej.responseTime > 3) y el nombre del usuario sea Alice.

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

ejemplo – JSON con entidad de causa raíz

Solicitudes con entidades de causa raíz coincidentes.

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

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.

ejemplo – filtro service

Solicitudes que incluyen un error en cualquier servicio denominado random-name.

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.

ejemplo – filtro service con la función id

Solicitudes que incluyen un error en un servicio denominado random-name de tipo AWS::Lambda::Function.

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

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

ejemplo – filtro service con la función id y tipo de servicio

Solicitudes que incluyen un error en un servicio de tipo AWS::Lambda::Function.

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

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

ejemplo – filtro service con función id e ID de cuenta

Solicitudes que incluyen un servicio dentro de un identificador de cuenta específico AWS::Lambda::Function.

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

AWS X-Ray admite la observabilidad entre cuentas, lo que le permite monitorear y solucionar problemas de las aplicaciones que abarcan varias cuentas dentro de una. Región de AWS Puede buscar, visualizar y analizar sin problemas sus métricas, registros y rastros en cualquiera de las cuentas vinculadas, como si estuviera operando en una sola cuenta. Eso le proporciona una vista completa de las solicitudes que se transfieren a varias cuentas. Puede ver los rastreos entre cuentas en el mapa de rastreo de X-Ray y en las páginas de rastreo de la CloudWatchconsola.

Los datos de observabilidad compartidos pueden incluir cualquiera de los siguientes tipos de telemetría:

Configuración de la observabilidad entre cuentas

Para activar la observabilidad entre cuentas, configure una o más cuentas de supervisión de AWS y vincúlelas a varias cuentas de origen. Una cuenta de monitoreo es una central Cuenta de AWS que puede ver e interactuar con los datos de observabilidad que se generan a partir de las cuentas de origen. Una cuenta de origen es una persona Cuenta de AWS que genera datos de observabilidad para los recursos que contiene.

Las cuentas de origen comparten sus datos de observabilidad con cuentas de supervisión. Los rastros de cada cuenta de origen se copian en un máximo de cinco cuentas de supervisión. Las copias de los rastros de las cuentas de origen en la primera cuenta de supervisión son gratuitas. Las copias de rastros enviadas a cuentas de supervisión adicionales se cargan a cada cuenta de origen, según el precio estándar. Para obtener más información, consulta AWS X-Ray los precios y los CloudWatch precios de Amazon.

Para crear enlaces entre las cuentas de monitoreo y las cuentas de origen, usa la CloudWatch consola o los nuevos comandos de Observability Access Manager en la API AWS CLI y. Para obtener más información, consulta la observabilidad CloudWatch entre cuentas.

Visualización de rastros entre cuentas

Los rastros entre cuentas se muestran en la cuenta de supervisión. Cada cuenta de origen muestra solo los rastros locales de esa cuenta específica. En las siguientes secciones se presupone que has iniciado sesión en la cuenta de monitorización y has abierto la CloudWatch consola de Amazon. Tanto en el mapa de rastreo como en la página de rastreo, aparece una insignia de cuenta de monitoreo en la esquina superior derecha.

Mapa de rastreo

En la CloudWatch consola, elija Trace Map en Rastros de X-Ray en el panel de navegación izquierdo. De forma predeterminada, el mapa de rastreo muestra los nodos de todas las cuentas de origen que envían rastreos a la cuenta de monitoreo y los nodos de la propia cuenta de monitoreo. En el mapa de rastreo, elija Filtros en la esquina superior izquierda para filtrar el mapa de rastreo mediante el menú desplegable Cuentas. Una vez que se aplica un filtro de cuenta, los nodos de servicio de las cuentas que no coincidan con el filtro actual aparecen en color gris.

Al elegir un nodo de servicio, el panel de detalles del nodo incluye el identificador de cuenta y la etiqueta del servicio.

En la esquina superior derecha del mapa de rastreo, elija Vista de lista para ver una lista de los nodos de servicio. La lista de nodos de servicio incluye los servicios de la cuenta de supervisión y todas las cuentas de origen configuradas. Filtre la lista de nodos por Etiqueta de cuenta o por ID de cuenta seleccionándolos en el filtro de Nodos.

Rastros

Para ver los detalles de rastreo que abarcan varias cuentas, abra la CloudWatch consola desde la cuenta de monitoreo y elija Rastros en Rastros de X-Ray en el panel de navegación izquierdo. También puede abrir esta página seleccionando un nodo en el Mapa de rastreo de rayos X y, a continuación, seleccionando Ver trazos en el panel de detalles del nodo.

La página Rastros permite realizar consultas por ID de cuenta. Para empezar, introduzca una consulta que incluya uno o más ID de cuenta. Para obtener más información sobre las consultas, consulteUtilice expresiones de filtro. En el siguiente ejemplo se consultan rastros que hayan pasado por el ID de cuenta X o Y:

service(id(account.id:"X")) OR service(id(account.id:"Y"))

Acote su consulta por Cuenta. Seleccione una o más cuentas de la lista y elija Añadir a la consulta.

Detalles de rastros

Para ver los detalles de una rastro, selecciónelo en la lista Rastros situada en la parte inferior de la página de Rastros. Se muestran los detalles del rastreo, incluido un mapa de detalles del rastreo con los nodos de servicio de todas las cuentas por las que ha pasado el rastreo. Elija un nodo de servicio específico para ver su cuenta correspondiente.

La sección Escala de tiempo de los segmentos muestra los detalles de la cuenta de cada segmento en la escala de tiempo.

AWS X-Ray admite el seguimiento de aplicaciones basadas en eventos mediante Amazon SQS y. AWS Lambda Utilice la CloudWatch consola para ver una vista conectada de cada solicitud mientras está en cola con Amazon SQS y procesada por una o más funciones de Lambda. Las trazas de los productores de mensajes ascendentes se vinculan automáticamente a las trazas de los nodos consumidores de Lambda descendentes, lo que crea una end-to-end vista de la aplicación.

Vea las trazas enlazadas en el mapa de trazas

Utilice la página Mapa de rastreo de la CloudWatchconsola para ver un mapa de rastreo con los rastros de los productores de mensajes que están vinculados a los rastros de los consumidores de Lambda. Estos vínculos se muestran con un borde discontinuo que conecta el nodo de Amazon SQS y los nodos de consumidores de Lambda posteriores.

Seleccione un borde discontinuo para mostrar un histograma de antigüedad del evento recibido, que correlaciona la distribución de la antigüedad del evento cuando lo reciben los consumidores. La antigüedad se calcula cada vez que se recibe un evento.

Visualización de detalles de rastro vinculados

El mapa de detalles de la traza muestra la traza actual, junto con las trazas enlazadas en sentido ascendente y descendente, cada una de las cuales se encuentra dentro de un recuadro que indica los límites de cada traza. Si el rastro actualmente seleccionado está vinculado a varios rastros precedentes o posteriores, los nodos que están dentro de los rastros vinculados precedentes o posteriores se apilan y aparece el botón Seleccionar rastro.

Debajo del mapa de detalles de la traza, se muestra una cronología de los segmentos de la traza, que incluye las trazas enlazadas aguas arriba y aguas abajo. Si hay varios rastros precedentes y posteriores vinculados, no se pueden mostrar los detalles de sus segmentos. Para ver los detalles de los segmentos de una sola traza dentro de un conjunto de trazas enlazadas, seleccione una sola traza como se describe en la siguiente sección.

Selección de un solo rastro dentro de un conjunto de rastros vinculados

Al seleccionar un nodo o una arista en un mapa de rastreo, la consola de X-Ray muestra un histograma de distribución de latencia.

Latencia

La latencia es el tiempo que transcurre entre el momento de iniciar una solicitud y el momento de completarla. Los histogramas muestran una distribución de las latencias. Muestran la duración en el eje x y el porcentaje de solicitudes de cada duración en el eje y.

Este histograma muestra un servicio que completa la mayor parte de las solicitudes en menos de 300 ms. Un pequeño porcentaje de solicitudes tarda hasta 2 segundos y unos cuantos casos atípicos tardan más tiempo.

Interpretación de los detalles del servicio

Los histogramas de servicio y los histogramas de límites constituyen una representación visual de latencia desde el punto de vista de un servicio o de un solicitante.

Para interpretar el panel de histograma Service details, puede buscar los valores que más difieran de la mayoría de valores del histograma. Estos valores atípicos pueden aparecer como picos o puntas en el histograma y puede analizar los rastros de un área específica para averiguar lo que sucede.

Para ver los rastros filtrados por latencia, seleccione un intervalo en la histograma. Haga clic donde desee iniciar la selección y arrastre de izquierda a derecha para resaltar el intervalo de latencias que quiera incluir en el filtro de rastros.

Una vez seleccionado el intervalo, puede elegir Zoom (Zoom) para ver solo esa parte del histograma y retocar la selección.

Una vez establecido el enfoque en el área que desea, elija View traces (Ver rastros).

AWS X-Ray analiza continuamente los datos de rastreo de su cuenta para identificar problemas emergentes en sus aplicaciones. Cuando las tasas de fallo superan el rango esperado, se crea una información que registra el problema y hace un seguimiento de su impacto hasta que se resuelve. Con Insights, puede:

La consola de X-Ray identifica los nodos con incidentes en curso en el mapa de rastreo. Para ver un resumen de la información, elija el nodo afectado. También puede ver y filtrar Insights seleccionando Insights en el panel de navegación de la izquierda.

X-Ray crea información cuando detecta una anomalía en uno o más nodos del mapa de servicio. El servicio utiliza modelos estadísticos para predecir las tasas de fallo que cabe esperar de los servicios de su aplicación. En el ejemplo anterior, la anomalía es un aumento de los errores de AWS Elastic Beanstalk. El servidor de Elastic Beanstalk agotó varias veces los tiempos de espera de llamadas a la API, lo que provocó una anomalía en los nodos posteriores.

Habilite Insights en la consola X-Ray

La información debe estar habilitada para cada grupo con el que desee utilizar las características de información. Puede activar la información desde la página Grupos.

          {
             "Version": "2012-10-17",
             "Statement": [
                 {
                     "Effect": "Allow",
                     "Action": [
                         "xray:GetInsightSummaries",
                         "xray:GetInsight",
                         "xray:GetInsightEvents",
                         "xray:GetInsightImpactGraph"
                     ],
                     "Resource": [
                         "*"
                     ]
                 }
             ]
         }
      

Habilitación de notificaciones de la información

Con las notificaciones de información, se crea una notificación para cada evento de información, por ejemplo, cuando se crea una información, cambia significativamente o se cierra. Los clientes pueden recibir estas notificaciones a través de EventBridge eventos de Amazon y usar reglas condicionales para realizar acciones como la notificación de SNS, la invocación de Lambda, la publicación de mensajes en una cola de SQS o cualquiera de las opciones admitidas por Target. EventBridge Las notificaciones de información se emiten en la medida de lo posible, pero no están garantizadas. Para obtener más información sobre los objetivos, consulte Amazon EventBridge Targets.

En la página Grupos puede habilitar las notificaciones de información para cualquier grupo que tenga información habilitada.

Visión general acerca de la información

En la página de información general de una información se intenta responder a tres preguntas clave:

La sección Servicios anómalos muestra una escala de tiempo para cada servicio que ilustra el cambio en las tasas de fallo durante el incidente. La escala de tiempo muestra el número de rastros con fallos superpuestos en una banda continua que indica el número esperado de fallos en función de la cantidad de tráfico registrada. La duración de la información se visualiza en la ventana de incidentes. La ventana de incidentes comienza cuando X-Ray observa que la métrica se vuelve anómala y persiste mientras la información está activa.

En el siguiente ejemplo se muestra un aumento en el número de fallos, lo que ha provocado un incidente:

La sección de causa raíz muestra un mapa de rastreo centrado en la causa raíz del servicio y la ruta afectada. Puede ocultar los nodos no afectados seleccionando el icono en forma de ojo en la parte superior derecha del mapa de la causa raíz. El servicio de causa raíz es el nodo posterior más alejado en el que X-Ray identificó una anomalía. Puede representar un servicio que usted instrumentó o un servicio externo al que su servicio llamó con un cliente instrumentado. Por ejemplo, si llama a Amazon DynamoDB con un cliente de SDK AWS instrumentado, si aumenta el número de errores de DynamoDB, se obtiene una idea de que DynamoDB es la causa principal.

Para investigar más a fondo la causa raíz, seleccione Ver los detalles de la causa raíz en el gráfico de la causa raíz. Puede usar la página Análisis para investigar la causa raíz y los mensajes relacionados con ella. Para obtener más información, consulte Interactúe con la consola de Analytics.

Los fallos que continúan hacia arriba en el mapa pueden afectar a varios nodos y provocar múltiples anomalías. Si un fallo se transfiere hasta el usuario que realizó la solicitud, el resultado es un fallo de cliente. Se trata de un error en el nodo raíz del mapa de rastreo. El gráfico Impacto proporciona una escala de tiempo de la experiencia del cliente para todo el grupo. Esta experiencia se calcula en función de los porcentajes de los siguientes estados: fallo, error, limitación y bien.

En este ejemplo se muestra un aumento en el número de rastros con un fallo en el nodo raíz durante el momento de un incidente. Los incidentes en los servicios posteriores no siempre se corresponden con un aumento de los errores de cliente.

Al elegir Analizar información, se abre la consola de X-Ray Analytics en una ventana en la que se puede profundizar en el conjunto de rastros que han generado la información. Para obtener más información, consulte Interactúe con la consola de Analytics.

Descripción del impacto

AWS X-Ray mide el impacto causado por un problema continuo como parte de la generación de información y notificaciones. El impacto se mide de dos formas:

Este impacto viene determinado por el porcentaje de solicitudes que fallan o que provocan un error en un período de tiempo determinado. Este análisis de impacto le permite determinar la gravedad y la prioridad del problema en función de su situación particular. Este impacto está disponible como parte de la experiencia con la consola, además de las notificaciones de información.

Desduplicación

AWS X-Ray insights desduplica los problemas en varios microservicios. Utiliza la detección de anomalías para determinar el servicio que es la causa principal de un problema, determina si otros servicios relacionados con él presentan un comportamiento anómalo debido a la misma causa raíz y registra el resultado como una sola información.

Revisión del progreso de una información

X-Ray vuelve a evaluar la información periódicamente hasta que se resuelve y registra cada cambio intermedio notable como una notificación, que se puede enviar como un evento de Amazon EventBridge . Esto le permite crear procesos y flujos de trabajo para determinar cómo ha cambiado el problema a lo largo del tiempo y tomar las medidas adecuadas, como enviar un correo electrónico o integrarlos en un sistema de alertas mediante. EventBridge

Puede revisar los eventos de los incidentes en Plazo del impacto, en la página Inspeccionar. De forma predeterminada, la escala de tiempo muestra el servicio más afectado hasta que el usuario elige un servicio diferente.

Para ver un mapa de rastreo y gráficos de un evento, elíjalo en la cronología del impacto. El mapa de rastreo muestra los servicios de su aplicación que se ven afectados por el incidente. En Análisis del impacto, los gráficos muestran las líneas de tiempo de los fallos correspondientes al nodo seleccionado y los clientes del grupo.

Para analizar en profundidad los rastros implicados en un incidente, elija Analizar evento en la página Inspeccionar. Puede utilizar la página Análisis para acotar la lista de rastros e identificar a los usuarios afectados. Para obtener más información, consulte Interactúe con la consola de Analytics.

La consola de AWS X-Ray Analytics es una herramienta interactiva para interpretar los datos de rastreo y comprender rápidamente el rendimiento de su aplicación y sus servicios subyacentes. La consola le permite explorar, analizar y visualizar los registros de seguimiento a través de gráficos de tiempo de respuesta y series temporales.

Al realizar selecciones en la consola de Analytics, la consola crea filtros para reflejar el subconjunto seleccionado de registros de seguimiento. Puede acotar el conjunto de datos con filtros cada vez más detallados haciendo clic en los gráficos y los paneles de métricas y campos asociados al conjunto de registros de seguimiento actual.

La consola de X-Ray Analytics utiliza las siguientes características principales para agrupar, filtrar, comparar y cuantificar los datos de rastro.

Características

Característica	Descripción
Grupos	El grupo seleccionado inicial es Default. Para cambiar el grupo recuperado, seleccione un grupo diferente en el menú que se encuentra a la derecha de la barra de búsqueda principal de expresiones de filtro. Para obtener más información sobre los grupos, consulte Configurar grupos.
Retrieved traces (Registros de seguimiento recuperados)	De forma predeterminada, la consola de Analytics genera gráficos basados en todos los registros de seguimiento del grupo seleccionado. Los registros de seguimiento recuperados representan todos los registros de seguimiento del conjunto de trabajo. Puede ver el número de registros de seguimiento en este icono. Las expresiones de filtro que se aplican a la barra de búsqueda principal acotan y actualizan los registros de seguimiento recuperados.
Show in charts/Hide from charts (Mostrar y ocultar de gráficos)	Un control de alternancia para comparar el grupo activo con los registros de seguimiento recuperados. Para comparar los datos relativos al grupo con los filtros activos, elija Show in charts (Mostrar en gráficos). Para eliminar esta vista de los gráficos, elija Hide from charts (Ocultar de gráficos).
Filtered trace set A (Conjunto de registros de seguimiento filtrados A)	A través de interacciones con los gráficos y las tablas, aplique filtros para crear los criterios del conjunto de rastros filtrados A. Cuando se aplican los filtros, el número de rastros aplicables y el porcentaje de rastros que se recupera se calculan en este icono. Los filtros se rellenan como etiquetas dentro del icono Filtered trace set A (Conjunto de registros de seguimiento A filtrados) y también se pueden eliminar del icono.
Refine (Acotar)	Esta función actualiza el conjunto de registros de seguimiento recuperados en función de los filtros aplicados al conjunto de registros de seguimiento A. Al reajustar el conjunto de registros de seguimiento recuperado se actualiza el conjunto de trabajo de todos los registros de seguimiento recuperados en función de los filtros del conjunto de registros de seguimiento A. El conjunto de trabajo de registros de seguimiento recuperados es un subconjunto muestreado de todos los registros de seguimiento del grupo.
Filtered trace set B (Conjunto de registros de seguimiento filtrados B)	Cuando se crea, el conjunto de rastros filtrados B es una copia del conjunto de rastros filtrados A. Para comparar los dos conjuntos de rastros, seleccione nuevos filtros, que se aplicarán al conjunto de rastros B, mientras que el conjunto A permanece fijo. Cuando se aplican los filtros, se calcula el número de registros de seguimiento aplicables y el porcentaje de registros de seguimiento del total recuperado en este icono. Los filtros se rellenan como etiquetas dentro del icono Filtered trace set B (Conjunto de registros de seguimiento B) y también se pueden eliminar del icono.
Response Time Root Cause Entity Paths (Rutas de entidad de causa raíz de tiempo de respuesta)	Una tabla de rutas de entidad registradas. X-ray determina qué ruta del rastro del usuario es la causa más probable del tiempo de respuesta. El formato indica una jerarquía de entidades detectadas, que termina en una causa raíz de tiempo de respuesta. Utilice estas filas para filtrar errores de tiempo de respuesta recurrentes. Para obtener más información sobre la personalización de un filtro de causa raíz y la obtención de datos a través de la API, consulte la sección Recuperación y perfeccionamiento del análisis de la causa raíz en. Obtención de datos de X-Ray
Delta (�)	Una columna que se agrega a las tablas de métricas cuando los conjuntos de registros de seguimiento A y B están activos. La columna Delta calcula la diferencia porcentual de los registros de seguimiento entre el conjunto de registros de seguimiento A y el conjunto de registros de seguimiento B.

La consola de X-Ray Analytics genera dos gráficos principales que ayudan al usuario a visualizar rastros: Distribución del tiempo de respuesta y Actividad de series temporales. En esta sección y las siguientes se proporcionan ejemplos de cada uno y se explican los aspectos básicos de cómo leer los gráficos.

A continuación se indican los colores asociados al gráfico de líneas de tiempo de respuesta (el gráfico de series temporales utiliza la misma combinación de colores):

• Todos los rastros del grupo: gris

• Rastros recuperados: naranja

• Conjunto de rastros filtrados A: verde

• Conjunto de rastros filtrados B: azul

ejemplo – Distribución del tiempo de respuesta

La distribución del tiempo de respuesta es un gráfico que muestra el número de registros de seguimiento con un tiempo de respuesta determinado. Haga clic y arrastre para realizar selecciones en la distribución del tiempo de respuesta. De esta forma, se selecciona y se crea un filtro del conjunto de registros de seguimiento de trabajo llamado responseTime para todos los registros de seguimiento de un tiempo de respuesta específico.

El gráfico de actividad de series temporales muestra el número de registros de seguimiento en un periodo de tiempo determinado. Los indicadores de color reflejan los colores del gráfico de líneas de la distribución del tiempo de respuesta. Cuanto más oscuro y opaco es el bloque de color de las series de actividad, más registros de seguimiento se representan en el momento especificado.

ejemplo – Actividad de series temporales

Haga clic y arrastre para realizar selecciones dentro del gráfico de actividad de series temporales. De esta forma, se selecciona y se crea un filtro llamado timerange en el conjunto de registros de seguimiento de trabajo para todos los registros de seguimiento en un periodo de tiempo específico.

Los siguientes ejemplos muestran casos de uso comunes de la consola de X-Ray Analytics. Cada ejemplo muestra una función clave de la experiencia de la consola. En su conjunto, los ejemplos siguen un flujo de trabajo de solución de problemas básico. Los pasos describen cómo detectar primero los nodos en mal estado y, a continuación, cómo interactuar con la consola de Analytics para generar automáticamente consultas comparativas. Una vez que haya reducido el alcance a través de las consultas, verá los detalles de los registros de seguimiento de interés para determinar qué está dañando el estado del servicio.

El mapa de rastreo indica el estado de cada nodo coloreándolo en función de la proporción entre llamadas correctas y errores y fallas. Cuando vea un porcentaje en rojo en el nodo, eso indica un error. Utilice la consola de X-Ray Analytics para investigar el problema.

Para obtener más información sobre cómo leer el mapa de rastreo, consulte Usar el mapa de rastreo de X-Ray.

Mediante la distribución del tiempo de respuesta, puede observar los picos de tiempo de respuesta. Al seleccionar el pico en el tiempo de respuesta, las tablas que se encuentran debajo de los gráficos se actualizarán para mostrar las métricas asociadas, como los códigos de estado.

Al hacer clic y arrastrar, X-Ray selecciona y crea un filtro. Se muestra sombreado en gris encima de las líneas gráficas. Ahora puede arrastrar ese elemento resaltado a la izquierda o a la derecha por la distribución para actualizar su selección y filtro.

Puede analizar los registros de seguimiento dentro del pico seleccionado mediante las tablas de métricas que se encuentran debajo de los gráficos. Al hacer clic en una fila de la tabla HTTP STATUS CODE, se crea automáticamente un filtro en el conjunto de datos de trabajo. Por ejemplo, puede ver todos los registros de seguimiento de código de estado 500. Esto crea una etiqueta de filtro en el icono del conjunto de registros de seguimiento llamado http.status.

Examine el conjunto de errores en función del usuario, URL, causa raíz del tiempo de respuesta u otros atributos predefinidos. Por ejemplo, para filtrar más el conjunto de registros de seguimiento con un código de estado 500, seleccione una fila de la tabla USERS. Se obtienen dos etiquetas de filtro en el icono del conjunto de registros de seguimiento: http.status, tal y como se designó anteriormente, y user.

Compare varios usuarios y sus solicitudes POST para encontrar otras discrepancias y correlaciones. Aplique su primer conjunto de filtros. Estos filtros se definen por una línea azul en la distribución del tiempo de respuesta. A continuación, seleccione Compare (Comparar). Inicialmente, esto crea una copia de los filtros del conjunto de registros de seguimiento A.

Para continuar, defina un nuevo conjunto de filtros que se aplique al conjunto de registros de seguimiento B. Este segundo conjunto se representa mediante una línea verde. En el siguiente ejemplo se muestran diferentes líneas en función de la combinación de colores azul y verde.

Cuando reduzca el alcance mediante los filtros de la consola, la lista de registros de seguimiento de debajo de las tablas de métricas le resultará más útil. La tabla de lista de registros de seguimiento combina información de URL, USER (USUARIO) y STATUS CODE (CÓDIGO DE ESTADO) en una sola consulta. Para obtener más información, seleccione una fila de esta tabla para abrir la página de detalles del registro de seguimiento y ver su escala de tiempo y sus datos sin procesar.

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. Puede usar la consola de AWS X-Ray o la API de X-Ray con el fin de crear y administrar grupos para sus servicios. En este tema se describe cómo crear y administrar grupos con la consola de X-Ray. Para obtener información sobre cómo administrar grupos con la API de X-Ray, consulte Configuración de los ajustes de muestreo, grupos y cifrado con la API X-Ray.

Puedes crear grupos de trazas para mapas de trazas, trazas o análisis. Al crear un grupo, el grupo pasa a estar disponible como filtro en el menú desplegable del grupo en las tres páginas: Trace Map, Traces y Analytics.

Los grupos se identifican por su nombre o 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. Para obtener más información acerca de cómo crear una expresión de filtro, consulte Utilice expresiones de filtro.

La actualización de la expresión de filtro de un grupo no cambia los datos que ya se han registrado. La actualización se aplica únicamente a los rastros posteriores. Esto puede dar lugar a un gráfico que combina la expresión nueva con la anterior. Para evitarlo, elimine el grupo actual y cree uno nuevo.

Creación de un grupo

Aplicar un grupo

Editar un grupo

Clonación de un grupo

Al clonar un grupo, se crea un grupo nuevo que tiene la expresión de filtro y las etiquetas de un grupo existente. Cuando clona un grupo, el grupo nuevo tiene el mismo nombre que el grupo desde el que lo clone, con -clone anexado al nombre.

Eliminación de un grupo

Siga los pasos de esta sección para eliminar un grupo. No se puede eliminar el grupo Predeterminado.

Ver las métricas de los grupos en Amazon CloudWatch

Una vez que se crea un grupo, los rastros de entrada se comparan con la expresión de filtro del grupo a medida que se almacenan en el servicio de X-Ray. Las métricas del número de trazas que coinciden con cada criterio se publican en Amazon CloudWatch cada minuto. Al seleccionar Ver métrica en la página Editar grupo, se abre la CloudWatch consola a la página Métrica. Para obtener más información sobre cómo usar CloudWatch las métricas, consulta Uso de Amazon CloudWatch Metrics en la Guía del CloudWatch usuario de Amazon.

Puede usar la AWS X-Ray consola para configurar las reglas de muestreo para sus servicios. El SDK de X-Ray y los Servicios de AWS que admiten el rastreo activo con configuración de muestreo utilizan reglas de muestreo para determinar qué solicitudes se deben registrar.

Configure las reglas de muestreo

Puede configurar el muestreo para los siguientes casos de uso:

Personalización de reglas de muestreo

Al personalizar las reglas de muestreo, puede controlar la cantidad de datos que va a registrar. También puede modificar el comportamiento del muestreo sin modificar ni volver a implementar el código. Las reglas de muestreo indican al SDK de X-Ray cuántas solicitudes se van a registrar para un conjunto de criterios. De forma predeterminada, el SDK de X-Ray registra la primera solicitud recibida al principio de cada segundo y el cinco por ciento de las solicitudes adicionales. Una petición por segundo es el depósito. Esto garantiza que se registre al menos un registro de seguimiento cada segundo mientras el servicio atienda solicitudes. El cinco por ciento es el porcentaje al que se muestrean las solicitudes adicionales más allá del tamaño del depósito.

Puede configurar el SDK de X-Ray para leer reglas de muestreo desde un documento JSON que incluya con su código. Sin embargo, cuando ejecute varias instancias de su servicio, cada instancia realiza el muestreo de manera independiente. Esto hace que el porcentaje total de solicitudes muestreadas aumente, ya que los depósitos de todas las instancias se suman de forma efectiva. Además, para actualizar las reglas de muestreo locales, tiene que volver a implementar su código.

Al definir las reglas de muestreo en la consola de X-Ray y configurar el SDK para leer reglas desde el servicio de X-Ray, puede evitar ambos problemas. El servicio administra el depósito de cada regla y asigna cuotas a cada instancia de su servicio para distribuir el depósito de manera uniforme, en función del número de instancias que se ejecuten. El límite del depósito se calcula de acuerdo con las reglas que haya establecido. Dado que las reglas están configuradas en el servicio, puede administrar las reglas sin realizar implementaciones adicionales. Para obtener más información sobre el AWS SDK, consulta Cómo usar un SDK.

Ahora puede configurar las reglas de muestreo de X-Ray desde la CloudWatch consola de Amazon. También puede seguir utilizando la consola de X-Ray.

Opciones de reglas de muestreo

Las siguientes opciones están disponibles para cada regla. En los valores de cadena se pueden usar caracteres comodín para buscar coincidencias de un solo carácter (?) o cero o más caracteres (*).

Ejemplos de reglas de muestreo

Configure su servicio para usar reglas de muestreo

El SDK de X-Ray requiere configuración adicional para utilizar reglas de muestreo que configura en la consola. Consulte el tema de configuración para su lenguaje para obtener más información sobre cómo configurar una estrategia de muestreo.

Para API Gateway, consulte: Soporte de rastreo activo de Amazon API Gateway para AWS X-Ray.

Visualización de resultados de muestreo

La página de Muestreo de la consola de X-Ray muestra información detallada sobre cómo los servicios del usuario utilizan cada regla de muestreo.

La columna Trend (Tendencia) muestra cómo se ha utilizado la regla en los últimos minutos. Cada columna muestra las estadísticas para una ventana de 10 segundos.

Para obtener más información acerca de cómo utilizar las estadísticas de muestreo y cómo utilizan las reglas de muestreo los servicios, consulte Using sampling rules with the X-Ray API (Uso de reglas de muestreo con la API de X-Ray).

Siguientes pasos

Puede usar la API de X-Ray para administrar reglas de muestreo. Con la API, puede crear y actualizar las reglas mediante programación de forma programada o en respuesta a alarmas o notificaciones. Consulte Configuración de los ajustes de muestreo, grupos y cifrado con la API X-Ray para obtener instrucciones y ejemplos de reglas adicionales.

El SDK de X-Ray y Servicios de AWS también utilizan la API de X-Ray para leer las reglas de muestreo, informar los resultados del muestreo y obtener los objetivos de muestreo. Los servicios deben realizar un seguimiento de la frecuencia con la que se aplica cada regla, evaluar las reglas en función de la prioridad y tomar prestado del depósito cuando una solicitud coincide con una regla para la que X-Ray no ha asignado aún una cuota al servicio. Para obtener más información sobre cómo un servicio utiliza la API para el muestreo, consulteUsing sampling rules with the X-Ray API (Uso de reglas de muestreo con la API de X-Ray).

Cuando el SDK de X-Ray llama a las API de muestreo, utiliza el daemon de X-Ray como proxy. Si ya utiliza el puerto de TCP 2000, puede configurar el demonio para ejecutar el proxy en un puerto diferente. Para obtener más información, consulte Configuración del AWS X-Ray daemon.

Puedes usar rutas y consultas para establecer vínculos profundos con trazas específicas o vistas filtradas de las trazas y el mapa de trazas.

Rastros

Puede generar enlaces a las vistas de escala de tiempo, sin procesar y mapa de los rastros individuales.

Escala de tiempo de rastros: xray/home#/traces/trace-id

Datos de rastro sin procesar: xray/home#/traces/trace-id/raw

https://console.aws.amazon.com/xray/home#/traces/1-57f5498f-d91047849216d0f2ea3b6442/raw

Expresiones de filtro

Enlazan con una lista filtrada de rastros.

Vista de rastros filtrados: xray/home#/traces?filter=filter-expression

https://console.aws.amazon.com/xray/home#/traces?filter=service("api.amazon.com") { fault = true OR responsetime > 2.5 } AND annotation.foo = "bar"

https://console.aws.amazon.com/xray/home#/traces?filter=service(%22api.amazon.com%22)%20%7B%20fault%20%3D%20true%20OR%20responsetime%20%3E%202.5%20%7D%20AND%20annotation.foo%20%3D%20%22bar%22

Para obtener más información sobre las expresiones de filtro, consulte Utilice expresiones de filtro.

Intervalo de tiempo

Especifique un intervalo de tiempo o una hora de inicio y una hora de finalización en formato ISO8601. Los rangos de tiempo se indican en UTC y su duración máxima es de seis horas.

Período de tiempo: xray/home#/page?timeRange=range-in-minutes

https://console.aws.amazon.com/xray/home#/service-map?timeRange=PT1H

Hora de inicio y finalización: xray/home#/page?timeRange=start~end

https://console.aws.amazon.com/xray/home#/traces?timeRange=2023-7-01T16:00:00~2023-7-01T22:00:00

https://console.aws.amazon.com/xray/home#/traces?timeRange=2023-7-01T16:00~2023-7-01T22:00

Región

Especifique un enlace Región de AWS a las páginas de esa región. De lo contrario, la consola le redirige a la última región que ha visitado.

Región: xray/home?region=region#/page

https://console.aws.amazon.com/xray/home?region=us-west-2#/service-map

Cuando se incluye una región con otros parámetros de consulta, la consulta de región va antes de la almohadilla y las consultas específicas de X-Ray van después del nombre de página.

https://console.aws.amazon.com/xray/home?region=us-west-2#/service-map?timeRange=PT1H

En combinación

https://console.aws.amazon.com/xray/home#/traces?timeRange=PT15M&filter=duration%20%3E%3D%205%20AND%20duration%20%3C%3D%208