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

Instrumente seu aplicativo para AWS X-Ray

A instrumentação de uma aplicação requer o envio de dados de rastreamento para solicitações de entrada e saída e outros eventos dentro da aplicação, 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 suas aplicações específicas:

Há vários SDKs, agentes e ferramentas que podem ser usados para instrumentar a aplicação para rastreamento do X-Ray.

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 APIs, bibliotecas e agentes de código aberto para coletar rastreamentos e métricas distribuídos. Esse kit de ferramentas é uma distribuição de OpenTelemetry componentes upstream, incluindo SDKs, 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 Documentation.

Para obter mais informações sobre suporte e uso de idiomas, consulte AWS Observabilidade ativada GitHub.

A tabela inclui o seguinte:

No momento, o ADOT comporta instrumentação automática para Java e Python. 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.

Os SDKs do ADOT para Java e Go comportam 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.

Instrumentar uma aplicação com SDKs da AWS X-Ray

AWS X-Ray inclui um conjunto de SDKs específicos de linguagem para instrumentar seu aplicativo para enviar rastreamentos ao X-Ray. Cada X-Ray SDK fornece o seguinte:

Os X-Ray SDKs também oferecem 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 armazena os segmentos em buffer em uma fila e os carrega em lote no X-Ray.

Os seguintes SDKs específicos à linguagem são fornecidos:

No momento, o X-Ray comporta instrumentação automática para Java.

Escolhendo entre os AWS SDKs Distro for OpenTelemetry e X-Ray

Os SDKs incluídos com o X-Ray fazem parte de uma solução de instrumentação totalmente integrada que é 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:

Recomendamos escolher um X-Ray SDK para instrumentar a aplicação se você precisar do seguinte: