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
End-of-support aviso: el 25 de febrero de 2027, AWS X-Ray dejará de ofrecer soporte para AWS X-Ray SDKs and daemon. A partir del 25 de febrero de 2027, dejaréis de recibir actualizaciones ni versiones. Para obtener más información sobre el cronograma de soporte, consulteCronología del fin del soporte de X-Ray SDK y daemon. Se recomienda migrar a OpenTelemetry. Para obtener más información sobre la migración a OpenTelemetry, consulte Migración de una instrumentación de rayos X a una instrumentación. 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 AWS Management Console. También puede usar un AWS SDK para desarrollar programas que usen el X-Ray APIs. Puede 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 AWS Management Console:
-
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.
Use el ADOT SDK si desea la flexibilidad de usar un OpenTelemetry SDK estandarizado con niveles adicionales de AWS seguridad y optimización. El SDK AWS Distro for OpenTelemetry (ADOT) es un paquete independiente del proveedor que permite la integración con back-ends de otros proveedores y no relacionados con los AWS servicios sin tener que reorganizar el código.
Utilice el SDK de X-Ray si ya lo hace y solo se integra con backends de AWS y no pretenda cambiar la forma en que interactúa con X-Ray o con el código de su aplicación.
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.
Uso del SDK de ADOT
El ADOT SDK es un conjunto de bibliotecas y agentes de código abierto que envían APIs datos a los servicios de backend. ADOTes compatible con varios backends y agentes AWS, se integra con ellos y proporciona un gran número de bibliotecas de código abierto mantenidas por la OpenTelemetry comunidad. 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. CloudWatch
Si utiliza el SDK de ADOT, dispone de las siguientes opciones, en combinación con un agente:
-
Usa el ADOT SDK con el CloudWatch agente (se recomienda).
-
Utilice el ADOT SDK 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 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 los datos, los envía al servidor que especifiques en la ADOT configuración. 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 añadir funcionalidad 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 ADOT utilizarla, consulte Introducción y introducción
Uso del SDK de X-Ray
El SDK de X-Ray es un conjunto de AWS APIs bibliotecas que envían datos a los servicios de AWS backend. Utilice el SDK de X-Ray con el fin de instrumentar su aplicación y recopilar datos de rastro. No puede utilizar el SDK de X-Ray para recopilar datos de registro o de métricas.
Si utiliza el SDK de X-Ray, dispone de las siguientes opciones, en combinación con un agente:
-
Uso del SDK de X-Ray con el AWS X-Ray demonio: utilícelo si no desea actualizar el código de la aplicación.
-
Utilice el SDK de X-Ray con el CloudWatch agente: (recomendado) El CloudWatch agente es compatible con el SDK de X-Ray.
Para usar el SDK de X-Ray, haga lo siguiente:
-
Instrumente su aplicación con el SDK de X-Ray.
-
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 SDK de X-Ray solo puede enviar datos a un backend de AWS , tal como se muestra en el siguiente diagrama:
Si está utilizando Java, puede emplear el SDK de X-Ray para instrumentar automáticamente su aplicación. Para empezar a usar el SDK de X-Ray, consulte las bibliotecas asociadas a los siguientes lenguajes de programación:
