Usar uma SDK - AWS X-Ray
Use o ADOT SDKUse o X-Ray SDK

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 uma SDK

Use um SDK se quiser usar uma interface de linha de comando ou precisar de mais recursos personalizados de rastreamento, monitoramento ou registro do que os disponíveis em um AWS Management Console. Você também pode usar an AWS SDK para desenvolver programas que usam o X-RayAPIs. Você pode usar a AWS Distro for OpenTelemetry (ADOT) SDK ou o X-RaySDK.

Se você usar umSDK, poderá adicionar personalizações ao seu fluxo de trabalho ao instrumentar seu aplicativo e ao configurar seu coletor ou agente. Você pode usar um SDK para realizar as seguintes tarefas que você não pode fazer usando um AWS Management Console:

  • Publique 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 agregar pontos de dados em um conjunto de estatísticas.

  • Personalize seu coletor — personalize a configuração de qualquer parte de um coletor, incluindo o receptor, o processador, o exportador e o conector.

  • Personalize sua instrumentação — personalize segmentos e subsegmentos, adicione pares de valores-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 padrão OpenTelemetry SDK 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-RaySDK, integre apenas com AWS back-ends e não queira alterar a maneira como você interage com o X-Ray ou com o código do aplicativo.

Para obter mais informações sobre cada recurso, consulteEscolhendo entre o AWS Distro for OpenTelemetry e o X-Ray SDKs.

Use o ADOT SDK

ADOTSDKÉ um conjunto de bibliotecas e agentes de código APIs aberto que enviam dados para serviços de back-end. ADOTé suportado por AWS, se integra 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 ADOT SDK para instrumentar seu aplicativo e coletar registros, 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.

Se você estiver usando o ADOTSDK, 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 ADOTCollector — recomendado se você quiser usar software independente de fornecedor com AWS camadas de segurança e otimização.

Para usar o ADOTSDK, faça o seguinte:

  • Instrumente seu aplicativo usando ADOT SDK o. Para obter mais informações, consulte a documentação da sua linguagem de programação na documentação ADOT técnica.

  • Configure um ADOT coletor para dizer a ele para onde enviar os dados que ele coleta.

Depois que o ADOT coletor recebe seus dados, ele os envia para o back-end especificado na ADOT configuração. ADOTpode enviar dados para vários back-ends, inclusive para fornecedores externos AWS, conforme mostrado no diagrama a seguir:

Você pode personalizar o ADOT Collector ao instrumentar seu aplicativo e configurar o coletor.

AWS ADOTatualiza regularmente para adicionar funcionalidades e se alinhar à OpenTelemetryestrutura. Atualizações e futuros planos de desenvolvimento ADOT fazem parte de um roteiro que está disponível para o público. ADOTsuporta várias linguagens de programação que incluem o seguinte:

  • Go

  • Java

  • JavaScript

  • Python

  • .NET

  • Ruby

  • PHP

Se você estiver usando Python, ADOT pode instrumentar automaticamente seu aplicativo. Para começar a usarADOT, consulte Introdução e Introdução à AWS distribuição do OpenTelemetry Collector.

Use o X-Ray SDK

O X-Ray SDK é um conjunto AWS APIs e bibliotecas que enviam dados para serviços de AWS back-end. Use o X-Ray SDK para instrumentar sua aplicação e coletar dados de rastreamento. Você não pode usar o X-Ray SDK para coletar dados de registro ou métrica.

Se você estiver usando o X-RaySDK, 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 aplicativo.

  • Use o X-Ray SDK com o CloudWatch agente — (recomendado) O CloudWatch agente é compatível com o X-RaySDK.

Para usar o X-RaySDK, faça o seguinte:

  • Instrumente seu aplicativo usando o X-RaySDK.

  • Configure um coletor para dizer a ele para onde enviar os dados que ele coleta. Você pode usar o CloudWatch agente ou o daemon X-Ray 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 só SDK pode enviar dados para um AWS back-end, conforme mostrado no diagrama a seguir:

Use o X-Ray SDK com o CloudWatch agente ou com o daemon X-Ray.

Se estiver usandoJava, você pode usar o X-Ray SDK para instrumentar automaticamente seu aplicativo. Para começar a usar o X-RaySDK, consulte as bibliotecas associadas às seguintes linguagens de programação: