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 daemon
**nota**
Aviso de SDK/Daemon manutenção do X-Ray — Em 25 de fevereiro de 2026, o AWS X-Ray SDKs/Daemon entrará no modo de manutenção, onde AWS limitará as versões 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](xray-sdk-daemon-timeline.md). Recomendamos migrar para o. OpenTelemetry Para obter mais informações sobre a migração para OpenTelemetry, consulte [Migrando da instrumentação X-Ray para a instrumentação](https://docs.aws.amazon.com/xray/latest/devguide/xray-sdk-migration.html). OpenTelemetry
**nota**
Agora você pode usar o CloudWatch agente para coletar métricas, registros e rastreamentos de instâncias do Amazon EC2 e servidores locais. CloudWatch O agente versão 1.300025.0 e posterior pode coletar traços de nosso cliente [OpenTelemetry](xray-instrumenting-your-app.md#xray-instrumenting-opentel)X-Ray e enviá-los para o [ SDKsX-Ray](xray-instrumenting-your-app.md#xray-instrumenting-xray-sdk). Usar o CloudWatch agente em vez do AWS Distro for OpenTelemetry (ADOT) Collector ou do daemon X-Ray para coletar traços pode ajudar a reduzir o número de agentes que você gerencia. Consulte o tópico do [CloudWatch agente](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Install-CloudWatch-Agent.html) no Guia do CloudWatch usuário para obter mais informações.
O AWS X-Ray daemon é um aplicativo de software que escuta o tráfego na porta UDP 2000, reúne dados brutos do segmento e os retransmite para a API. AWS X-Ray O daemon funciona em conjunto com o AWS X-Ray SDKs e deve estar em execução para que os dados enviados pelo SDKs possam chegar ao serviço X-Ray. O daemon do X-Ray é um projeto de código-fonte aberto. Você pode acompanhar o projeto e enviar problemas e pull requests em GitHub: [github. com/aws/aws-xray-daemon](https://github.com/aws/aws-xray-daemon)
Em seguida AWS Lambda AWS Elastic Beanstalk, use a integração desses serviços com o X-Ray para executar o daemon. O Lambda executa o daemon automaticamente sempre que uma função é invocada para uma solicitação amostrada. No Elastic Beanstalk, [use a opção de configuração `XRayEnabled`](xray-daemon-beanstalk.md) para executar o daemon nas instâncias do ambiente. Para obter mais informações, consulte .
Para executar o daemon X-Ray localmente, localmente ou em outro local, baixe-o Serviços da AWS, [execute-o](#xray-daemon-running) e, em seguida, [conceda permissão para carregar documentos](#xray-daemon-permissions) do segmento no X-Ray.
## Baixar o daemon
Você pode baixar o daemon do Amazon S3, Amazon ECR ou Docker Hub e, em seguida, executá-lo localmente ou instalá-lo em uma instância do Amazon EC2 na inicialização.
------
#### [ Amazon S3 ]
**Instaladores e executáveis do daemon do X-Ray**
+ **Linux (executável)**: [https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-linux-3.x.zip](https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-linux-3.x.zip) ([sig](https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-linux-3.x.zip.sig))
+ **Linux (instalador RPM)**: [https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-3.x.rpm](https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-3.x.rpm)
+ **Linux (instalador DEB)**: [https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-3.x.deb](https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-3.x.deb)
+ **Linux (ARM64, executável)** — [https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-linux-arm64-3.x.zip](https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-linux-arm64-3.x.zip)([sig](https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-linux-arm64-3.x.zip.sig))
+ **Linux (ARM64, instalador RPM)** — [https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-arm64-3.x.rpm](https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-arm64-3.x.rpm)
+ **Linux (ARM64, instalador de DEB)** — [https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-arm64-3.x.deb](https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-arm64-3.x.deb)
+ **OS X (executável)**: [https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-macos-3.x.zip](https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-macos-3.x.zip) ([sig](https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-macos-3.x.zip.sig))
+ **Windows (executável)**: [https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-windows-process-3.x.zip](https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-windows-process-3.x.zip) ([sig](https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-windows-process-3.x.zip.sig))
+ **Windows (serviço)**: [https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-windows-service-3.x.zip](https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-windows-service-3.x.zip) ([sig](https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-windows-service-3.x.zip.sig))
Esses links sempre apontam para a versão 3.x mais recente do daemon. Para baixar uma versão específica, faça o seguinte:
+ Para baixar uma versão anterior à versão `3.3.0`, substitua `3.x` pelo número da versão. Por exemplo, .`2.1.0` Antes da versão `3.3.0`, a única arquitetura disponível é `arm64`. Por exemplo, `2.1.0` e `arm64`.
+ Para baixar uma versão posterior à versão `3.3.0`, substitua `3.x` pelo número da versão e `arch` pelo tipo de arquitetura.
Os ativos do X-Ray são replicados para buckets em todas as regiões compatíveis. Para usar o bucket mais próximo de você ou de seus AWS recursos, substitua a região nos links acima pela sua região.
```
https://s3.us-west-2.amazonaws.com/aws-xray-assets.us-west-2/xray-daemon/aws-xray-daemon-3.x.rpm
```
------
#### [ Amazon ECR ]
A partir da versão 3.2.0, o daemon pode ser encontrado no [Amazon ECR](https://gallery.ecr.aws/xray/aws-xray-daemon). Antes de extrair uma imagem, você deve [autenticar o cliente do Docker](https://docs.aws.amazon.com/AmazonECR/latest/public/public-registries.html#public-registry-auth) no registro público do Amazon ECR.
Obtenha a tag da versão 3.x lançada mais recente executando o seguinte comando:
```
docker pull public.ecr.aws/xray/aws-xray-daemon:3.x
```
As versões anteriores ou alfa podem ser baixadas substituindo `3.x` por `alpha` ou um número de versão específico. Não é recomendável usar uma imagem do daemon com uma tag alfa em um ambiente de produção.
------
#### [ Docker Hub ]
O daemon pode ser encontrado no [Docker Hub](https://hub.docker.com/r/amazon/aws-xray-daemon). Para baixar a versão 3.x lançada mais recente, execute o seguinte comando:
```
docker pull amazon/aws-xray-daemon:3.x
```
As versões anteriores do daemon podem ser lançadas substituindo `3.x` pela versão desejada.
------
## Verificar a assinatura de arquivamento do daemon
Os arquivos de assinatura GPG são incluídos para ativos do daemon compactados em arquivos ZIP. A chave pública está aqui: [https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray.gpg](https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray.gpg).
Você pode usar a chave pública para verificar se o arquivo morto ZIP do daemon é original e não modificado. Primeiro, importe a chave pública com [GnuPG](https://gnupg.org/index.html).
**Para importar a chave pública**
1. Baixar a chave pública.
```
$ BUCKETURL=https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2
$ wget $BUCKETURL/xray-daemon/aws-xray.gpg
```
1. Importe a chave pública em seu token de autenticação.
```
$ gpg --import aws-xray.gpg
gpg: /Users/me/.gnupg/trustdb.gpg: trustdb created
gpg: key 7BFE036BFE6157D3: public key "AWS X-Ray " imported
gpg: Total number processed: 1
gpg: imported: 1
```
Use a chave importada para verificar a assinatura do arquivo morto ZIP do daemon.
**Para verificar a assinatura de um arquivo morto**
1. Baixe o arquivo morto e do arquivo de assinatura.
```
$ BUCKETURL=https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2
$ wget $BUCKETURL/xray-daemon/aws-xray-daemon-linux-3.x.zip
$ wget $BUCKETURL/xray-daemon/aws-xray-daemon-linux-3.x.zip.sig
```
1. Execute `gpg --verify` para verificar a assinatura.
```
$ gpg --verify aws-xray-daemon-linux-3.x.zip.sig aws-xray-daemon-linux-3.x.zip
gpg: Signature made Wed 19 Apr 2017 05:06:31 AM UTC using RSA key ID FE6157D3
gpg: Good signature from "AWS X-Ray "
gpg: WARNING: This key is not certified with a trusted signature!
gpg: There is no indication that the signature belongs to the owner.
Primary key fingerprint: EA6D 9271 FBF3 6990 277F 4B87 7BFE 036B FE61 57D3
```
Observe o aviso sobre confiança. Uma chave só será confiável se você ou alguém em quem você confia a tiver assinado. Isso não significa que a assinatura é inválida, apenas que você não verificou a chave pública.
## Execução do daemon
Execute o daemon localmente na linha de comando. Use a opção `-o` para executar em modo local e `-n` para definir a região.
```
~/Downloads$ ./xray -o -n us-east-2
```
Para obter instruções específicas da plataforma, consulte os tópicos a seguir:
+ **Linux (local)**: [Executar o daemon do X-Ray no Linux](xray-daemon-local.md#xray-daemon-local-linux)
+ **Windows (local)**: [Executar o daemon do X-Ray-Ray no Windows](xray-daemon-local.md#xray-daemon-local-windows)
+ **Elastic Beanstalk**: [Executando o daemon X-Ray em AWS Elastic Beanstalk](xray-daemon-beanstalk.md)
+ **Amazon EC2**: [Executando o daemon X-Ray na Amazon EC2](xray-daemon-ec2.md)
+ **Amazon ECS**: [Executar o daemon do X-Ray no Amazon ECS](xray-daemon-ecs.md)
É possível personalizar ainda mais o comportamento do daemon usando as opções de linha de comando ou um arquivo de configuração. Para mais detalhes, consulte [Configurando o daemon AWS X-Ray](xray-daemon-configuration.md).
## Conceder permissão ao daemon para enviar dados ao X-Ray
O daemon X-Ray usa o AWS SDK para carregar dados de rastreamento no X-Ray e precisa de AWS credenciais com permissão para fazer isso.
No Amazon EC2, o daemon usa a perfil da instância automaticamente. Para obter informações sobre as credenciais necessárias para executar o daemon localmente, consulte [Executar o aplicativo localmente](security_iam_service-with-iam.md#xray-permissions-local).
Se você especificar as credenciais em mais de um local (arquivo de credenciais, perfil da instância ou variáveis de ambiente), a cadeia de fornecedores de SDK determinará quais credenciais serão usadas. Para obter mais informações sobre o fornecimento de credenciais para o SDK, consulte [Specifying Credentials](https://aws.github.io/aws-sdk-go-v2/docs/configuring-sdk/#specifying-credentials) no *Guia do desenvolvedor do AWS SDK para Go*.
O usuário ou perfil do IAM a que as credenciais do daemon pertencem devem ter permissão para gravar dados no serviço em seu nome.
+ Para usar o daemon no Amazon EC2, crie uma nova função de perfil de instância ou adicione a política gerenciada a uma existente.
+ Para usar o daemon no Elastic Beanstalk, adicione a política gerenciada à função de perfil de instância padrão do Elastic Beanstalk.
+ Para executar o daemon localmente, consulte [Executar o aplicativo localmente](security_iam_service-with-iam.md#xray-permissions-local).
Para obter mais informações, consulte [Gerenciamento de identidade e acesso para AWS X-Ray](security-iam.md).
## Logs do daemon do X-Ray
O daemon gera informações sobre sua configuração atual e os segmentos para os quais ele envia. AWS X-Ray
```
2016-11-24T06:07:06Z [Info] Initializing AWS X-Ray daemon 2.1.0
2016-11-24T06:07:06Z [Info] Using memory limit of 49 MB
2016-11-24T06:07:06Z [Info] 313 segment buffers allocated
2016-11-24T06:07:08Z [Info] Successfully sent batch of 1 segments (0.123 seconds)
2016-11-24T06:07:09Z [Info] Successfully sent batch of 1 segments (0.006 seconds)
```
Por padrão, o daemon gera logs para STDOUT. Se você executar o daemon em segundo plano, use a opção de linha de comando `--log-file` ou um arquivo de configuração para definir o caminho do arquivo de log. Você também pode definir o nível de registro em log e desabilitar a rotação de logs. Para obter instruções, consulte [Configurando o daemon AWS X-Ray](xray-daemon-configuration.md).
No Elastic Beanstalk, a plataforma define a localização dos logs do daemon. Para mais detalhes, consulte [Executando o daemon X-Ray em AWS Elastic Beanstalk](xray-daemon-beanstalk.md).
# Configurando o daemon AWS X-Ray
**nota**
Aviso de SDK/Daemon manutenção do X-Ray — Em 25 de fevereiro de 2026, o AWS X-Ray SDKs/Daemon entrará no modo de manutenção, onde AWS limitará as versões 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](xray-sdk-daemon-timeline.md). Recomendamos migrar para o. OpenTelemetry Para obter mais informações sobre a migração para OpenTelemetry, consulte [Migrando da instrumentação X-Ray para a instrumentação](https://docs.aws.amazon.com/xray/latest/devguide/xray-sdk-migration.html). OpenTelemetry
É possível usar opções de linha de comandos ou um arquivo de configuração para personalizar o comportamento do daemon do X-Ray. A maioria das opções estão disponíveis usando os dois métodos, mas alguns só estão disponíveis em arquivos de configuração e outros somente na linha de comando.
Para começar, a única opção necessária é `-n` ou `--region`, usada para definir a região que o daemon utilizará para enviar os dados de rastreamento ao X-Ray.
```
~/xray-daemon$ ./xray -n us-east-2
```
Se você estiver executando o daemon localmente, ou seja, não na Amazon EC2, poderá adicionar a `-o` opção de ignorar a verificação das credenciais do perfil da instância para que o daemon fique pronto mais rapidamente.
```
~/xray-daemon$ ./xray -o -n us-east-2
```
As demais opções de linha de comandos permitem que você configure o registro em log, escute em uma porta diferente, limite a quantidade de memória que o daemon pode usar ou assuma um perfil para enviar dados de rastreamento a uma conta diferente.
Você pode passar um arquivo de configuração ao daemon para acessar as opções de configuração avançadas e executar tarefas, como limitar o número de chamadas simultâneas para o X-Ray, desabilitar a alternância de logs e enviar tráfego a um proxy.
**Topics**
+ [Variáveis de ambiente compatíveis](#xray-daemon-configuration-variables)
+ [Usar as opções de linha de comando](#xray-daemon-configuration-commandline)
+ [Usar um arquivo de configuração](#xray-daemon-configuration-configfile)
## Variáveis de ambiente compatíveis
O daemon do X-Ray é compatível com as seguintes variáveis de ambiente:
+ `AWS_REGION`: especifica a [Região da AWS](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html#cli-quick-configuration-region) do endpoint de serviço do X-Ray.
+ `HTTPS_PROXY`: especifica um endereço de proxy pelo qual o daemon carregará os segmentos. Isso pode ser os nomes de domínio DNS ou endereços IP e números de porta usados pelos servidores de proxy.
## Usar as opções de linha de comando
Passe essas opções para o daemon quando você executá-lo localmente ou com um script de dados do usuário.
**Opções de linha de comando**
+ `-b`, `--bind`: escutar os documentos de segmentos em uma porta UDP diferente.
```
--bind "127.0.0.1:3000"
```
Padrão: `2000`.
+ `-t`, `--bind-tcp`: escutar chamadas ao serviço X-Ray em uma porta TCP diferente.
```
-bind-tcp "127.0.0.1:3000"
```
Padrão: `2000`.
+ `-c`, `--config`: carregar um arquivo de configuração do caminho especificado.
```
--config "/home/ec2-user/xray-daemon.yaml"
```
+ `-f`, `--log-file`: gerar logs de saída para o caminho do arquivo especificado.
```
--log-file "/var/log/xray-daemon.log"
```
+ `-l`, `--log-level`: nível de log, do mais para o menos detalhado: dev, debug, info, warn, error, prod.
```
--log-level warn
```
Padrão: `prod`
+ `-m`, `--buffer-memory`: alterar a quantidade de memória em MB que os buffers podem usar (3, no mínimo).
```
--buffer-memory 50
```
Padrão: 1% de memória disponível.
+ `-o`, `--local-mode` — Não verifique, por EC2 exemplo, os metadados.
+ `-r`, `--role-arn`: assumir o perfil do IAM especificado para carregar os segmentos para uma conta diferente.
```
--role-arn "arn:aws:iam::123456789012:role/xray-cross-account"
```
+ `-a`, `--resource-arn` — Nome de recurso da Amazon (ARN) do AWS recurso que executa o daemon.
+ `-p`, `--proxy-address` — Faça upload de segmentos AWS X-Ray por meio de um proxy. O protocolo do servidor proxy deve ser especificado.
```
--proxy-address "http://192.0.2.0:3000"
```
+ `-n`, `--region`: enviar segmentos para o serviço X-Ray em uma região específica.
+ `-v`, `--version` — Mostra a versão AWS X-Ray do daemon.
+ `-h`, `--help`: mostrar a tela de ajuda.
## Usar um arquivo de configuração
Também é possível usar um arquivo de formato YAML para configurar o daemon. Passe o arquivo de configuração para o daemon usando a opção `-c`.
```
~$ ./xray -c ~/xray-daemon.yaml
```
**Opções do arquivo de configuração**
+ `TotalBufferSizeMB`: tamanho máximo do buffer em MB (3, no mínimo). Escolha 0 para usar 1% da memória de host.
+ `Concurrency`— Número máximo de chamadas simultâneas AWS X-Ray para carregar documentos do segmento.
+ `Region`— Envie segmentos para AWS X-Ray atendimento em uma região específica.
+ `Socket`: configurar a vinculação do daemon.
+ `UDPAddress`: alterar a porta em que o daemon escuta.
+ `TCPAddress`: escutar [chamadas para o serviço do X-Ray](xray-api-sampling.md) em uma porta TCP diferente.
+ `Logging`: configurar o comportamento do registro em log.
+ `LogRotation`: definir como `false` para desabilitar a alternância de logs.
+ `LogLevel`: alterar o nível de log, do mais para o menos detalhado: `dev`, `debug`, `info` ou `prod`, `warn`, `error`, `prod`. O padrão é `prod`, que é equivalente a `info`.
+ `LogPath`: gerar logs para o caminho do arquivo especificado.
+ `LocalMode`— Defina como `true` para ignorar a verificação dos metadados da EC2 instância.
+ `ResourceARN`— Nome de recurso da Amazon (ARN) do AWS recurso que executa o daemon.
+ `RoleARN`: assumir o perfil do IAM especificado faça carregar os segmentos para uma conta diferente.
+ `ProxyAddress`— Faça upload de segmentos AWS X-Ray por meio de um proxy.
+ `Endpoint`: alterar o endpoint de serviço do X-Ray para o qual o daemon envia documentos de segmentos.
+ `NoVerifySSL`: desabilitar a verificação do certificado TLS.
+ `Version`: versão do formato de arquivo de configuração do daemon. A versão do formato do arquivo é um campo **obrigatório**.
**Example Xray-daemon.yaml**
Esse arquivo de configuração altera a porta de escuta do daemon para 3000, desativa verificações de metadados da instância, define um perfil a ser usado para fazer upload de segmentos e altera opções de região e registro em log.
```
Socket:
UDPAddress: "127.0.0.1:3000"
TCPAddress: "127.0.0.1:3000"
Region: "us-west-2"
Logging:
LogLevel: "warn"
LogPath: "/var/log/xray-daemon.log"
LocalMode: true
RoleARN: "arn:aws:iam::123456789012:role/xray-cross-account"
Version: 2
```
# Executar o daemon do X-Ray localmente
**nota**
Aviso de SDK/Daemon manutenção do X-Ray — Em 25 de fevereiro de 2026, o AWS X-Ray SDKs/Daemon entrará no modo de manutenção, onde AWS limitará as versões 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](xray-sdk-daemon-timeline.md). Recomendamos migrar para o. OpenTelemetry Para obter mais informações sobre a migração para OpenTelemetry, consulte [Migrando da instrumentação X-Ray para a instrumentação](https://docs.aws.amazon.com/xray/latest/devguide/xray-sdk-migration.html). OpenTelemetry
Você pode executar o AWS X-Ray daemon localmente no Linux, macOS, Windows ou em um contêiner Docker. Execute o daemon para retransmitir os dados de rastreamento ao X-Ray quando você estiver desenvolvendo e testando seu aplicativo instrumentada. Baixe e extraia o daemon usando essas [instruções](xray-daemon.md#xray-daemon-downloading).
Ao ser executado localmente, o daemon pode ler as credenciais de um arquivo de credenciais do AWS SDK (`.aws/credentials`no seu diretório de usuário) ou de variáveis de ambiente. Para obter mais informações, consulte [Conceder permissão ao daemon para enviar dados ao X-Ray](xray-daemon.md#xray-daemon-permissions).
O daemon ouve dados UDP na porta 2000. Você pode alterar a porta e outras opções usando um arquivo de configuração e opções de linha de comando. Para obter mais informações, consulte [Configurando o daemon AWS X-Ray](xray-daemon-configuration.md).
## Executar o daemon do X-Ray no Linux
Você pode executar o daemon executável na linha de comando. Use a opção `-o` para executar em modo local e `-n` para definir a região.
```
~/xray-daemon$ ./xray -o -n us-east-2
```
Para executar o daemon em segundo plano, use `&`.
```
~/xray-daemon$ ./xray -o -n us-east-2 &
```
Encerre um processo de daemon em execução em segundo plano com `pkill`.
```
~$ pkill xray
```
## Executar o daemon do X-Ray em um contêiner do Docker
Para executar o daemon localmente em um contêiner do Docker, salve o texto a seguir em um arquivo chamado `Dockerfile`. Baixe a [imagem de exemplo](https://gallery.ecr.aws/xray/aws-xray-daemon) completa no Amazon ECR. Para obter mais informações, consulte [Baixar o daemon](xray-daemon.md#xray-daemon-downloading).
**Example Dockerfile: Amazon Linux**
```
FROM amazonlinux
RUN yum install -y unzip
RUN curl -o daemon.zip https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-linux-3.x.zip
RUN unzip daemon.zip && cp xray /usr/bin/xray
ENTRYPOINT ["/usr/bin/xray", "-t", "0.0.0.0:2000", "-b", "0.0.0.0:2000"]
EXPOSE 2000/udp
EXPOSE 2000/tcp
```
Crie a imagem do contêiner com o `docker build`.
```
~/xray-daemon$ docker build -t xray-daemon .
```
Execute a imagem em um contêiner com o `docker run`.
```
~/xray-daemon$ docker run \
--attach STDOUT \
-v ~/.aws/:/root/.aws/:ro \
--net=host \
-e AWS_REGION=us-east-2 \
--name xray-daemon \
-p 2000:2000/udp \
xray-daemon -o
```
Este comando usa as seguintes opções:
+ `--attach STDOUT`: visualizar a saída do daemon no terminal.
+ `-v ~/.aws/:/root/.aws/:ro`— Dê ao contêiner acesso somente de leitura ao `.aws` diretório para permitir que ele leia suas credenciais do AWS SDK.
+ `AWS_REGION=us-east-2`: definir a variável de ambiente da `AWS_REGION` para informar ao daemon a região a ser usada.
+ `--net=host`: anexar o contêiner à rede do `host`. Os contêineres na rede host podem se comunicar entre si sem as portas de publicação.
+ `-p 2000:2000/udp`: mapear a porta UDP 2000 no computador para a mesma porta no contêiner. Isso não é necessário para a comunicação entre contêineres na mesma rede, mas permite que você envie segmentos para o daemon [a partir da linha de comando](xray-api-sendingdata.md#xray-api-daemon) ou de um aplicativo que não está em execução no Docker.
+ `--name xray-daemon`: nomear o contêiner como `xray-daemon` em vez de gerar um nome aleatório.
+ `-o` (após o nome da imagem): anexar a opção `-o` ao ponto de entrada que executa o daemon dentro do contêiner. Essa opção faz com que o daemon seja executado no modo local para evitar que ele tente ler os metadados da EC2 instância Amazon.
Para interromper o daemon, use `docker stop`. Se você fizer alterações no `Dockerfile` e criar uma nova imagem, precisará excluir o contêiner existente antes de criar um outro com o mesmo nome. Use `docker rm` para excluir o contêiner.
```
$ docker stop xray-daemon
$ docker rm xray-daemon
```
## Executar o daemon do X-Ray-Ray no Windows
Você pode executar o daemon executável na linha de comando. Use a opção `-o` para executar em modo local e `-n` para definir a região.
```
> .\xray_windows.exe -o -n us-east-2
```
Use um PowerShell script para criar e executar um serviço para o daemon.
**Example PowerShell script - Windows**
```
if ( Get-Service "AWSXRayDaemon" -ErrorAction SilentlyContinue ){
sc.exe stop AWSXRayDaemon
sc.exe delete AWSXRayDaemon
}
if ( Get-Item -path aws-xray-daemon -ErrorAction SilentlyContinue ) {
Remove-Item -Recurse -Force aws-xray-daemon
}
$currentLocation = Get-Location
$zipFileName = "aws-xray-daemon-windows-service-3.x.zip"
$zipPath = "$currentLocation\$zipFileName"
$destPath = "$currentLocation\aws-xray-daemon"
$daemonPath = "$destPath\xray.exe"
$daemonLogPath = "C:\inetpub\wwwroot\xray-daemon.log"
$url = "https://s3.dualstack.us-west-2.amazonaws.com/aws-xray-assets.us-west-2/xray-daemon/aws-xray-daemon-windows-service-3.x.zip"
Invoke-WebRequest -Uri $url -OutFile $zipPath
Add-Type -Assembly "System.IO.Compression.Filesystem"
[io.compression.zipfile]::ExtractToDirectory($zipPath, $destPath)
sc.exe create AWSXRayDaemon binPath= "$daemonPath -f $daemonLogPath"
sc.exe start AWSXRayDaemon
```
## Executar o daemon do X-Ray no OS X
Você pode executar o daemon executável na linha de comando. Use a opção `-o` para executar em modo local e `-n` para definir a região.
```
~/xray-daemon$ ./xray_mac -o -n us-east-2
```
Para executar o daemon em segundo plano, use `&`.
```
~/xray-daemon$ ./xray_mac -o -n us-east-2 &
```
Use `nohup` para evitar que o daemon seja encerrado quando o terminal for fechado.
```
~/xray-daemon$ nohup ./xray_mac &
```
# Executando o daemon X-Ray em AWS Elastic Beanstalk
**nota**
Aviso de SDK/Daemon manutenção do X-Ray — Em 25 de fevereiro de 2026, o AWS X-Ray SDKs/Daemon entrará no modo de manutenção, onde AWS limitará as versões 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](xray-sdk-daemon-timeline.md). Recomendamos migrar para o. OpenTelemetry Para obter mais informações sobre a migração para OpenTelemetry, consulte [Migrando da instrumentação X-Ray para a instrumentação](https://docs.aws.amazon.com/xray/latest/devguide/xray-sdk-migration.html). OpenTelemetry
Para retransmitir dados de rastreamento do seu aplicativo para AWS X-Ray, você pode executar o daemon X-Ray nas instâncias do Amazon EC2 do seu ambiente Elastic Beanstalk. Para obter uma lista de plataformas compatíveis, consulte [Configurar depuração do AWS X-Ray](https://docs.aws.amazon.com/elasticbeanstalk/latest/dg/environment-configuration-debugging.html) no *Guia do desenvolvedor do AWS Elastic Beanstalk *.
**nota**
O daemon usa seu perfil de instância do ambiente para permissões. Para obter instruções sobre como adicionar permissões ao perfil de instância do Elastic Beanstalk, consulte [Conceder permissão ao daemon para enviar dados ao X-Ray](xray-daemon.md#xray-daemon-permissions).
As plataformas do Elastic Beanstalk fornecem uma opção de configuração que você pode definir para executar o daemon automaticamente. Você pode habilitar o daemon em um arquivo de configuração em seu código-fonte ou selecionar uma opção no console do Elastic Beanstalk. Quando você habilita a opção de configuração, o daemon é instalado na instância e é executado como um serviço.
A versão incluída nas plataformas do Elastic Beanstalk pode não ser a versão mais recente. Consulte o [tópico Plataformas suportadas](https://docs.aws.amazon.com/elasticbeanstalk/latest/dg/concepts.platforms.html) para descobrir a versão do daemon que está disponível para a configuração da sua plataforma.
O Elastic Beanstalk não fornece o daemon do X-Ray na plataforma Docker de vários contêineres (Amazon ECS).
## Usar a integração entre do X-Ray com o Elastic Beanstalk para executar o daemon do X-Ray
Use o console para ativar a integração do X-Ray ou configure-o no código-fonte do aplicativo com um arquivo de configuração.
**Como habilitar o daemon do X-Ray no console do Elastic Beanstalk**
1. Abra o [console do Elastic Beanstalk](https://console.aws.amazon.com/elasticbeanstalk).
1. Navegue até o [console de gerenciamento](https://docs.aws.amazon.com/elasticbeanstalk/latest/dg/environments-console.html) do seu ambiente.
1. Escolher **configuração**.
1. Escolha **Software Settings**.
1. Para o **X-Ray daemon**, escolha **Enabled**.
1. Escolha **Aplicar**.
Você pode incluir um arquivo de configuração em seu código-fonte para tornar sua configuração portátil entre ambientes.
**Example .ebextensions/xray-daemon.config**
```
option_settings:
aws:elasticbeanstalk:xray:
XRayEnabled: true
```
O Elastic Beanstalk transmite um arquivo de configuração ao daemon e emite logs para um local padrão.
**Nas Plataformas do Windows Server**
+ **Arquivo de configuração**: `C:\Program Files\Amazon\XRay\cfg.yaml`
+ **Logs**: `c:\Program Files\Amazon\XRay\logs\xray-service.log`
**Nas Plataformas Linux**
+ **Arquivo de configuração**: `/etc/amazon/xray/cfg.yaml`
+ **Logs**: `/var/log/xray/xray.log`
O Elastic Beanstalk fornece ferramentas para extrair registros de instâncias da linha de comando ou. Console de gerenciamento da AWS Você pode instruir o Elastic Beanstalk a incluir os logs do daemon do X-Ray adicionando uma tarefa com um arquivo de configuração.
**Example .ebextensions/xray-logs.config – Linux**
```
files:
"/opt/elasticbeanstalk/tasks/taillogs.d/xray-daemon.conf" :
mode: "000644"
owner: root
group: root
content: |
/var/log/xray/xray.log
```
**Example .ebextensions/xray-logs.config – Windows Server**
```
files:
"c:/Program Files/Amazon/ElasticBeanstalk/config/taillogs.d/xray-daemon.conf" :
mode: "000644"
owner: root
group: root
content: |
c:\Progam Files\Amazon\XRay\logs\xray-service.log
```
Consulte [Visualizar logs de instâncias do Amazon EC2 no ambiente do Elastic Beanstalk](https://docs.aws.amazon.com/elasticbeanstalk/latest/dg/using-features.logging.html) no *Guia do desenvolvedor do AWS Elastic Beanstalk * para obter mais informações.
## Baixar e executar o daemon do X-Ray manualmente (avançado)
Se o daemon do X-Ray não estiver disponível para a configuração de sua plataforma, você poderá baixá-lo pelo Amazon S3 e executá-lo com um arquivo de configuração.
Use um arquivo de configuração do Elastic Beanstalk para baixar e executar o daemon.
**Example .ebextensions/xray.config: Linux**
```
commands:
01-stop-tracing:
command: yum remove -y xray
ignoreErrors: true
02-copy-tracing:
command: curl https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-3.x.rpm -o /home/ec2-user/xray.rpm
03-start-tracing:
command: yum install -y /home/ec2-user/xray.rpm
files:
"/opt/elasticbeanstalk/tasks/taillogs.d/xray-daemon.conf" :
mode: "000644"
owner: root
group: root
content: |
/var/log/xray/xray.log
"/etc/amazon/xray/cfg.yaml" :
mode: "000644"
owner: root
group: root
content: |
Logging:
LogLevel: "debug"
Version: 2
```
**Example .ebextensions/xray.config – Windows Server**
```
container_commands:
01-execute-config-script:
command: Powershell.exe -ExecutionPolicy Bypass -File c:\\temp\\installDaemon.ps1
waitAfterCompletion: 0
files:
"c:/temp/installDaemon.ps1":
content: |
if ( Get-Service "AWSXRayDaemon" -ErrorAction SilentlyContinue ) {
sc.exe stop AWSXRayDaemon
sc.exe delete AWSXRayDaemon
}
$targetLocation = "C:\Program Files\Amazon\XRay"
if ((Test-Path $targetLocation) -eq 0) {
mkdir $targetLocation
}
$zipFileName = "aws-xray-daemon-windows-service-3.x.zip"
$zipPath = "$targetLocation\$zipFileName"
$destPath = "$targetLocation\aws-xray-daemon"
if ((Test-Path $destPath) -eq 1) {
Remove-Item -Recurse -Force $destPath
}
$daemonPath = "$destPath\xray.exe"
$daemonLogPath = "$targetLocation\xray-daemon.log"
$url = "https://s3.dualstack.us-west-2.amazonaws.com/aws-xray-assets.us-west-2/xray-daemon/aws-xray-daemon-windows-service-3.x.zip"
Invoke-WebRequest -Uri $url -OutFile $zipPath
Add-Type -Assembly "System.IO.Compression.Filesystem"
[io.compression.zipfile]::ExtractToDirectory($zipPath, $destPath)
New-Service -Name "AWSXRayDaemon" -StartupType Automatic -BinaryPathName "`"$daemonPath`" -f `"$daemonLogPath`""
sc.exe start AWSXRayDaemon
encoding: plain
"c:/Program Files/Amazon/ElasticBeanstalk/config/taillogs.d/xray-daemon.conf" :
mode: "000644"
owner: root
group: root
content: |
C:\Program Files\Amazon\XRay\xray-daemon.log
```
Esses exemplos também adicionam o arquivo de log do daemon à tarefa de logs finais do Elastic Beanstalk, para que ele esteja incluído quando você solicitar logs com o console ou com a interface de linha de comandos (CLI do EB) do Elastic Beanstalk.
# Executando o daemon X-Ray na Amazon EC2
**nota**
Aviso de SDK/Daemon manutenção do X-Ray — Em 25 de fevereiro de 2026, o AWS X-Ray SDKs/Daemon entrará no modo de manutenção, onde AWS limitará as versões 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](xray-sdk-daemon-timeline.md). Recomendamos migrar para o. OpenTelemetry Para obter mais informações sobre a migração para OpenTelemetry, consulte [Migrando da instrumentação X-Ray para a instrumentação](https://docs.aws.amazon.com/xray/latest/devguide/xray-sdk-migration.html). OpenTelemetry
Você pode executar o daemon X-Ray nos seguintes sistemas operacionais na Amazon: EC2
+ Amazon Linux
+ Ubuntu
+ Windows Server (2012 R2 e mais recente)
Use um perfil de instância para conceder ao daemon permissão para fazer upload de dados de rastreamento no X-Ray. Para obter mais informações, consulte [Conceder permissão ao daemon para enviar dados ao X-Ray](xray-daemon.md#xray-daemon-permissions).
Use um script de dados de usuário para executar o daemon automaticamente quando você iniciar a instância.
**Example Script de dados do usuário – Linux**
```
#!/bin/bash
curl https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-3.x.rpm -o /home/ec2-user/xray.rpm
yum install -y /home/ec2-user/xray.rpm
```
**Example Script de dados do usuário – Windows Server**
```
if ( Get-Service "AWSXRayDaemon" -ErrorAction SilentlyContinue ) {
sc.exe stop AWSXRayDaemon
sc.exe delete AWSXRayDaemon
}
$targetLocation = "C:\Program Files\Amazon\XRay"
if ((Test-Path $targetLocation) -eq 0) {
mkdir $targetLocation
}
$zipFileName = "aws-xray-daemon-windows-service-3.x.zip"
$zipPath = "$targetLocation\$zipFileName"
$destPath = "$targetLocation\aws-xray-daemon"
if ((Test-Path $destPath) -eq 1) {
Remove-Item -Recurse -Force $destPath
}
$daemonPath = "$destPath\xray.exe"
$daemonLogPath = "$targetLocation\xray-daemon.log"
$url = "https://s3.dualstack.us-west-2.amazonaws.com/aws-xray-assets.us-west-2/xray-daemon/aws-xray-daemon-windows-service-3.x.zip"
Invoke-WebRequest -Uri $url -OutFile $zipPath
Add-Type -Assembly "System.IO.Compression.Filesystem"
[io.compression.zipfile]::ExtractToDirectory($zipPath, $destPath)
New-Service -Name "AWSXRayDaemon" -StartupType Automatic -BinaryPathName "`"$daemonPath`" -f `"$daemonLogPath`""
sc.exe start AWSXRayDaemon
```
# Executar o daemon do X-Ray no Amazon ECS
**nota**
Aviso de SDK/Daemon manutenção do X-Ray — Em 25 de fevereiro de 2026, o AWS X-Ray SDKs/Daemon entrará no modo de manutenção, onde AWS limitará as versões 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](xray-sdk-daemon-timeline.md). Recomendamos migrar para o. OpenTelemetry Para obter mais informações sobre a migração para OpenTelemetry, consulte [Migrando da instrumentação X-Ray para a instrumentação](https://docs.aws.amazon.com/xray/latest/devguide/xray-sdk-migration.html). OpenTelemetry
No Amazon ECS, crie uma imagem do Docker que executa o daemon do X-Ray, carregue-a em um repositório de imagens do Docker e, em seguida, implante-a no cluster do Amazon ECS. Você pode usar os mapeamentos de porta e as configurações de modo de rede em seu arquivo de definição de tarefa para permitir que o aplicativo se comunique com o contêiner do daemon.
## Usar a imagem oficial do Docker da
O X-Ray fornece uma [imagem de contêiner](https://gallery.ecr.aws/xray/aws-xray-daemon) do Docker no Amazon ECR que você pode implantar com o aplicativo. Para obter mais informações, consulte [Baixar o daemon](xray-daemon.md#xray-daemon-downloading).
**Example definição da tarefa**
```
{
"name": "xray-daemon",
"image": "amazon/aws-xray-daemon",
"cpu": 32,
"memoryReservation": 256,
"portMappings" : [
{
"hostPort": 0,
"containerPort": 2000,
"protocol": "udp"
}
]
}
```
## Criar e compilar uma imagem do Docker
Para a configuração personalizada, pode ser necessário definir sua própria imagem do Docker.
Adicione políticas gerenciadas no perfil da tarefa para conceder ao daemon permissão para carregar dados de rastreamento no X-Ray. Para obter mais informações, consulte [Conceder permissão ao daemon para enviar dados ao X-Ray](xray-daemon.md#xray-daemon-permissions).
Use um dos seguintes Dockerfiles para criar uma imagem que executa o daemon.
**Example Dockerfile: Amazon Linux**
```
FROM amazonlinux
RUN yum install -y unzip
RUN curl -o daemon.zip https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-linux-3.x.zip
RUN unzip daemon.zip && cp xray /usr/bin/xray
ENTRYPOINT ["/usr/bin/xray", "-t", "0.0.0.0:2000", "-b", "0.0.0.0:2000"]
EXPOSE 2000/udp
EXPOSE 2000/tcp
```
**nota**
Os sinalizadores `-t` e `-b` são necessários para especificar um endereço de vinculação para ouvir o loopback de um ambiente com vários contêineres.
**Example Dockerfile: Ubuntu**
Para derivados do Debian, você também precisa instalar certificados da autoridade de certificação (CA) para evitar problemas ao baixar o instalador.
```
FROM ubuntu:16.04
RUN apt-get update && apt-get install -y --force-yes --no-install-recommends apt-transport-https curl ca-certificates wget && apt-get clean && apt-get autoremove && rm -rf /var/lib/apt/lists/*
RUN wget https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-3.x.deb
RUN dpkg -i aws-xray-daemon-3.x.deb
ENTRYPOINT ["/usr/bin/xray", "--bind=0.0.0.0:2000", "--bind-tcp=0.0.0.0:2000"]
EXPOSE 2000/udp
EXPOSE 2000/tcp
```
Na definição da tarefa, a configuração vai depender do modo de rede que você usa. A rede bridge é o padrão e pode ser usado na sua VPC padrão. Em uma rede de ponte, defina a variável de ambiente `AWS_XRAY_DAEMON_ADDRESS` para informar ao X-Ray SDK a qual porta de contêiner deve ser feita referência e defina a porta do host. Por exemplo, você poderia publicar a porta UDP 2000 e criar um link do contêiner do aplicativo para o contêiner do daemon.
**Example definição da tarefa**
```
{
"name": "xray-daemon",
"image": "123456789012.dkr.ecr.us-east-2.amazonaws.com/xray-daemon",
"cpu": 32,
"memoryReservation": 256,
"portMappings" : [
{
"hostPort": 0,
"containerPort": 2000,
"protocol": "udp"
}
]
},
{
"name": "scorekeep-api",
"image": "123456789012.dkr.ecr.us-east-2.amazonaws.com/scorekeep-api",
"cpu": 192,
"memoryReservation": 512,
"environment": [
{ "name" : "AWS_REGION", "value" : "us-east-2" },
{ "name" : "NOTIFICATION_TOPIC", "value" : "arn:aws:sns:us-east-2:123456789012:scorekeep-notifications" },
{ "name" : "AWS_XRAY_DAEMON_ADDRESS", "value" : "xray-daemon:2000" }
],
"portMappings" : [
{
"hostPort": 5000,
"containerPort": 5000
}
],
"links": [
"xray-daemon"
]
}
```
Se você executar o seu cluster na sub-rede privada de uma VPC, poderá usar o [`awsvpc` modo de rede](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-networking.html) para anexar uma interface de rede elástica (ENI) aos seus contêineres. Isso permite que você evite o uso de links. Omita a porta host nos mapeamentos de porta, o link e a variável de ambiente `AWS_XRAY_DAEMON_ADDRESS`.
**Example Definição de tarefa da VPC**
```
{
"family": "scorekeep",
"networkMode":"awsvpc",
"containerDefinitions": [
{
"name": "xray-daemon",
"image": "123456789012.dkr.ecr.us-east-2.amazonaws.com/xray-daemon",
"cpu": 32,
"memoryReservation": 256,
"portMappings" : [
{
"containerPort": 2000,
"protocol": "udp"
}
]
},
{
"name": "scorekeep-api",
"image": "123456789012.dkr.ecr.us-east-2.amazonaws.com/scorekeep-api",
"cpu": 192,
"memoryReservation": 512,
"environment": [
{ "name" : "AWS_REGION", "value" : "us-east-2" },
{ "name" : "NOTIFICATION_TOPIC", "value" : "arn:aws:sns:us-east-2:123456789012:scorekeep-notifications" }
],
"portMappings" : [
{
"containerPort": 5000
}
]
}
]
}
```
## Configurar opções da linha de comandos no console do Amazon ECS
As opções da linha de comando substituem qualquer valor conflitante no arquivo de configuração da imagem. As opções da linha de comando normalmente são usadas para testes locais, mas também podem ser usadas por conveniência ao definir variáveis de ambiente ou para controlar o processo de inicialização.
Ao adicionar opções da linha de comando, você está atualizando o Docker `CMD` que é transmitido para o contêiner. Para obter mais informações, consulte a [Referência de execução do Docker](https://docs.docker.com/engine/reference/run/#overriding-dockerfile-image-defaults).
**Como definir uma opção da linha de comando**
1. Abra o console clássico do Amazon ECS em [https://console.aws.amazon.com/ecs/](https://console.aws.amazon.com/ecs/).
1. Na barra de navegação, selecione a região que contém a definição de tarefa.
1. No painel de navegação, selecione **Definições de tarefas**.
1. Na página **Task Definitions**, selecione a caixa à esquerda da definição de tarefa a ser revisada e escolha **Create new revision**.
1. Na página **Create new revision of Task Definition (Criar revisão da definição de tarefa)**, selecione o contêiner.
1. Na seção **ENVIRONMENT (AMBIENTE)**, adicione a lista separada por vírgulas das opções da linha de comando ao campo ** Command (Comando)**.
1. Selecione **Atualizar**.
1. Verifique as informações e escolha **Create**.
O exemplo a seguir mostra como escrever uma lista separada por vírgulas da opção da linha de comando para a opção `RoleARN`. A opção `RoleARN` assume o perfil do IAM especificado para carregar segmentos em uma conta diferente.
**Example**
```
--role-arn, arn:aws:iam::123456789012:role/xray-cross-account
```
Para saber mais sobre as opções de linha de comando disponíveis no X-Ray, consulte [Configurando o AWS X-Ray Daemon](xray-daemon-configuration.md).