En esta sección, encontrará información detallada acerca de cómo utilizar los mapas de servicios y las vistas de rastros de AWS X-Ray con API Gateway.
Ejemplo de mapa de servicio de X-Ray
AWS X-RayLos mapas de servicios de muestran información sobre la API y todos sus servicios posteriores. Cuando habilite X-Ray para una etapa de API en API Gateway, verá un nodo en el mapa de servicio que contiene información general sobre el tiempo total empleado en el servicio de API Gateway. Puede obtener información detallada sobre el estado de la respuesta y un histograma del tiempo de respuesta de la API para el periodo de tiempo seleccionado. En el caso de las API que se integran en servicios de AWS, como AWS Lambda y Amazon DynamoDB, verá más nodos con métricas de rendimiento relacionadas con esos servicios. Habrá un mapa de servicios para cada etapa de API.
El siguiente ejemplo muestra un mapa de servicios para la etapa test
de una API llamada xray
. Esta API tiene una integración Lambda con una función de autorizador de Lambda y una función de backend de Lambda. Los nodos representan el servicio de API Gateway, el servicio de Lambda y las dos funciones de Lambda.
Para obtener una explicación detallada de la estructura del mapa de servicio, consulte Uso del mapa de seguimiento de X-Ray.

Desde el mapa de servicios, puede ampliar el nivel de detalle para ver una vista de rastros de la etapa de la API. El rastro mostrará información detallada sobre la API, representada como segmentos y subsegmentos. Por ejemplo, el rastro del mapa de servicio mostrado arriba incluiría segmentos para el servicio de Lambda y la función de Lambda. Para obtener más información, consulte AWS Lambda y AWS X-Ray.
Si elige un nodo o borde en un mapa de servicio de X-Ray, la consola de X-Ray muestra un histograma de distribución de latencias. Puede utilizar un histograma de latencias para ver el tiempo que tarda un servicio en completar sus solicitudes. A continuación se presenta un histograma de la etapa de API Gateway denominada xray/test
en el mapa de servicio anterior. Para obtener una explicación detallada de los histogramas de distribución de latencias, consulte Uso de los histogramas de latencias.

Ejemplo de vista de rastro de X-Ray
En el siguiente diagrama se muestra una vista de rastros generada para la API de ejemplo descrita anteriormente, con una función de backend de Lambda y una función de autorizador de Lambda. Se muestra una solicitud de método de API realizada correctamente con un código de respuesta de 200.
Para obtener una explicación detallada de las vistas de rastros, consulte Visualización de rastros y detalles de rastros.
