

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

# Configurando a depuração AWS X-Ray
<a name="environment-configuration-debugging"></a>

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**  
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 AWS serviços oferecidos em cada região, consulte a [tabela de regiões](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/).

![O mapa de serviço para uma aplicação de API Web que usa o Amazon DynamoDB para armazenar dados](http://docs.aws.amazon.com/pt_br/elasticbeanstalk/latest/dg/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](#environment-configuration-debugging-console) ou usando um [arquivo de configuração](#environment-configuration-debugging-namespace).

Para fazer upload de dados para o X-Ray, o daemon X-Ray requer permissões do IAM na política **AWSXrayWriteOnlyAccess**gerenciada. Essas permissões são incluídas no [perfil da instância do Elastic Beanstalk](concepts-roles-instance.md). Se você não usa o perfil de instância padrão, consulte [Conceder Permissão do Daemon para Enviar Dados ao X-Ray](https://docs.aws.amazon.com/xray/latest/devguide/xray-daemon.html#xray-daemon-permissions) 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](https://docs.aws.amazon.com/xray/latest/devguide/xray-gettingstarted.html) 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)](https://docs.aws.amazon.com/xray/latest/devguide/xray-daemon-beanstalk.html#xray-daemon-beanstalk-manual) no *Guia do desenvolvedor do AWS X-Ray *.

**Topics**
+ [Configurar depuração do](#environment-configuration-debugging-console)
+ [O namespace aws:elasticbeanstalk:xray](#environment-configuration-debugging-namespace)

## Configurar depuração do
<a name="environment-configuration-debugging-console"></a>

É 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**

1. Abra o console do [Elastic](https://console.aws.amazon.com/elasticbeanstalk) Beanstalk e, **na** lista Regiões, selecione sua. Região da AWS

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

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

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

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

1. 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](environments-create-wizard.md).

## O namespace aws:elasticbeanstalk:xray
<a name="environment-configuration-debugging-namespace"></a>

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](ebextensions.md) no código-fonte, como a seguir.

**Example .ebextensions/debugging.config**  

```
option_settings:
  aws:elasticbeanstalk:xray:
    XRayEnabled: true
```