View a markdown version of this page

Configurar AWS X-Ray depuração - AWS Elastic Beanstalk

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

Configurar AWS X-Ray depuração

Você pode usar o AWS Elastic Beanstalk console ou um arquivo de configuração para executar o AWS X-Ray daemon nas instâncias do seu ambiente. X-Ray é um AWS serviço que reúne dados sobre as solicitações que seu aplicativo atende e os usa para criar um mapa de serviços que você pode usar para identificar problemas com seu aplicativo e oportunidades de otimização.

nota

A execução do X-Ray daemon se aplica somente aos ambientes Beanstalk Standard. Com o Beanstalk Cluster, envie os rastreamentos do seu aplicativo AWS X-Ray definindo a traces-backend opção no aws:elasticbeanstalk:eks:observability namespace paraxray, e o Elastic Beanstalk opera os componentes de coleta para você. Consulte Monitorando ambientes do Beanstalk Cluster e Opções de configuração para ambientes Beanstalk Cluster.

nota

Algumas regiões não oferecem X-Ray. Se você criar um ambiente em uma dessas regiões, não poderá executar o X-Ray daemon nas instâncias do seu ambiente.

Para obter informações sobre os AWS serviços oferecidos em cada região, consulte a Tabela de regiões.

O mapa de serviço para uma aplicação de API Web que usa o Amazon DynamoDB para armazenar dados

X-Ray fornece um SDK que você pode usar para instrumentar o código do seu aplicativo e um aplicativo daemon que transmite informações de depuração do SDK para a API. X-Ray

Plataformas compatíveis

Você pode usar o X-Ray SDK com as seguintes plataformas do Elastic Beanstalk:

  • Go - versão 2.9.1 e posterior

  • Java 8 – versão 2.3.0 e posterior

  • Java 8 com Tomcat 8 – versão 2.4.0 e posterior

  • Node.js- versão 3.2.0 e posterior

  • Windows Server – todas as versões de plataforma lançadas em 18 de dezembro de 2016 ou posteriormente

  • Python – versão 2.5.0 e posterior

Em plataformas compatíveis, você pode usar uma opção de configuração para executar o X-Ray daemon nas instâncias do seu ambiente. Você pode habilitar o daemon no console do Elastic Beanstalk ou usando um arquivo de configuração.

Para fazer upload de dados X-Ray, o X-Ray daemon exige permissões do IAM na política AWSXrayWriteOnlyAccess gerenciada. Essas permissões são incluídas no perfil da instância do Elastic Beanstalk. Se você não usa o perfil de instância padrão, consulte Conceder permissão ao Daemon para enviar dados X-Ray no Guia do AWS X-Ray desenvolvedor.

A depuração com X-Ray requer o uso do SDK. X-Ray Consulte os Conceitos básicos do AWS X-Ray no Guia do Desenvolvedor do AWS X-Ray para obter instruções e aplicações de amostra.

Se você usa uma versão de plataforma que não inclui o daemon, ainda é possível executá-lo com um script em um arquivo de configuração. Para obter mais informações, consulte Baixando e executando o X-Ray daemon manualmente (avançado) no Guia do AWS X-Ray desenvolvedor.

Configurar depuração do

Você pode habilitar o X-Ray daemon em um ambiente de execução no console do Elastic Beanstalk.

Como habilitar a depuração no console do Elastic Beanstalk
  1. Abra o console do Elastic Beanstalk e, na lista Regiões, selecione seu. Região da AWS

  2. No painel de navegação, selecione Ambientes e selecione o nome do ambiente na lista.

  3. No painel de navegação, escolha Configuration (Configuração).

  4. Na categoria de configuração Updates, monitoring, and logging (Atualizações, monitoramento e logs), escolha Edit (Editar).

  5. Na X-Ray seção Amazon, selecione Ativado.

  6. Para salvar as alterações, escolha Apply (Aplicar) na parte inferior da página.

Essa opção pode ser ativada também durante a criação do ambiente. Para obter mais informações, consulte O assistente de criação de novo ambiente.

O namespace aws:elasticbeanstalk:xray

Use a opção XRayEnabled no namespace aws:elasticbeanstalk:xray para habilitar a depuração.

Para habilitar a depuração automaticamente quando você implanta o aplicativo, defina a opção em um arquivo de configuração no código-fonte, como a seguir.

exemplo. ebextensions/debugging.configuração
option_settings: aws:elasticbeanstalk:xray: XRayEnabled: true