Utilizar un SDK - AWS X-Ray
Utilice el ADOT SDKUsa el X-Ray SDK

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.

Utilizar un SDK

Utilice una SDK si desea utilizar una interfaz de línea de comandos o si necesita funciones de seguimiento, supervisión o registro más personalizadas que las disponibles en una AWS Management Console. También puede usar y AWS SDK para desarrollar programas que usen los X-RayAPIs. Puede usar la AWS Distro for OpenTelemetry (ADOT) SDK o la X-RaySDK.

Si utiliza unaSDK, puede añadir personalizaciones a su flujo de trabajo tanto al instrumentar su aplicación como al configurar su recopilador o agente. Puede usar un SDK para realizar las siguientes tareas que no puede realizar con un AWS Management Console:

  • Publique métricas personalizadas: tome muestras de métricas en resoluciones altas de hasta 1 segundo, use varias dimensiones para agregar información sobre una métrica y agregue puntos de datos en un conjunto de estadísticas.

  • Personalice su recopilador: personalice la configuración de cualquier parte de un recopilador, incluidos el receptor, el procesador, el exportador y el conector.

  • Personalice su instrumentación: personalice segmentos y subsegmentos, añada pares clave-valor personalizados como atributos y cree métricas personalizadas.

  • Cree y actualice las reglas de muestreo mediante programación.

ADOTSDKUtilícela si desea la flexibilidad de usar una estandarizada OpenTelemetry SDK con capas adicionales de AWS seguridad y optimización. El AWS Distro for OpenTelemetry (ADOT) SDK es un paquete independiente del proveedor que permite la integración con backends de otros proveedores y no relacionados con los AWS servicios sin tener que reinstrumentar el código.

Utilice X-Ray SDK si ya lo está utilizandoSDK, solo lo integra con AWS backends y no quiere cambiar la forma en que interactúa con X-Ray o el código de su aplicación.

Para obtener más información sobre cada función, consulteCómo elegir entre AWS Distro for OpenTelemetry y X-Ray SDKs.

Utilice el ADOT SDK

ADOTSDKEs un conjunto de bibliotecas y agentes de código APIs abierto que envían datos a los servicios de back-end. ADOTes compatible con varios backends y agentes AWS, se integra con ellos y proporciona una gran cantidad de bibliotecas de código abierto mantenidas por la OpenTelemetry comunidad. Úselo ADOT SDK para instrumentar su aplicación y recopilar registros, metadatos, métricas y rastreos. También puedes usarlo ADOT para monitorear los servicios y configurar una alarma en función de tus métricas CloudWatch.

Si utilizas el ADOTSDK, tienes las siguientes opciones, en combinación con un agente:

  • ADOTSDKUtilízalo con el CloudWatch agente (recomendado).

  • ADOTSDKUtilícelo con el ADOTrecopilador, lo que se recomienda si desea utilizar software independiente del proveedor con AWS niveles de seguridad y optimización.

Para utilizar el ADOTSDK, haga lo siguiente:

  • Instrumente su aplicación con el ADOTSDK. Para obtener más información, consulte la documentación de su lenguaje de programación en la documentación ADOT técnica.

  • Configure un ADOT recopilador para que le indique dónde debe enviar los datos que recopila.

Una vez que el ADOT recopilador recibe los datos, los envía al servidor que usted especifique en la ADOT configuración. ADOTpuede enviar datos a varios backends, incluso a proveedores externos AWS, como se muestra en el siguiente diagrama:

Puede personalizar el ADOT recopilador al instrumentar su aplicación y configurar el recopilador.

AWS se actualiza periódicamente ADOT para añadir funcionalidad y adaptarla a la OpenTelemetryestructura. Las actualizaciones y los planes futuros para el desarrollo ADOT son parte de una hoja de ruta que está disponible para el público. ADOTadmite varios lenguajes de programación, entre los que se incluyen los siguientes:

  • Go

  • Java

  • JavaScript

  • Python

  • .NET

  • Ruby

  • PHP

Si está utilizando Python, ADOT puede instrumentar automáticamente su aplicación. Para empezar a usarloADOT, consulte Introducción y Introducción a la AWS distribución de OpenTelemetry Collector.

Usa el X-Ray SDK

X-Ray SDK es un conjunto de AWS APIs bibliotecas que envían datos a los servicios de AWS back-end. Utilice el X-Ray SDK para instrumentar su aplicación y recopilar datos de rastreo. No puede usar el X-Ray SDK para recopilar datos de registro o métricas.

Si utiliza los rayos XSDK, tiene las siguientes opciones, en combinación con un agente:

  • Utilice el X-Ray SDK con elAWS X-Ray demonio: utilícelo si no desea actualizar el código de la aplicación.

  • Utilice la radiografía SDK con el CloudWatch agente — (recomendado) El CloudWatch agente es compatible con la radiografíaSDK.

Para usar los rayos XSDK, haga lo siguiente:

  • Instrumente su aplicación con el X-RaySDK.

  • Configure un recopilador para que le indique dónde enviar los datos que recopila. Puede utilizar el CloudWatch agente o el daemon de X-Ray para recopilar la información de rastreo.

Una vez que el recopilador o el agente reciben los datos, los envían a un AWS servidor que usted especifique en la configuración del agente. El X-Ray solo SDK puede enviar datos a un AWS backend, como se muestra en el siguiente diagrama:

Usa los rayos X SDK con el CloudWatch agente o con el daemon de rayos X.

Si lo está utilizandoJava, puede utilizar el X-Ray SDK para instrumentar automáticamente su aplicación. Para empezar a utilizar X-RaySDK, consulte las bibliotecas asociadas a los siguientes lenguajes de programación: