View a markdown version of this page

AWS X-Ray exemplo de aplicação - AWS X-Ray

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

AWS X-Ray exemplo de aplicação

nota

X-Ray SDK/Daemon Aviso de manutenção — Em 25 de fevereiro de 2026, AWS X-Ray SDKs/Daemon ele entrará no modo de manutenção, onde AWS limitará os lançamentos 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. Recomendamos migrar para o. OpenTelemetry Para obter mais informações sobre como migrar para OpenTelemetry, consulte Migração da X-Ray instrumentação para a instrumentação. OpenTelemetry

O aplicativo de amostra AWS X-Ray eb-java-scorekeep, disponível em GitHub, mostra o uso do SDK para instrumentar chamadas HTTP recebidas, AWS X-Ray clientes SDK do DynamoDB e clientes HTTP. O aplicativo de amostra é usado CloudFormation para criar tabelas do DynamoDB, compilar código Java na instância e executar X-Ray o daemon sem nenhuma configuração adicional.

Consulte o tutorial do Scorekeep para começar a instalar e usar um aplicativo de amostra instrumentado, usando o Console de gerenciamento da AWS ou o. AWS CLI

O Scorekeep usa o AWS X-Ray SDK para instrumentar chamadas HTTP recebidas, clientes SDK do DynamoDB e clientes HTTP

O exemplo inclui um aplicativo web de front-end, a API chamada e as tabelas do DynamoDB usadas para armazenar os dados. A instrumentação básica com filtros, plug-ins e clientes AWS SDK instrumentados é mostrada na ramificação do projeto. xray-gettingstarted Essa é a ramificação que você implanta no tutorial de conceitos básicos. Como essa ramificação inclui apenas os conceitos básicos, você pode compará-la com a ramificação master para compreender rapidamente os conceitos básicos.

Mapa de serviço mostrando o cliente se conectando ao contêiner Scorekeep, que se conecta às DynamoDB tabelas e ao SNS.

O aplicativo de amostra mostra a instrumentação básica nesses arquivos:

A ramificação xray do aplicativo inclui o uso de HTTPClient, anotações, consultas SQL, subsegmentos personalizados, uma função do AWS Lambda instrumentada e código e scripts de inicialização instrumentados.

Para oferecer suporte ao login e ao AWS SDK para JavaScript uso do usuário no navegador, a xray-cognito filial adiciona o Amazon Cognito para oferecer suporte à autenticação e autorização do usuário. Com as credenciais recuperadas do Amazon Cognito, o aplicativo web também envia dados de rastreamento X-Ray para registrar as informações da solicitação do ponto de vista do cliente. O cliente do navegador aparece como seu próprio nó no mapa de rastreamento e grava informações adicionais, incluindo o URL da página que o usuário está visualizando e o ID do usuário.

Finalmente, a ramificação xray-worker adiciona uma função do Lambda instrumentada em Python que é executada de forma independente e processa os itens com base em uma fila do Amazon SQS. O Scorekeep adiciona um item à fila cada vez que um jogo termina. O trabalhador Lambda, acionado por CloudWatch Eventos, retira itens da fila a cada poucos minutos e os processa para armazenar registros do jogo no Amazon S3 para análise.