As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Instrumentando seu aplicativo para AWS X-Ray
**nota**
Aviso de SDK/Daemon manutenção do X-Ray — Em 25 de fevereiro de 2026, o AWS X-Ray SDKs/Daemon entrará no modo de manutenção, onde AWS limitará as versões do X-Ray SDK e do Daemon para tratar apenas de problemas de segurança. Para obter mais informações sobre a linha do tempo do suporte, consulte [Cronograma de suporte do X-Ray SDK e do Daemon Support](xray-sdk-daemon-timeline.md). Recomendamos migrar para o. OpenTelemetry Para obter mais informações sobre a migração para OpenTelemetry, consulte [Migrando da instrumentação X-Ray para a instrumentação](https://docs.aws.amazon.com/xray/latest/devguide/xray-sdk-migration.html). OpenTelemetry
A instrumentação de um aplicativo requer o envio de dados de rastreamento para solicitações de entrada e saída e outros eventos dentro do aplicativo, bem como metadados sobre cada solicitação. Há várias opções de instrumentação diferentes que você pode escolher ou combinar, com base em seus aplicativos específicas:
+ *Instrumentação automática*: instrumente seu aplicativo sem alterações no código, normalmente por meio de alterações de configuração, adição de um agente de instrumentação automática ou outros mecanismos.
+ *Instrumentação de biblioteca* — faça alterações mínimas no código do aplicativo para adicionar instrumentação pré-criada voltada para bibliotecas ou estruturas específicas, como o AWS SDK, clientes Apache HTTP ou clientes SQL.
+ *Instrumentação manual*: adicione o código de instrumentação ao aplicativo em cada local para o qual você deseja enviar informações de rastreamento.
Existem vários SDKs agentes e ferramentas que podem ser usados para instrumentar seu aplicativo para rastreamento de raios-X.
**Topics**
+ [Instrumentando seu aplicativo com a AWS Distro para OpenTelemetry](#xray-instrumenting-opentel)
+ [Instrumentando seu aplicativo com AWS X-Ray SDKs](#xray-instrumenting-xray-sdk)
+ [Escolhendo entre o AWS Distro for OpenTelemetry e o X-Ray SDKs](#xray-instrumenting-choosing)
## Instrumentando seu aplicativo com a AWS Distro para OpenTelemetry
A AWS Distro for OpenTelemetry (ADOT) é uma AWS distribuição baseada no projeto Cloud Native Computing Foundation (CNCF). OpenTelemetry OpenTelemetry fornece um único conjunto de código aberto APIs, bibliotecas e agentes para coletar rastreamentos e métricas distribuídos. Este kit de ferramentas é uma distribuição de OpenTelemetry componentes iniciais SDKs, incluindo agentes de instrumentação automática e coletores que são testados, otimizados, protegidos e suportados pela. AWS
Com o ADOT, os engenheiros podem instrumentar seus aplicativos uma vez e enviar métricas e rastreamentos correlacionados para várias soluções de AWS monitoramento CloudWatch AWS X-Ray, incluindo Amazon e Amazon OpenSearch Service.
O uso do X-Ray com o ADOT requer dois componentes: um *OpenTelemetry SDK* habilitado para uso com o X-Ray e o *AWS Distro for OpenTelemetry Collector habilitado para* uso com o X-Ray. Para obter mais informações sobre como usar a AWS Distro for OpenTelemetry with AWS X-Ray e other Serviços da AWS, consulte a [AWS Distro for OpenTelemetry ](https://aws-otel.github.io/docs/introduction) Documentation.
Para obter mais informações sobre suporte e uso de idiomas, consulte [AWS Observabilidade ativada GitHub](https://github.com/aws-observability).
**nota**
Agora você pode usar o CloudWatch agente para coletar métricas, registros e rastreamentos de instâncias do Amazon EC2 e servidores locais. CloudWatch O agente versão 1.300025.0 e posterior pode coletar traços do nosso cliente [OpenTelemetry](#xray-instrumenting-opentel)X-Ray e enviá-los para o [ SDKsX-Ray](#xray-instrumenting-xray-sdk). Usar o CloudWatch agente em vez do AWS Distro for OpenTelemetry (ADOT) Collector ou do daemon X-Ray para coletar traços pode ajudar a reduzir o número de agentes que você gerencia. Consulte o tópico do [CloudWatch agente](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Install-CloudWatch-Agent.html) no Guia do CloudWatch usuário para obter mais informações.
A tabela inclui o seguinte:
+ [AWS Distro para 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)
No momento, o ADOT comporta instrumentação automática para [Java](https://aws-otel.github.io/docs/getting-started/java-sdk/auto-instr) e [Python](https://aws-otel.github.io/docs/getting-started/python-sdk/auto-instr). [Além disso, o ADOT permite a instrumentação automática das funções do AWS Lambda e suas solicitações downstream usando tempos de execução de Java, Node.js e Python, por meio do ADOT Managed Lambda Layers.](https://aws-otel.github.io/docs/getting-started/lambda)
O ADOT SDKs para Java e Go oferece suporte às regras de amostragem centralizada do X-Ray. Se você precisar de suporte para as regras de amostragem do X-Ray em outros idiomas, considere usar um AWS X-Ray SDK.
**nota**
Você pode enviar agora o rastreamento W3C para o IDs X-Ray. Por padrão, os rastreamentos criados com OpenTelemetry têm um formato de ID de rastreamento baseado na especificação do [W3C Trace Context](https://www.w3.org/TR/trace-context/). Isso é diferente do formato de rastreamento IDs criado usando um X-Ray SDK ou por AWS serviços integrados ao X-Ray. [Para garantir que o rastreamento IDs no formato W3C seja aceito pelo X-Ray, você deve usar a versão 0.86.0 ou posterior do [AWS X-Ray Exporter](https://aws-otel.github.io/docs/getting-started/x-ray), incluída na versão 0.34.0 e posterior do ADOT Collector.](https://aws-otel.github.io/download) As versões anteriores do exportador validam os timestamps de ID de rastreamento, o que pode fazer com que o rastreamento W3C seja rejeitado. IDs
## Instrumentando seu aplicativo com AWS X-Ray SDKs
AWS X-Ray inclui um conjunto de linguagens específicas SDKs para instrumentar seu aplicativo para enviar rastreamentos ao X-Ray. Cada X-Ray SDK fornece o seguinte:
+ *Interceptadores* a serem adicionados ao código para rastrear solicitações HTTP recebidas
+ *Manipuladores de clientes* para AWS instrumentar clientes SDK que seu aplicativo usa para chamar outros Serviços da AWS
+ Um *cliente HTTP* para instrumentar chamadas para outros serviços da web HTTP internos e externos
O X-Ray SDKs também oferece suporte a chamadas de instrumentação para bancos de dados SQL, instrumentação automática de clientes AWS SDK e outros recursos. Em vez de enviar dados de rastreamento diretamente ao X-Ray, os SDK enviam documentos de segmentos JSON a um processo do daemon que escuta o tráfego UDP. O [daemon do X-Ray](xray-daemon.md) armazena os segmentos em buffer em uma fila e os carrega em lote no X-Ray.
São fornecidos os seguintes 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)
No momento, o X-Ray comporta instrumentação automática para [Java](aws-x-ray-auto-instrumentation-agent-for-java.md).
## Escolhendo entre o AWS Distro for OpenTelemetry e o X-Ray SDKs
Os SDKs incluídos no X-Ray são parte de uma solução de instrumentação altamente integrada oferecida pela. AWS O AWS Distro OpenTelemetry for faz parte de uma solução mais ampla do setor, na qual o X-Ray é apenas uma das muitas soluções de rastreamento. Você pode implementar o end-to-end rastreamento no X-Ray usando qualquer uma das abordagens, mas é importante entender as diferenças para determinar a abordagem mais útil para você.
Recomendamos instrumentar seu aplicativo com a AWS Distro OpenTelemetry se você precisar do seguinte:
+ Capacidade de enviar rastreamentos para vários backends de rastreamento diferentes sem precisar reinstrumentar o código
+ Support para um grande número de instrumentações de biblioteca para cada idioma, mantidas pela comunidade OpenTelemetry
+ Camadas do Lambda totalmente gerenciadas que empacotam tudo o que você precisa para coletar dados de telemetria, sem exigir alterações de código ao usar Java, Python ou Node.js.
**nota**
AWS O Distro for OpenTelemetry oferece uma experiência inicial mais simples para instrumentar suas funções do Lambda. No entanto, devido às OpenTelemetry ofertas de flexibilidade, sua função Lambda exigirá memória adicional e as invocações podem sofrer aumentos de latência de inicialização a frio, o que pode levar a cobranças adicionais. Se você está otimizando para baixa latência e não precisa de recursos avançados, como destinos OpenTelemetry de back-end configuráveis dinamicamente, convém usar o AWS X-Ray SDK para instrumentar seu aplicativo.
Recomendamos escolher um X-Ray SDK para instrumentar o aplicativo se você precisar do seguinte:
+ Uma solução totalmente integrada de um único fornecedor.
+ Integração com as regras de amostragem centralizada do X-Ray, incluindo a capacidade de configurar regras de amostragem por meio do console do X-Ray e usá-las automaticamente em vários hosts, ao utilizar Node.js, Python, Ruby ou .NET