Use um 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á.

Use um 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 um AWS SDK para desenvolver programas que usam as APIs X-Ray. Você pode usar o AWS Distro for OpenTelemetry (ADOT) SDK ou o X-Ray SDK.

Se você usa um SDK, pode 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 realizar usando um AWS Management Console:

  • Publique métricas personalizadas — faça amostras de 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.

  • 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 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 somente com AWS back-ends e não queira alterar a forma como você interage com o X-Ray ou com o código do aplicativo.

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

Use o 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, 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 ADOT SDK, 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 um software independente de fornecedor com AWS camadas de segurança e otimização.

Para usar o ADOT SDK, faça o seguinte:

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

  • 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 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 registro ou métrica.

Se você 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 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 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 SDK só 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-Ray SDK, consulte as bibliotecas associadas às seguintes linguagens de programação: