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à.
# Strumentazione della tua applicazione per AWS X-Ray
**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
La strumentazione dell'applicazione comporta l'invio di dati di traccia per le richieste in entrata e in uscita e altri eventi all'interno dell'applicazione, insieme ai metadati relativi a ciascuna richiesta. Esistono diverse opzioni di strumentazione tra cui scegliere o combinare, in base alle proprie esigenze particolari:
+ *Strumentazione automatica: strumentazione della* tua applicazione senza modifiche al codice, in genere tramite modifiche alla configurazione, aggiunta di un agente di strumentazione automatica o altri meccanismi.
+ *Strumentazione della libreria*: apporta modifiche minime al codice dell'applicazione per aggiungere strumentazione predefinita destinata a librerie o framework specifici, come SDK, client Apache HTTP o client SQL. AWS
+ *Strumentazione manuale: aggiungi il codice di strumentazione all'*applicazione in ogni posizione in cui desideri inviare le informazioni di traccia.
Esistono diversi SDKs agenti e strumenti che possono essere utilizzati per strumentare l'applicazione per il tracciamento a raggi X..
**Topics**
+ [
## Strumentate la vostra applicazione con Distro per AWS OpenTelemetry
](#xray-instrumenting-opentel)
+ [
## Strumentate la vostra applicazione con AWS X-Ray SDKs
](#xray-instrumenting-xray-sdk)
+ [
## Scelta tra AWS Distro for OpenTelemetry e X-Ray SDKs
](#xray-instrumenting-choosing)
## Strumentate la vostra applicazione con Distro per AWS OpenTelemetry
The AWS Distro for OpenTelemetry (ADOT) è una AWS distribuzione basata sul progetto Cloud Native Computing Foundation (CNCF). OpenTelemetry OpenTelemetry fornisce un unico set di librerie APIs, agenti e librerie open source per raccogliere tracce e metriche distribuite. Questo toolkit è una distribuzione di OpenTelemetry componenti upstream SDKs, inclusi agenti di strumentazione automatica e collettori testati, ottimizzati, protetti e supportati da. AWS
Con ADOT, gli ingegneri possono strumentare le loro applicazioni una sola volta e inviare metriche e tracce correlate a più soluzioni di AWS monitoraggio tra cui Amazon CloudWatch AWS X-Ray e Amazon Service. OpenSearch
L'utilizzo di X-Ray con ADOT richiede due componenti: un *OpenTelemetry SDK* abilitato per l'uso con X-Ray e *AWS Distro for OpenTelemetry Collector* abilitato per l'uso con X-Ray. [Per ulteriori informazioni sull'utilizzo di Distro for OpenTelemetry with AWS X-Ray e altro, AWS consulta Distro for Documentation. Servizi AWSAWS OpenTelemetry ](https://aws-otel.github.io/docs/introduction)
Per ulteriori informazioni sul supporto e l'utilizzo della lingua, vedere [AWS Observability](https://github.com/aws-observability) on. GitHub
**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-opentel)X-Ray SDKs e [inviarle a X-Ray](#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 .
ADOT include quanto segue:
+ [AWS Distro for Go OpenTelemetry ](https://aws-otel.github.io/docs/getting-started/go-sdk)
+ [AWS Distro per Java OpenTelemetry ](https://aws-otel.github.io/docs/getting-started/java-sdk)
+ [AWS Distro per OpenTelemetry JavaScript](https://aws-otel.github.io/docs/getting-started/javascript-sdk)
+ [AWS Distro per Python OpenTelemetry ](https://aws-otel.github.io/docs/getting-started/python-sdk)
+ [AWS Distro per.NET OpenTelemetry ](https://aws-otel.github.io/docs/getting-started/dotnet-sdk)
[https://aws-otel.github.io/docs/getting-started/java-sdk/auto-instr](https://aws-otel.github.io/docs/getting-started/java-sdk/auto-instr) [Inoltre, ADOT consente la strumentazione automatica delle funzioni AWS Lambda e delle relative richieste downstream utilizzando i runtime Java, Node.js e Python, tramite ADOT Managed Lambda Layers.](https://aws-otel.github.io/docs/getting-started/lambda)
ADOT SDKs for Java and Go supporta le regole di campionamento centralizzato X-Ray. Se hai bisogno di supporto per le regole di campionamento a raggi X in altre lingue, prendi in considerazione l'utilizzo di un SDK. AWS X-Ray
**Nota**
Ora puoi inviare una traccia W3C a IDs X-Ray. Per impostazione predefinita, le tracce create con OpenTelemetry hanno un formato ID di traccia basato sulla specifica [W3C](https://www.w3.org/TR/trace-context/) Trace Context. Si tratta di un formato diverso dal formato di traccia IDs creato utilizzando un SDK X-Ray o dai AWS servizi integrati con X-Ray. [Per garantire che le tracce IDs in formato W3C siano accettate da X-Ray, è necessario utilizzare la versione [AWS X-Ray Exporter](https://aws-otel.github.io/docs/getting-started/x-ray) 0.86.0 o successiva, inclusa in ADOT Collector versione 0.34.0 e successive.](https://aws-otel.github.io/download) Le versioni precedenti dell'esportatore convalidano i timestamp degli ID di traccia, il che potrebbe causare il rifiuto della traccia W3C. IDs
## Strumentate la vostra applicazione con AWS X-Ray SDKs
AWS X-Ray include un set di linguaggi specifici SDKs per strumentare l'applicazione per inviare tracce a X-Ray. Ogni X-Ray SDK offre quanto segue:
+ *Moduli di intercettazione* da aggiungere al tuo codice per il tracciamento delle richieste HTTP in ingresso
+ Da *gestori client* a client AWS SDK di Instrument che l'applicazione utilizza per chiamare altri Servizi AWS
+ Un *client HTTP* per effettuare chiamate strumentali ad altri servizi Web HTTP interni ed esterni
X-Ray supporta SDKs anche le chiamate strumentali ai database SQL, la strumentazione client AWS SDK automatica e altre funzionalità. Invece di inviare i dati di traccia direttamente a X-Ray, l'SDK invia i documenti del segmento JSON a un processo demone che ascolta il traffico UDP. Il [demone X-Ray memorizza i segmenti in una coda e li carica su](xray-daemon.md) X-Ray in batch.
Sono SDKs disponibili le seguenti lingue specifiche:
+ [AWS X-Ray SDK for Go](xray-sdk-go.md)
+ [AWS X-Ray SDK per Java](xray-sdk-java.md)
+ [AWS X-Ray SDK per Node.js](xray-sdk-nodejs.md)
+ [AWS X-Ray SDK per Python](xray-sdk-python.md)
+ [AWS X-Ray SDK per.NET](xray-sdk-dotnet.md)
+ [AWS X-Ray SDK per Ruby](xray-sdk-ruby.md)
[X-Ray attualmente include il supporto per la strumentazione automatica per Java.](aws-x-ray-auto-instrumentation-agent-for-java.md)
## Scelta tra AWS Distro for OpenTelemetry e X-Ray SDKs
Gli X-Ray SDKs inclusi fanno parte di una soluzione di strumentazione strettamente integrata offerta da. AWS AWS Distro for OpenTelemetry fa parte di una soluzione di settore più ampia in cui X-Ray è solo una delle tante soluzioni di tracciamento. È possibile implementare il end-to-end tracciamento in X-Ray utilizzando entrambi gli approcci, ma è importante comprendere le differenze per determinare l'approccio più utile per l'utente.
Ti consigliamo di strumentare la tua applicazione con AWS Distro OpenTelemetry se hai bisogno di quanto segue:
+ La possibilità di inviare tracce a più backend di tracciamento diversi senza dover ristrumentare il codice
+ Support per un gran numero di strumentazioni di libreria per ogni lingua, gestite dalla comunità OpenTelemetry
+ Layer Lambda completamente gestiti che racchiudono tutto il necessario per raccogliere dati di telemetria, senza richiedere modifiche al codice quando si utilizza Java, Python o Node.js
**Nota**
AWS Distro for OpenTelemetry offre un'esperienza introduttiva più semplice per la strumentazione delle funzioni Lambda. Tuttavia, a causa della flessibilità OpenTelemetry offerta, la funzione Lambda richiederà memoria aggiuntiva e le chiamate potrebbero subire un aumento della latenza di avvio a freddo, il che può comportare costi aggiuntivi. Se stai ottimizzando per una bassa latenza e non hai bisogno delle funzionalità avanzate come destinazioni OpenTelemetry di backend configurabili dinamicamente, potresti voler utilizzare l'SDK AWS X-Ray per strumentare la tua applicazione.
Ti consigliamo di scegliere un SDK X-Ray per la strumentazione della tua applicazione se hai bisogno di quanto segue:
+ Una soluzione monovendor strettamente integrata
+ Integrazione con le regole di campionamento centralizzate X-Ray, inclusa la possibilità di configurare le regole di campionamento dalla console X-Ray e di utilizzarle automaticamente su più host, quando si utilizza Node.js, Python, Ruby o.NET