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