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.
# Instrumentación de su solicitud para AWS X-Ray
**nota**
Aviso de SDK/Daemon mantenimiento de X-Ray: el 25 de febrero de 2026, el AWS X-Ray SDKs/Daemon entrará en modo de mantenimiento, donde AWS se limitarán las versiones de X-Ray SDK y Daemon para abordar únicamente los 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](xray-sdk-daemon-timeline.md). Recomendamos 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](https://docs.aws.amazon.com/xray/latest/devguide/xray-sdk-migration.html). OpenTelemetry
La instrumentación de una aplicación implica el envío de datos de rastro para solicitudes entrantes y salientes y otros eventos de la aplicación junto con los metadatos de cada solicitud. Hay varias opciones de instrumentación entre las que puede elegir o que puede combinar, en función de sus requisitos particulares:
+ *Instrumentación automática*: instrumente su aplicación sin cambios de código, normalmente mediante cambios de configuración, añadiendo un agente de instrumentación automática u otros mecanismos.
+ *Instrumentación de biblioteca*: realice cambios mínimos en el código de la aplicación para agregar instrumentación prediseñada destinada a bibliotecas o marcos específicos, como el AWS SDK, los clientes HTTP de Apache o los clientes SQL.
+ *Instrumentación manual*: añada código de instrumentación a su aplicación en cada ubicación a la que desee enviar la información de rastro.
Existen varios SDKs agentes y herramientas que se pueden utilizar para instrumentar su aplicación de rastreo de rayos X.
**Topics**
+ [Cómo equipar su aplicación con la distribución para AWS OpenTelemetry](#xray-instrumenting-opentel)
+ [Instrumentar su solicitud con AWS X-Ray SDKs](#xray-instrumenting-xray-sdk)
+ [Cómo elegir entre AWS Distro for OpenTelemetry y X-Ray SDKs](#xray-instrumenting-choosing)
## Cómo equipar su aplicación con la distribución para AWS OpenTelemetry
The AWS Distro for OpenTelemetry (ADOT) es una AWS distribución basada en el proyecto Cloud Native Computing Foundation (CNCF). OpenTelemetry OpenTelemetry proporciona un conjunto único de código abierto APIs, bibliotecas y agentes para recopilar trazas y métricas distribuidas. Este kit de herramientas es una distribución de OpenTelemetry componentes originales que incluye SDKs agentes de autoinstrumentación y colectores que se prueban, optimizan, protegen y respaldan. AWS
Con ADOT, los ingenieros pueden instrumentar sus aplicaciones una vez y enviar métricas y rastreos correlacionados a múltiples soluciones de AWS monitoreo CloudWatch AWS X-Ray, incluidas Amazon y Amazon OpenSearch Service.
El uso de X-Ray con ADOT requiere dos componentes: un *OpenTelemetry SDK* habilitado para su uso con X-Ray y una *AWS Distro for OpenTelemetry Collector habilitada para* su uso con X-Ray. Para obtener más información sobre el uso de la AWS distribución OpenTelemetry con AWS X-Ray y otros Servicios de AWS, consulta la documentación de la [AWS distribución](https://aws-otel.github.io/docs/introduction). OpenTelemetry
Para obtener más información sobre el soporte y el uso de idiomas, consulta [AWS Observabilidad](https://github.com/aws-observability) en. GitHub
**nota**
Ahora puede usar el CloudWatch agente para recopilar métricas, registros y seguimientos de las instancias de Amazon EC2 y de los servidores locales. CloudWatch La versión 1.300025.0 del agente y posteriores puede recopilar rastros de nuestro cliente de [OpenTelemetry](#xray-instrumenting-opentel)[X-Ray](#xray-instrumenting-xray-sdk) y SDKs enviarlos a X-Ray. Utilizar el CloudWatch agente en lugar del Collector AWS Distro for OpenTelemetry (ADOT) o el daemon X-Ray para recopilar rastros puede ayudarle a reducir la cantidad de agentes que administra. Consulte el tema sobre los [CloudWatch agentes](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Install-CloudWatch-Agent.html) en la Guía del CloudWatch usuario para obtener más información.
ADOT incluye lo siguiente:
+ [AWS Distro for Go OpenTelemetry ](https://aws-otel.github.io/docs/getting-started/go-sdk)
+ [AWS Distro para Java OpenTelemetry ](https://aws-otel.github.io/docs/getting-started/java-sdk)
+ [AWS Distro para OpenTelemetry JavaScript](https://aws-otel.github.io/docs/getting-started/javascript-sdk)
+ [AWS Distro para Python OpenTelemetry ](https://aws-otel.github.io/docs/getting-started/python-sdk)
+ [AWS Distro para .NET OpenTelemetry ](https://aws-otel.github.io/docs/getting-started/dotnet-sdk)
Actualmente, ADOT admite la instrumentación automática para [Java](https://aws-otel.github.io/docs/getting-started/java-sdk/auto-instr) y [Python](https://aws-otel.github.io/docs/getting-started/python-sdk/auto-instr). [Además, ADOT permite la instrumentación automática de las funciones de AWS Lambda y sus solicitudes posteriores mediante tiempos de ejecución de Java, Node.js y Python, mediante capas Lambda gestionadas por ADOT.](https://aws-otel.github.io/docs/getting-started/lambda)
ADOT SDKs para Java y Go admiten las reglas de muestreo centralizado de X-Ray. Si necesita soporte para las reglas de muestreo de X-Ray en otros idiomas, considere la posibilidad de usar un AWS X-Ray SDK.
**nota**
Ya puede enviar el rastreo del W3C a IDs X-Ray. De forma predeterminada, las trazas que se crean con ellas OpenTelemetry tienen un formato de ID de traza que se basa en la especificación del contexto de rastreo del [W3C](https://www.w3.org/TR/trace-context/). Es diferente del formato de rastreo IDs que se crea mediante un SDK de X-Ray o mediante AWS servicios integrados con X-Ray. Para garantizar que X-Ray acepte IDs el rastreo en formato W3C, debe utilizar la versión 0.86.0 o posterior del [AWS X-Ray Exporter](https://aws-otel.github.io/docs/getting-started/x-ray), que se incluye en la versión 0.34.0 y posteriores de [ADOT Collector](https://aws-otel.github.io/download). Las versiones anteriores del exportador validan las marcas de tiempo de los identificadores de rastreo, lo que puede provocar que se rechace el rastreo del W3C. IDs
## Instrumentar su solicitud con AWS X-Ray SDKs
AWS X-Ray incluye un conjunto de idiomas específicos SDKs para instrumentar su aplicación para enviar trazas a X-Ray. Cada SDK de X-Ray proporciona lo siguiente:
+ *Interceptadores* que añadir a su código para rastrear solicitudes HTTP entrantes
+ *Controladores de clientes para instrumentar los* clientes del AWS SDK que su aplicación utiliza para llamar a otros Servicios de AWS
+ Un *cliente HTTP* para instrumentar llamadas a servicios web HTTP internos y externos
X-Ray SDKs también admite llamadas de instrumentación a bases de datos SQL, instrumentación automática de clientes AWS SDK y otras funciones. En lugar de enviar los datos de rastro directamente a X-Ray, el SDK envía documentos de segmento JSON a un proceso del daemon que escucha el tráfico UDP. El [daemon de X-Ray](xray-daemon.md) almacena en búfer segmentos en una cola y los carga en X-Ray en lotes.
Se proporcionan los siguientes idiomas específicos SDKs :
+ [AWS X-Ray SDK para Go](xray-sdk-go.md)
+ [AWS X-Ray SDK para Java](xray-sdk-java.md)
+ [AWS X-Ray SDK para Node.js](xray-sdk-nodejs.md)
+ [AWS X-Ray SDK para Python](xray-sdk-python.md)
+ [AWS X-Ray SDK para .NET](xray-sdk-dotnet.md)
+ [AWS X-Ray SDK para Ruby](xray-sdk-ruby.md)
Actualmente, X-Ray admite la instrumentación automática para [Java](aws-x-ray-auto-instrumentation-agent-for-java.md).
## Cómo elegir entre AWS Distro for OpenTelemetry y X-Ray SDKs
Los que SDKs se incluyen con X-Ray son parte de una solución de instrumentación estrechamente integrada que ofrece. AWS El AWS Distro for OpenTelemetry forma parte de una solución industrial más amplia en la que X-Ray es solo una de las muchas soluciones de rastreo. Puede implementar el end-to-end rastreo en X-Ray utilizando cualquiera de los dos enfoques, pero es importante entender las diferencias para determinar cuál es el enfoque más útil para usted.
Le recomendamos que equipe su aplicación con la AWS Distro OpenTelemetry si necesita lo siguiente:
+ La posibilidad de enviar rastros a varios backends de rastreo sin tener que volver a instrumentar el código
+ Support para una gran cantidad de instrumentaciones bibliotecarias para cada idioma, mantenidas por la comunidad OpenTelemetry
+ Capas de Lambda completamente administradas que empaquetan todo lo necesario para recopilar datos de telemetría sin necesidad de cambios de código al usar Java, Python o Node.js
**nota**
AWS Distro for OpenTelemetry ofrece una experiencia de inicio más sencilla para instrumentar las funciones de Lambda. Sin embargo, debido a la flexibilidad que OpenTelemetry ofrece, la función Lambda requerirá memoria adicional y las invocaciones pueden experimentar un aumento de la latencia de arranque en frío, lo que puede generar cargos adicionales. Si está optimizando para una baja latencia y no necesita capacidades avanzadas, como destinos OpenTelemetry de back-end configurables de forma dinámica, puede utilizar el SDK de AWS X-Ray para instrumentar su aplicación.
Le recomendamos que elija un SDK de X-Ray para instrumentar su aplicación si necesita lo siguiente:
+ Una solución de un solo proveedor perfectamente integrada
+ Integración en reglas de muestreo centralizadas de X-Ray, incluida la capacidad de configurar las reglas de muestreo desde la consola de X-Ray y utilizarlas automáticamente en varios hosts, al utilizar Node.js, Python, Ruby o .NET