

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
<a name="xray-api"></a>

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 ](https://docs.aws.amazon.com/xray/latest/api/Welcome.html) 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.](https://docs.aws.amazon.com/es_es/xray/latest/devguide/images/api-vs-cli.png)


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](https://docs.aws.amazon.com/xray/latest/api/API_PutTraceSegments.html)— Carga los documentos de los segmentos a. X-Ray 
+ [BatchGetTraces](https://docs.aws.amazon.com/xray/latest/api/API_BatchGetTraces.html)— 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](https://docs.aws.amazon.com/xray/latest/api/API_GetTraceSummaries.html)— Recupera los ID y las anotaciones de los rastros. Puede especificar un `FilterExpression` para recuperar un subconjunto de resúmenes de rastreo.
+ [GetTraceGraph](https://docs.aws.amazon.com/xray/latest/api/API_GetTraceGraph.html)— Recupera un gráfico de servicio para un identificador de seguimiento específico.
+ [GetServiceGraph](https://docs.aws.amazon.com/xray/latest/api/API_GetServiceGraph.html)— 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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/xray/put-trace-segments.html): carga los documentos de los segmentos a. X-Ray
+ [batch-get-traces](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/xray/batch-get-traces.html): 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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/xray/get-trace-summaries.html): 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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/xray/get-trace-graph.html): recupera un gráfico de servicio para un ID de rastro específico.
+ [get-service-graph](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/xray/get-service-graph.html): 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](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) 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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/xray/index.html).

**Topics**
+ [Uso de la API de AWS X-Ray con la CLI de AWS](xray-api-tutorial.md)
+ [Envío de datos de rastreo a AWS X-Ray](xray-api-sendingdata.md)
+ [Obtención de datos de AWS X-Ray](xray-api-gettingdata.md)
+ [Configuración de los ajustes de muestreo, grupos y cifrado con la AWS X-Ray API](xray-api-configuration.md)
+ [Using sampling rules with the X-Ray API (Uso de reglas de muestreo con la API de X-Ray)](xray-api-sampling.md)
+ [AWS X-RayDocumentos de segmentos de](xray-api-segmentdocuments.md)