View a markdown version of this page

Usa la X-Ray API - AWS X-Ray

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Usa la X-Ray API

Si el X-Ray SDK no es compatible con tu lenguaje de programación, puedes usar X-Ray las API directamente o el AWS Command Line Interface (AWS CLI) para llamar a los comandos de la X-Ray API. Emplee las siguientes directrices para escoger la forma de interactuar con la API:

  • Usa el AWS CLI para simplificar la sintaxis mediante comandos preformateados o con las opciones incluidas en tu solicitud.

  • Usa la X-Ray API directamente para obtener la máxima flexibilidad y personalización de las solicitudes que realices. X-Ray

Si utilizas la X-Ray API directamente en lugar de la AWS CLI, debes parametrizar tu solicitud en el formato de datos correcto y es posible que también tengas que configurar la autenticación y la gestión de errores.

El siguiente diagrama muestra una guía para elegir cómo interactuar con la X-Ray API:

X-Ray muestra información detallada sobre las solicitudes de aplicación.

Utilice la X-Ray API para enviar datos de seguimiento directamente a X-Ray. La X-Ray API admite todas las funciones disponibles en el X-Ray SDK, incluidas las siguientes acciones comunes:

  • PutTraceSegments— Carga los documentos de los segmentos a. X-Ray

  • BatchGetTraces— Recupera una lista de rastros en una lista de identificadores de rastreo. Cada rastro recuperado es una recopilación de documentos de segmentos de una única solicitud.

  • GetTraceSummaries— Recupera los ID y las anotaciones de los rastros. Puede especificar un FilterExpression para recuperar un subconjunto de resúmenes de rastreo.

  • GetTraceGraph— Recupera un gráfico de servicio para un identificador de seguimiento específico.

  • GetServiceGraph— Recupera un documento JSON formateado que describe los servicios que procesan las solicitudes entrantes y llaman a las solicitudes posteriores.

También puedes usar el AWS Command Line Interface (AWS CLI) incluido en el código de tu aplicación para interactuar mediante programación. X-Ray AWS CLI Es compatible con todas las funciones disponibles en el X-Ray SDK, incluidas las de otras. Servicios de AWS Las siguientes funciones son versiones de las operaciones de la API indicadas anteriormente, pero con un formato más simple:

  • put-trace-segments: carga los documentos de los segmentos a. X-Ray

  • batch-get-traces: recupera una lista de rastros en una lista de ID de rastros. Cada rastro recuperado es una recopilación de documentos de segmentos de una única solicitud.

  • get-trace-summaries: recupera los ID y las anotaciones de los rastros. Puede especificar un FilterExpression para recuperar un subconjunto de resúmenes de rastreo.

  • get-trace-graph: recupera un gráfico de servicio para un ID de rastro específico.

  • get-service-graph: recupera un documento con formato JSON que describe los servicios que procesan las solicitudes entrantes y las solicitudes posteriores a la llamada.

Para empezar, debe instalarlo en su sistema operativo. AWS CLI AWS soportes Linux macOS y sistemas Windows operativos. Para obtener más información sobre la lista de X-Ray comandos, consulte la guía de referencia de AWS CLI comandos de X-Ray.

Temas