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à.
Usa un SDK
Nota
X-Ray SDK/Daemon Avviso di manutenzione: il 25 febbraio 2026, AWS X-Ray SDKs/Daemon entrerà in modalità manutenzione, in cui AWS limiterà le versioni di X-Ray SDK e Daemon per risolvere solo i problemi di sicurezza. Per ulteriori informazioni sulla tempistica dell'assistenza, consulta. Cronologia di X-Ray SDK e Daemon Support Ti consigliamo di migrare a. OpenTelemetry Per ulteriori informazioni sulla migrazione a OpenTelemetry, vedere Migrazione dalla X-Ray strumentazione alla strumentazione. OpenTelemetry
Usa un SDK se desideri utilizzare un'interfaccia a riga di comando o hai bisogno di più funzionalità di tracciamento, monitoraggio o registrazione personalizzate rispetto a quelle disponibili in un. Console di gestione AWS Puoi anche utilizzare un AWS SDK per sviluppare programmi che utilizzano le API. X-Ray Puoi utilizzare l'SDK AWS Distro for OpenTelemetry (ADOT) o l'SDK. X-Ray
Se si utilizza un SDK, è possibile aggiungere personalizzazioni al flusso di lavoro sia quando si utilizza lo strumento dell'applicazione sia quando si configura il raccoglitore o l'agente. Puoi utilizzare un SDK per eseguire le seguenti attività che non puoi eseguire utilizzando un: Console di gestione AWS
-
Pubblica metriche personalizzate: campiona metriche ad alta risoluzione fino a 1 secondo, utilizza più dimensioni per aggiungere informazioni su una metrica e aggrega i punti dati in un set di statistiche.
-
Personalizza il tuo raccoglitore: personalizza la configurazione per qualsiasi parte di un raccoglitore, inclusi ricevitore, processore, esportatore e connettore.
-
Personalizza la tua strumentazione: personalizza segmenti e sottosegmenti, aggiungi coppie chiave-valore personalizzate come attributi e crea metriche personalizzate.
-
Crea e aggiorna le regole di campionamento a livello di codice.
Usa l'ADOTSDK se desideri la flessibilità di utilizzare un OpenTelemetry SDK standardizzato con livelli aggiuntivi di sicurezza e ottimizzazione. AWS L'SDK AWS Distro for OpenTelemetry (ADOT) è un pacchetto indipendente dal fornitore che consente l'integrazione con backend di altri fornitori e non servizi senza dover riprogrammare il codice.AWS
Usa l' X-Ray SDK se stai già utilizzando l' X-Ray SDK, esegui l'integrazione solo con i AWS backend e non vuoi modificare il modo in cui interagisci o il codice dell'applicazione. X-Ray
Per ulteriori informazioni su ciascuna funzionalità, consulta. Scelta tra AWS Distro for OpenTelemetry e X-Ray SDKs
Usa il ADOT SDK
L'ADOTSDK è un set di API, librerie e agenti open source che inviano dati ai servizi di backend. ADOTè supportato da AWS, si integra con più backend e agenti e fornisce un gran numero di librerie open source gestite dalla comunità. OpenTelemetry Usa l'ADOTSDK per strumentare la tua applicazione e raccogliere log, metadati, metriche e tracce. Puoi anche utilizzarlo ADOT per monitorare i servizi e impostare un allarme in base alle metriche inserite. CloudWatch
Se utilizzi l'ADOTSDK, hai le seguenti opzioni, in combinazione con un agente:
-
Usa l'ADOTSDK con l'CloudWatch agente: consigliato.
-
Usa l'ADOTSDK con ADOT Collector
: consigliato se desideri utilizzare un software indipendente dal fornitore con AWS livelli di sicurezza e ottimizzazione.
Per utilizzare l'ADOTSDK, effettuate le seguenti operazioni:
-
Strumenta la tua applicazione utilizzando l'ADOTSDK. Per ulteriori informazioni, consultate la documentazione relativa al vostro linguaggio di programmazione nella documentazione tecnica ADOT.
-
Configura un ADOT raccoglitore per dirgli dove inviare i dati raccolti.
Dopo aver ricevuto i dati, il ADOT raccoglitore li invia al backend specificato nella configurazione. ADOT ADOTpuò inviare dati a più backend, inclusi fornitori esterni AWS, come mostrato nel diagramma seguente:
AWS si aggiorna regolarmente ADOT per aggiungere funzionalità e allinearsi al framework. OpenTelemetry
-
Go
-
Java
-
JavaScript
-
Python
-
.NET
-
Ruby
-
PHP
Se stai usando Python, ADOT puoi strumentare automaticamente la tua applicazione. Per iniziare a utilizzareADOT, consultate Introduzione
Usa il X-Ray SDK
L' X-Ray SDK è un set di AWS API e librerie che inviano dati ai servizi di AWS backend. Usa l' X-Ray SDK per strumentare la tua applicazione e raccogliere dati di tracciamento. Non è possibile utilizzare l' X-Ray SDK per raccogliere dati di registro o metrici.
Se si utilizza l' X-Ray SDK, sono disponibili le seguenti opzioni, in combinazione con un agente:
-
Usa l' X-Ray SDK conAWS X-Ray demone: usa questo se non vuoi aggiornare il codice dell'applicazione.
-
Usa l' X-Ray SDK con l' CloudWatch agente: (consigliato) L' CloudWatch agente è compatibile con l' X-Ray SDK.
Per utilizzare l' X-Ray SDK, procedi come segue:
-
Strumenta la tua applicazione utilizzando l' X-Ray SDK.
-
Configura un raccoglitore per dirgli dove inviare i dati raccolti. È possibile utilizzare l' CloudWatch agente o il X-Ray demone per raccogliere le informazioni di tracciamento.
Dopo che il raccoglitore o l'agente riceve i dati, li invia a un AWS backend specificato nella configurazione dell'agente. L' X-Ray SDK può inviare dati a un AWS backend solo come mostrato nel diagramma seguente:
Se lo stai utilizzandoJava, puoi utilizzare l' X-Ray SDK per strumentare automaticamente la tua applicazione. Per iniziare a utilizzare l' X-Ray SDK, consulta le librerie associate ai seguenti linguaggi di programmazione:
