Visualización de rastros y detalles de rastros

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

Consulta de registros de seguimiento

CloudWatch console

Para ver los seguimientos en la CloudWatch consola

1. Inicie sesión en AWS Management Console y abra la CloudWatch consola en https://console.aws.amazon.com/cloudwatch/.

2. En el panel de navegación izquierdo, elija Rastros de X-Ray y, a continuación, Traces. Puede filtrar por grupo o introducir una expresión de filtro. Esto filtra los rastros que se muestran en la sección Rastros, en la parte inferior de la página.

   Como alternativa, puede usar el mapa de servicio para navegar hasta un nodo de servicio específico y, a continuación, ver los rastros. Esto abre la página de rastreos con una consulta ya aplicada.

3. Acote su consulta en la sección Limitadores de consultas. Para filtrar los rastreos por un atributo común, elija una opción de la flecha hacia abajo situada junto a Limitar la consulta por. Las opciones incluyen:

   • Nodo: filtra los rastreos por nodo de servicio.

   • RecursoARN: filtra las trazas por un recurso asociado a una traza. Algunos ejemplos de estos recursos son una instancia, una AWS Lambda función o una Amazon DynamoDB tabla de Amazon Elastic Compute Cloud (AmazonEC2).

   • Usuario: filtra las trazas con un ID de usuario.

   • Mensaje de causa raíz del error: filtra las trazas por la causa raíz del error.

   • URL— Filtra los rastros por la URL ruta utilizada por tu aplicación.

   • HTTPcódigo de estado: filtra las trazas por el código de HTTP estado devuelto por la aplicación. Puede especificar un código de respuesta personalizado o seleccionar una de las siguientes opciones:

     • 200— La solicitud se ha realizado correctamente.

     • 401— La solicitud carecía de credenciales de autenticación válidas.

     • 403— La solicitud carecía de permisos válidos.

     • 404— El servidor no pudo encontrar el recurso solicitado.

     • 500— El servidor detectó una condición inesperada y generó un error interno.

   Seleccione una o más entradas y, a continuación, seleccione Añadir a la consulta para añadirlas a la expresión de filtro situada en la parte superior de la página.

4. Para buscar una única traza, introduzca un identificador de traza directamente en el campo de consulta. Puede utilizar el formato X-Ray o el formato World Wide Web Consortium (W3C). Por ejemplo, una traza que se crea con la AWS distribución para OpenTelemetry está en formato W3C.

   nota

   Al consultar las trazas que se crean con un ID de traza en formato W3C, la consola muestra la traza coincidente en formato X-Ray. Por ejemplo, si realiza una consulta 4efaaf4d1e8720b39541901950019ee5 en formato W3C, la consola muestra el equivalente a X-Ray:. 1-4efaaf4d-1e8720b39541901950019ee5

5. Seleccione Ejecutar consulta en cualquier momento para visualizar una lista de rastros coincidentes en la sección Rastros, en la parte inferior de la página.

6. Para mostrar la página de detalles del rastreo de un solo rastreo, seleccione un ID de rastreo de la lista.

   La siguiente imagen muestra un mapa de rastreo que contiene los nodos de servicio asociados al rastreo y los bordes entre los nodos que representan la ruta seguida por los segmentos que componen el rastreo. A continuación del mapa de rastreo hay un resumen del rastreo. El resumen contiene información sobre una GET operación de ejemplo, su código de respuesta, el tiempo que tardó en ejecutarse el rastreo y la antigüedad de la solicitud. La cronología de los segmentos sigue el resumen del rastreo, que muestra la duración de los segmentos y subsegmentos del rastreo.

   

   Si tiene una aplicación basada en eventos que utiliza Amazon y SQS Lambda, puede ver una vista conectada de los seguimientos de cada solicitud en el mapa de Trace. En el mapa, las trazas de los productores de los mensajes están vinculadas a las trazas de AWS Lambda los consumidores y se muestran como un borde discontinuo. Para obtener más información sobre las aplicaciones basadas en eventos, consulte. Rastreo de aplicaciones basadas en eventos

   Las páginas Traces y de detalles de Trace también admiten el rastreo multicuenta, que permite enumerar los rastros de varias cuentas en la lista de rastreos y dentro de un único mapa de rastreo.

X-Ray console

Para ver los rastros en la consola de X-Ray

1. Abra la página Rastros de la consola de X-Ray. El panel de información general sobre el rastreo muestra una lista de rastreos agrupados por características comunes, como las causas principales del error, el recurso ARN y. InstanceId

2. Para seleccionar una función común para ver un conjunto agrupado de rastreos, expanda la flecha hacia abajo situada junto a Agrupar por. En la siguiente ilustración se muestra un resumen de los trazos agrupados URL por trazos y una lista de los trazos asociados. AWS X-Ray ejemplo de aplicación

   

3. Elija el ID de un rastreo para verlo en la lista de rastreos. También puede elegir el mapa de servicio en el panel de navegación para ver los rastros de un nodo de servicio específico. A continuación, puede ver los rastros asociados a ese nodo.

   La pestaña Cronología muestra el flujo de solicitudes del rastreo e incluye lo siguiente:

   • Un mapa de la ruta de cada segmento del rastreo.

   • Cuánto tiempo tardó el segmento en llegar a un nodo del mapa de rastreo.

   • Cuántas solicitudes se realizaron al nodo del mapa de rastreo.

   La siguiente ilustración muestra un ejemplo de mapa de rastreo asociado a una GET solicitud realizada a una aplicación de ejemplo. Las flechas muestran la ruta que siguió cada segmento para completar la solicitud. Los nodos de servicio muestran el número de solicitudes realizadas durante la GET solicitud.

   

   Para obtener más información sobre la pestaña Cronología, consulte la siguiente sección Exploración de la cronología del rastreo.

   La pestaña de datos sin procesar muestra información sobre el rastreo y los segmentos y subsegmentos que componen el rastreo, en JSON formato. Esta información puede incluir lo siguiente:

   • Marcas temporales

   • Único IDs

   • Recursos asociados al segmento o subsegmento

   • La fuente o el origen del segmento o subsegmento

   • Información adicional sobre la solicitud incluida en su solicitud, como la respuesta a una HTTP solicitud

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.

CloudWatch console

En la CloudWatch consola, la cronología de los segmentos proporciona la siguiente información:

• La primera columna: muestra los segmentos y subsegmentos de la traza seleccionada.

• La columna de estado del segmento: muestra el resultado de estado de cada segmento y subsegmento.

• La columna de códigos de respuesta: muestra un código de estado de HTTP respuesta a una solicitud del navegador realizada por el segmento o subsegmento, cuando está disponible.

• La columna Duración: muestra cuánto tiempo duró el segmento o subsegmento.

• La columna Alojado en: muestra el espacio de nombres o el entorno en el que se ejecuta el segmento o subsegmento, si corresponde. Para obtener más información, consulte Dimensiones recopiladas y combinaciones de dimensiones.

• La última columna: muestra barras horizontales que corresponden a la duración del segmento o subsegmento, en relación con los demás segmentos o subsegmentos de la línea de tiempo.

Para agrupar la lista de segmentos y subsegmentos por nodo de servicio, activa Agrupar por nodos.

X-Ray console

En la página de detalles del rastreo, selecciona la pestaña Cronología para ver el cronograma de cada segmento y subsegmento que forma un rastreo.

En la consola de X-Ray, la línea de tiempo proporciona la siguiente información:

• La columna Nombre: muestra los nombres de los segmentos y subsegmentos de la traza.

• La columna Res.: muestra un código de estado de HTTP respuesta a una solicitud del navegador realizada por el segmento o subsegmento, cuando está disponible.

• La columna Duración: muestra cuánto tiempo duró el segmento o subsegmento.

• La columna Estado: muestra el resultado del estado del segmento o subsegmento.

• La última columna: muestra barras horizontales que corresponden a la duración del segmento o subsegmento, en relación con los demás segmentos o subsegmentos de la línea de tiempo.

Para ver los datos de rastreo sin procesar que la consola utiliza para generar la línea de tiempo, seleccione la pestaña Datos sin procesar. Los datos sin procesar muestran información sobre la traza y los segmentos y subsegmentos que componen la traza en JSON formato. Esta información puede incluir lo siguiente:

• Marcas temporales

• Único IDs

• Recursos asociados al segmento o subsegmento

• La fuente o el origen del segmento o subsegmento

• Información adicional sobre la solicitud incluida en su solicitud, como la respuesta a una HTTP solicitud.

Cuando utiliza un instrumento AWS SDK o un SQL cliente para realizar llamadas a recursos externos, el X-Ray SDK graba los subsegmentos automáticamente. HTTP También puede usar el X-Ray SDK 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 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 la descripción general, los recursos, las anotaciones, los metadatos, las excepciones y SQLlas pestañas. Se aplica lo siguiente:

• En Overview (Información general) se muestra información acerca de la solicitud y la respuesta. La información incluye el nombre, la hora de inicio, la hora de finalización, la duración, la solicitudURL, la operación de la solicitud, el código de respuesta a la solicitud y cualquier error o fallo.

• La pestaña Recursos de un segmento muestra información de los X-Ray SDK y sobre los AWS recursos que ejecutan la aplicación. Usa los ECS complementos Amazon EC2 o Amazon del X-Ray SDK para registrar información de recursos específica del servicio. AWS Elastic Beanstalk Para obtener más información sobre los complementos, consulte la sección de complementos de servicio en. Configuración de X-Ray SDK para Java

• Las pestañas restantes muestran las anotaciones, los metadatos y las excepciones que se registran para el segmento. Las excepciones se capturan automáticamente cuando se generan a partir de una solicitud instrumentada. Las anotaciones y los metadatos contienen información adicional que se graba mediante las operaciones que SDK proporciona el X-Ray. Para añadir anotaciones o metadatos a sus segmentos, utilice el X-RaySDK. Para obtener más información, consulte el enlace específico del idioma que aparece en la sección Cómo instrumentar su aplicación con ella. AWS X-Ray SDKs Instrumentación de su solicitud para AWS X-Ray

Consulta de detalles de subsegmentos

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

• La pestaña Descripción general contiene información sobre la solicitud y la respuesta. Incluye el nombre, la hora de inicio, la hora de finalización, la duración, la solicitudURL, la operación de la solicitud, el código de respuesta a la solicitud y cualquier error o error. Para los subsegmentos generados con clientes instrumentados, la pestaña Overview (Información general) contiene información acerca de la solicitud y la respuesta desde el punto de vista de la aplicación.

• La pestaña Recursos de un subsegmento muestra detalles sobre los AWS recursos que se utilizaron para ejecutar el subsegmento. Por ejemplo, la pestaña de recursos puede incluir una AWS Lambda funciónARN, información sobre una tabla de DynamoDB, cualquier operación a la que se llame y un identificador de solicitud.

• Las pestañas restantes muestran las anotaciones, los metadatos y las excepciones registradas en el subsegmento. Las excepciones se capturan automáticamente cuando se generan a partir de una solicitud instrumentada. Las anotaciones y los metadatos contienen información adicional que se graba mediante las operaciones que SDK proporciona el X-Ray. Usa el X-Ray SDK para añadir anotaciones o metadatos a tus segmentos. Para obtener más información, consulte el enlace específico del idioma que aparece en la sección Cómo instrumentar su aplicación con ella. AWS X-Ray SDKs Instrumentación de su solicitud para AWS X-Ray

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 ella. AWS X-Ray SDKs 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.