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á.
Usar um SDK
nota
X-Ray SDK/Daemon Aviso de manutenção — Em 25 de fevereiro de 2026, eles AWS X-Ray SDKs/Daemon entrarão no modo de manutenção, onde AWS limitarão as versões do X-Ray SDK e do Daemon para resolver apenas 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. Recomendamos migrar para o. OpenTelemetry Para obter mais informações sobre a migração para OpenTelemetry, consulte Migração da X-Ray instrumentação para a instrumentação. OpenTelemetry
Use um SDK se quiser usar uma interface de linha de comando ou precisar de mais recursos personalizados de rastreamento, monitoramento ou log do que os disponíveis em um Console de gerenciamento da AWS. Você também pode usar um AWS SDK para desenvolver programas que usam as X-Ray APIs. Você pode usar o AWS Distro for OpenTelemetry (ADOT) SDK ou o SDK. X-Ray
Ao usar um SDK, você pode adicionar personalizações ao fluxo de trabalho ao instrumentar seu aplicativo e ao configurar o coletor ou o agente. Você pode usar um SDK para realizar as seguintes tarefas, o que não é possível usando um Console de gerenciamento da AWS:
-
Publicar métricas personalizadas: avalie métricas em altas resoluções de até 1 segundo, use várias dimensões para adicionar informações sobre uma métrica e agregue pontos de dados em um conjunto de estatísticas.
-
Personalizar seu coletor: personalize a configuração de qualquer parte de um coletor, incluindo o receptor, o processador, o exportador e o conector.
-
Personalizar sua instrumentação: personalize segmentos e subsegmentos, adicione pares de valor-chave personalizados como atributos e crie métricas personalizadas.
-
Crie e atualize regras de amostragem programaticamente.
Use o ADOT SDK se quiser a flexibilidade de usar um OpenTelemetry SDK padronizado com camadas adicionais de AWS segurança e otimização. O AWS Distro for OpenTelemetry (ADOT) SDK é um pacote independente de fornecedor que permite a integração com back-ends de outros fornecedores e não prestadores de AWS serviços sem precisar reinstrumentar seu código.
Use o X-Ray SDK se você já estiver usando o X-Ray SDK, integre-o apenas aos AWS back-ends e não quiser mudar a maneira como você interage com o código do seu aplicativo X-Ray ou com ele.
Para obter mais informações sobre cada recurso, consulte Escolhendo entre o AWS Distro for OpenTelemetry e o X-Ray SDKs.
Use o comando ADOT SDK
O ADOT SDK é um conjunto de APIs, bibliotecas e agentes de código aberto que enviam dados para serviços de back-end. ADOTé suportado por AWS, integra-se a vários back-ends e agentes e fornece um grande número de bibliotecas de código aberto mantidas pela OpenTelemetry comunidade. Use o SDK do ADOT para instrumentar seu aplicativo e coletar logs, metadados, métricas e rastreamentos. Você também pode usar ADOT para monitorar serviços e definir um alarme com base em suas métricas em CloudWatch.
Ao usar o SDK do ADOT, você tem as seguintes opções, em combinação com um agente:
-
Use o ADOT SDK com o CloudWatch agente — recomendado.
-
Use o ADOT SDK com o ADOT Collector
— recomendado se você quiser usar software independente de fornecedor com AWS camadas de segurança e otimização.
Para usar o SDK do ADOT, faça o seguinte:
-
Instrumente seu aplicativo usando o SDK do ADOT. Para obter mais informações, consulte a documentação de sua linguagem de programação na documentação técnica do ADOT
. -
Configure um coletor do ADOT para informá-lo para onde enviar os dados que ele coleta.
Depois que o ADOT coletor recebe seus dados, ele os envia para o back-end que você especifica na ADOT configuração. ADOTpode enviar dados para vários back-ends, inclusive para fornecedores fora de AWS, conforme mostrado no diagrama a seguir:
AWS ADOTatualiza regularmente para adicionar funcionalidade e se alinhar com a OpenTelemetry
-
Go
-
Java
-
JavaScript
-
Python
-
.NET
-
Ruby
-
PHP
Se você estiver usando Python, o ADOT pode instrumentar automaticamente seu aplicativo. Para começar a usarADOT, consulte Introdução
Use o comando X-Ray SDK
O X-Ray SDK é um conjunto de AWS APIs e bibliotecas que enviam dados para serviços de AWS back-end. Use o X-Ray SDK para instrumentar seu aplicativo e coletar dados de rastreamento. Você não pode usar o X-Ray SDK para coletar dados de log ou métrica.
Se estiver usando o X-Ray SDK, você tem as seguintes opções, em combinação com um agente:
-
Use o X-Ray SDK com o AWS X-Ray daemon — Use isso se não quiser atualizar o código do seu aplicativo.
-
Use o X-Ray SDK com o CloudWatch agente — (recomendado) O CloudWatch agente é compatível com o X-Ray SDK.
Para usar o X-Ray SDK, faça o seguinte:
-
Instrumente seu aplicativo usando o X-Ray SDK.
-
Configure um coletor para informá-lo para onde enviar os dados que ele coleta. Você pode usar o CloudWatch agente ou o X-Ray daemon para coletar suas informações de rastreamento.
Depois que o coletor ou agente recebe seus dados, ele os envia para um AWS back-end que você especifica na configuração do agente. O X-Ray SDK só pode enviar dados para um AWS back-end, conforme mostrado no diagrama a seguir:
Se você estiver usandoJava, poderá usar o X-Ray SDK para instrumentar automaticamente seu aplicativo. Para começar a usar o X-Ray SDK, consulte as bibliotecas associadas às seguintes linguagens de programação:
