Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# AWS X-Ray demone
**Nota**
Avviso di SDK/Daemon manutenzione a raggi X: il 25 febbraio 2026, X-Ray SDKs/Daemon entrerà in modalità di manutenzione, in cui AWS limiterà le versioni di AWS X-Ray SDK e Daemon per risolvere solo problemi di sicurezza. Per ulteriori informazioni sulla tempistica del supporto, consulta. [Cronologia di X-Ray SDK e Daemon Support](xray-sdk-daemon-timeline.md) Ti consigliamo di migrare a. OpenTelemetry Per ulteriori informazioni sulla migrazione a OpenTelemetry, vedere [Migrazione dalla strumentazione a raggi X](https://docs.aws.amazon.com/xray/latest/devguide/xray-sdk-migration.html) alla strumentazione. OpenTelemetry
**Nota**
Ora puoi utilizzare l' CloudWatch agente per raccogliere parametri, log e tracce dalle istanze Amazon EC2 e dai server locali. CloudWatch la versione dell'agente 1.300025.0 e successive può raccogliere tracce dal nostro client [OpenTelemetry](xray-instrumenting-your-app.md#xray-instrumenting-opentel)X-Ray SDKs e [inviarle a X-Ray](xray-instrumenting-your-app.md#xray-instrumenting-xray-sdk). L'utilizzo dell' CloudWatch agente al posto del demone AWS Distro for OpenTelemetry (ADOT) Collector o X-Ray per raccogliere le tracce può aiutare a ridurre il numero di agenti da gestire. Per ulteriori informazioni, consultate l'argomento relativo all'[CloudWatch agente](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Install-CloudWatch-Agent.html) nella Guida per l'utente CloudWatch .
Il AWS X-Ray daemon è un'applicazione software che ascolta il traffico sulla porta UDP 2000, raccoglie i dati grezzi dei segmenti e li inoltra all'API. AWS X-Ray Il daemon funziona insieme a AWS X-Ray SDKs e deve essere in esecuzione in modo che i dati inviati da SDKs possano raggiungere il servizio X-Ray. Il demone X-Ray è un progetto open source. [Puoi seguire il progetto e inviare problemi e richieste pull su GitHub: github. com/aws/aws-xray-daemon](https://github.com/aws/aws-xray-daemon)
Su AWS Lambda e AWS Elastic Beanstalk, usa l'integrazione di questi servizi con X-Ray per eseguire il demone. Lambda esegue il demone automaticamente ogni volta che viene richiamata una funzione per una richiesta campionata. Su Elastic [Beanstalk, `XRayEnabled` usa l'opzione di configurazione per eseguire il](xray-daemon-beanstalk.md) demone sulle istanze del tuo ambiente. Per ulteriori informazioni, consultare la pagina
Per eseguire il demone X-Ray localmente, in locale o in altro modo, è necessario scaricarlo Servizi AWS, [eseguirlo e quindi [autorizzarlo](#xray-daemon-permissions)](#xray-daemon-running) a caricare i documenti dei segmenti su X-Ray.
## Download del daemon
Puoi scaricare il daemon da Amazon S3, Amazon ECR o Docker Hub, quindi eseguirlo localmente o installarlo su un'istanza Amazon EC2 all'avvio.
------
#### [ Amazon S3 ]
**Installatori ed eseguibili dei daemon X-Ray**
+ **[Linux (eseguibile) — (sig) [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)](https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-linux-3.x.zip.sig)**
+ **Linux (programma di installazione 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 (programma di installazione 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, eseguibile) — [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 (programma ARM64 di installazione 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 (programma di ARM64 installazione 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 (eseguibile) — [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 (eseguibile)** — [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 (servizio)** — [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))
Questi collegamenti rimandano sempre all'ultima versione 3.x del demone. Per scaricare una versione specifica, procedi come segue:
+ Se desideri scaricare una versione precedente alla versione`3.3.0`, sostituiscila `3.x` con il numero di versione. Ad esempio, `2.1.0`. Prima della versione`3.3.0`, l'unica architettura disponibile è`arm64`. Ad esempio `2.1.0` e `arm64`.
+ Se desideri scaricare una versione dopo l'altra`3.3.0`, sostituiscila `3.x` con il numero di versione e `arch` con il tipo di architettura.
Le risorse X-Ray vengono replicate su bucket in ogni regione supportata. Per utilizzare il bucket più vicino a te o alle tue AWS risorse, sostituisci la regione nei link precedenti con la tua regione.
```
https://s3.{{us-west-2}}.amazonaws.com/aws-xray-assets.{{us-west-2}}/xray-daemon/{{aws-xray-daemon-3.x.rpm}}
```
------
#### [ Amazon ECR ]
[A partire dalla versione 3.2.0, il daemon è disponibile su Amazon ECR.](https://gallery.ecr.aws/xray/aws-xray-daemon) Prima di estrarre un'immagine, devi [autenticare il tuo client docker nel registro pubblico](https://docs.aws.amazon.com/AmazonECR/latest/public/public-registries.html#public-registry-auth) Amazon ECR.
Estrai il tag della versione 3.x rilasciata più recente eseguendo il seguente comando:
```
docker pull public.ecr.aws/xray/aws-xray-daemon:3.x
```
Le versioni precedenti o alpha possono essere scaricate sostituendole `3.x` con `alpha` o con un numero di versione specifico. Non è consigliabile utilizzare un'immagine daemon con un tag alfa in un ambiente di produzione.
------
#### [ Docker Hub ]
[Il demone può essere trovato su Docker Hub.](https://hub.docker.com/r/amazon/aws-xray-daemon) Per scaricare l'ultima versione 3.x rilasciata, esegui il seguente comando:
```
docker pull amazon/aws-xray-daemon:3.x
```
Le versioni precedenti del demone possono essere rilasciate sostituendole `3.x` con la versione desiderata.
------
## Verifica della firma dell'archivio del daemon
I file di firma GPG per le risorse del daemon compresse in archivi ZIP sono inclusi. La chiave pubblica si trova qui: [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).
Puoi utilizzare la chiave pubblica per verificare che l'archivio ZIP del daemon sia originale e non modificato. Prima di tutto, importa la chiave pubblica con [GnuPG](https://gnupg.org/index.html).
**Per importare la chiave pubblica**
1. Scarica la chiave pubblica.
```
$ BUCKETURL=https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2
$ wget $BUCKETURL/xray-daemon/aws-xray.gpg
```
1. Importa la chiave pubblica nel tuo keyring.
```
$ 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
```
Utilizza la chiave importata per verificare la firma del dell'archivio ZIP del daemon.
**Per verificare la firma di un archivio**
1. Scaricare l'archivio e il file della firma.
```
$ 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. Eseguire `gpg --verify` per verificare la firma.
```
$ 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
```
Prendi nota dell'avviso sulla trust. Una chiave è considerata attendibile solo se è stata firmata da te o da un utente attendibile. Questo non significa che la firma non sia valida, ma soltanto che la chiave pubblica non è stata verificata.
## Esecuzione del daemon
Esegui il daemon localmente dalla riga di comando. Utilizza l'opzione `-o` per eseguirlo in modalità locale e `-n` per impostare la regione.
```
~/Downloads$ ./xray -o -n us-east-2
```
Per ulteriori istruzioni specifiche per la piattaforma, consulta le seguenti sezioni:
+ **Linux (locale)** — [Esecuzione del demone X-Ray su Linux](xray-daemon-local.md#xray-daemon-local-linux)
+ **Windows (locale)** — [Esecuzione del demone X-Ray su Windows](xray-daemon-local.md#xray-daemon-local-windows)
+ **Elastic Beanstalk** — [Esecuzione del demone X-Ray su AWS Elastic Beanstalk](xray-daemon-beanstalk.md)
+ **Amazon EC2** — [Esecuzione del demone X-Ray su Amazon EC2](xray-daemon-ec2.md)
+ **Amazon ECS** — [Esecuzione del daemon X-Ray su Amazon ECS](xray-daemon-ecs.md)
Puoi personalizzare ulteriormente il comportamento del daemon utilizzando le opzioni della riga di comando o un file di configurazione. Per informazioni dettagliate, vedi [Configurazione del demone AWS X-Ray](xray-daemon-configuration.md).
## Dare al demone il permesso di inviare dati a X-Ray
Il demone X-Ray utilizza l' AWS SDK per caricare i dati di traccia su X-Ray e per farlo necessita AWS di credenziali con autorizzazione.
Su Amazon EC2, il daemon utilizza automaticamente il ruolo del profilo dell'istanza. [Per informazioni sulle credenziali richieste per eseguire il demone localmente, consulta Esecuzione dell'applicazione localmente.](security_iam_service-with-iam.md#xray-permissions-local)
Se specifichi le credenziali in più di una posizione (file delle credenziali, profilo dell'istanza oppure variabili di ambiente), le credenziali utilizzate sono determinate dalla catena del provider dell'SDK. Per ulteriori informazioni sulla fornitura di credenziali all'SDK, consulta [Specificing Credentials](https://aws.github.io/aws-sdk-go-v2/docs/configuring-sdk/#specifying-credentials) nella SDK for *AWS Go Developer* Guide.
Il ruolo o l'utente IAM a cui appartengono le credenziali del daemon devono avere l'autorizzazione di scrivere i dati sul servizio per tuo conto.
+ Per utilizzare il daemon su Amazon EC2, crea un nuovo ruolo del profilo di istanza o aggiungi la policy gestita a una esistente.
+ Per utilizzare il daemon su Elastic Beanstalk, aggiungi la policy gestita al ruolo del profilo di istanza predefinito di Elastic Beanstalk.
+ [Per eseguire il daemon localmente, consulta Esecuzione dell'applicazione localmente.](security_iam_service-with-iam.md#xray-permissions-local)
Per ulteriori informazioni, consulta [Gestione delle identità e degli accessi per AWS X-Ray](security-iam.md).
## Registri dei daemon X-Ray
Il demone emette informazioni sulla sua configurazione corrente e sui segmenti a cui invia. 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)
```
Per impostazione predefinita, il daemon invia i log in output su STDOUT. Se esegui il daemon in background, utilizza l'opzione della riga di comando `--log-file` o un file di configurazione per impostare il percorso del file di log. Puoi anche impostare il livello di tracciamento e disabilitare la rotazione dei log. Per istruzioni, consulta [Configurazione del demone AWS X-Ray](xray-daemon-configuration.md).
Su Elastic Beanstalk, la piattaforma imposta la posizione dei log del demone. Per informazioni dettagliate, vedi [Esecuzione del demone X-Ray su AWS Elastic Beanstalk](xray-daemon-beanstalk.md).