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.
Uso de un SDK
nota
X-Ray SDK/Daemon Aviso de mantenimiento: el 25 de febrero de 2026, AWS X-Ray SDKs/Daemon entrará en modo de mantenimiento, donde las versiones de X-Ray SDK y Daemon AWS se limitarán únicamente a solucionar problemas de seguridad. Para obtener más información sobre la cronología del soporte, consulte Cronología de X-Ray SDK y Daemon Support. Recomendamos migrar a. OpenTelemetry Para obtener más información sobre la migración a OpenTelemetry, consulte Migración de una X-Ray instrumentación a otra. OpenTelemetry
Utilice un SDK si desea utilizar una interfaz de línea de comandos o si necesita más funciones personalizadas de rastreo, supervisión o registro de las que están disponibles en una Consola de administración de AWS. También puedes usar un AWS SDK para desarrollar programas que usen las API. X-Ray Puedes usar el SDK AWS Distro for OpenTelemetry (ADOT) o el SDK. X-Ray
Si utiliza un SDK, puede añadir personalizaciones a su flujo de trabajo tanto al instrumentar su aplicación como al configurar su recopilador o agente. Utilice un SDK para efectuar las siguientes tareas que no puede llevar a cabo con una Consola de administración de AWS:
-
Publicar 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.
-
Personalizar su recopilador: personalice la configuración de cualquier parte de un recopilador, incluidos el receptor, el procesador, el exportador y el conector.
-
Personalizar su instrumentación: personalice segmentos y subsegmentos, añada pares clave-valor personalizados como atributos y cree métricas personalizadas.
-
Crear y actualizar las reglas de muestreo mediante programación.
Usa el ADOT SDK si quieres la flexibilidad de usar un OpenTelemetry SDK estandarizado con capas adicionales de seguridad y optimización. AWS El SDK AWS Distro for OpenTelemetry (ADOT) es un paquete independiente del proveedor que permite la integración con los backends de otros proveedores y de otros proveedores que no son de servicios sin tener que reinstrumentar el código.AWS
Usa el X-Ray SDK si ya lo estás usando, solo intégralo con los X-Ray AWS backends y no quieres cambiar la forma en que interactúas con el código de tu aplicación ni con él. X-Ray
Para obtener más información acerca de cada una de las características, consulte Cómo elegir entre AWS Distro for OpenTelemetry y X-Ray SDKs.
Use la ADOT SDK
El ADOT SDK es un conjunto de API, bibliotecas y agentes de código abierto que envían datos a los servicios de backend. 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 comunidad. OpenTelemetry Utilice el SDK de ADOT para instrumentar su aplicación y recopilar registros, metadatos, métricas y rastros. También puedes usarlo ADOT para monitorear los servicios y configurar una alarma en función de tus métricas en CloudWatch.
Si utiliza el SDK de ADOT, dispone de las siguientes opciones, en combinación con un agente:
-
Se recomienda usar el ADOT SDK con el CloudWatch agente.
-
Utilice el ADOT SDK con el ADOT recopilador
; se recomienda si desea utilizar software independiente del proveedor con AWS niveles de seguridad y optimización.
Para utilizar el SDK de ADOT, haga lo siguiente:
-
Instrumente su aplicación con el SDK de ADOT. Para obtener más información, consulte la documentación de su lenguaje de programación en la documentación técnica de ADOT
. -
Configure un recopilador de ADOT para que le indique dónde enviar los datos que recopila.
Una vez que el ADOT recopilador recibe tus datos, los envía al backend que especifiques en la configuración. ADOT ADOTpuede enviar datos a varios backends, incluso a proveedores externos AWS, como se muestra en el siguiente diagrama:
AWS se actualiza periódicamente ADOT para agregar funciones y alinearse con el OpenTelemetry
-
Go
-
Java
-
JavaScript
-
Python
-
.NET
-
Ruby
-
PHP
Si está utilizando Python, ADOT puede instrumentar automáticamente su aplicación. Para empezar a utilizarlaADOT, consulte Introducción
Use la X-Ray SDK
El X-Ray SDK es un conjunto de AWS API y bibliotecas que envían datos a los servicios de AWS backend. Usa el X-Ray SDK para instrumentar tu aplicación y recopilar datos de seguimiento. No puede usar el X-Ray SDK para recopilar datos de registro o métricas.
Si usa el X-Ray SDK, tiene las siguientes opciones, en combinación con un agente:
-
Usa el X-Ray SDK conAWS X-Ray demonio: úsalo si no quieres actualizar el código de la aplicación.
-
Usa el X-Ray SDK con el CloudWatch agente — (recomendado) El CloudWatch agente es compatible con el X-Ray SDK.
Para usar el X-Ray SDK, haga lo siguiente:
-
Instrumente su aplicación con el X-Ray SDK.
-
Configure un recopilador para que le indique dónde enviar los datos que recopila. Puede usar el CloudWatch agente o el X-Ray demonio para recopilar la información de rastreo.
Una vez que el recopilador o el agente reciben tus datos, los envía a un AWS backend que especifiques en la configuración del agente. El X-Ray SDK solo puede enviar datos a un AWS backend, como se muestra en el siguiente diagrama:
Si lo está usandoJava, puede usar el X-Ray SDK para instrumentar automáticamente su aplicación. Para empezar a usar el X-Ray SDK, consulta las bibliotecas asociadas a los siguientes lenguajes de programación:
