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 depuração do AWS X-Ray
Use o console do AWS Elastic Beanstalk ou um arquivo de configuração para executar o daemon do AWS X-Ray nas instâncias do ambiente. O X-Ray é um produto da AWS que coleta dados sobre as solicitações que o aplicativo atende, e os usa para construir um mapa de serviços que pode ser usado para identificar problemas no aplicativo e oportunidades de otimização.
nota
Algumas regiões não oferecem o X-Ray. Se você criar um ambiente em uma dessas regiões, não poderá executar o daemon do X-Ray nas instâncias no ambiente.
Para obter informações sobre os serviços da AWS 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](images/scorekeep-servicemap.png)
O X-Ray fornece um SDK que você pode usar para instrumentar o código da aplicação, e uma aplicação daemon que transmite as informações de depuração do SDK para a API do X-Ray.
Plataformas compatíveis
É possível usar o SDK do X-Ray 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
Nas plataformas compatíveis, é possível usar uma opção de configuração para executar o daemon do X-Ray nas instâncias do ambiente. Você pode habilitar o daemon no console do Elastic Beanstalk ou usando um arquivo de configuração.
Para fazer upload de dados no X-Ray, o daemon do X-Ray exige permissões do IAM na política gerenciada AWSXrayWriteOnlyAccess. 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 do Daemon para Enviar Dados ao X-Ray no Guia do desenvolvedor do AWS X-Ray.
A depuração com o X-Ray requer o uso do SDK do 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 Fazer Download e Executar o Daemon do X-Ray Manualmente (Avançado) no Guia do desenvolvedor do AWS X-Ray.
Configurar depuração
É possível habilitar daemon do X-Ray em um ambiente em execução no console do Elastic Beanstalk.
Como habilitar a depuração no console do Elastic Beanstalk
Abra o console do Elastic Beanstalk
e, na lista Regions (Regiões), selecione a sua Região da AWS. -
No painel de navegação, selecione Ambientes e selecione o nome do ambiente na lista.
nota
Se você tiver muitos ambientes, use a barra de pesquisa para filtrar a lista de ambientes.
No painel de navegação, escolha Configuration (Configuração).
-
Na categoria de configuração Updates, monitoring, and logging (Atualizações, monitoramento e logs), escolha Edit (Editar).
-
Na seção Amazon X-Ray, selecione Ativado.
-
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.config
option_settings:
aws:elasticbeanstalk:xray:
XRayEnabled: true