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
Utilizza 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. AWS Management Console Puoi anche utilizzare un AWS SDK per sviluppare programmi che utilizzano le API X-Ray. È possibile utilizzare l'SDK AWS Distro for OpenTelemetry (ADOT) o l'SDK X-Ray.
Se utilizzate un SDK, potete aggiungere personalizzazioni al flusso di lavoro sia quando strumentate l'applicazione sia quando configurate il raccoglitore o l'agente. Puoi utilizzare un SDK per eseguire le seguenti attività che non puoi eseguire utilizzando un: AWS Management Console
-
Pubblica metriche personalizzate: campiona metriche ad alta risoluzione fino a 1 secondo, usa 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 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 i backend di altri fornitori e non di servizi senza dover ristrumentare il codice.AWS
Usa X-Ray SDK se stai già utilizzando X-Ray SDK, esegui l'integrazione solo con i AWS backend e non vuoi cambiare il modo in cui interagisci con X-Ray o il codice dell'applicazione.
Per ulteriori informazioni su ciascuna funzionalità, consulta. Scelta tra gli AWS SDK Distro for OpenTelemetry e X-Ray
Usa l'ADOTSDK
L'ADOTSDK è un insieme 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 community. OpenTelemetry Usa l'ADOTSDK per strumentare la tua applicazione e raccogliere log, metadati, metriche e tracce. Puoi anche usarlo ADOT per monitorare i servizi e impostare un allarme in base alle tue metriche. CloudWatch
Se utilizzi l'ADOTSDK, hai le seguenti opzioni, in combinazione con un agente:
-
Utilizza l'ADOTSDK con l'CloudWatch agente (consigliato).
-
Utilizza l'ADOTSDK con ADOTCollector
, consigliato se desideri utilizzare un software indipendente dal fornitore con AWS livelli di sicurezza e ottimizzazione.
Per utilizzare l'ADOTSDK, procedi come segue:
-
Strumenta la tua applicazione utilizzando l'ADOTSDK. Per ulteriori informazioni, consultate la documentazione relativa al linguaggio di programmazione in uso nella documentazione tecnica ADOT
. -
Configura un ADOT raccoglitore per dirgli dove inviare i dati che raccoglie.
Dopo aver ricevuto i dati, il ADOT raccoglitore li invia al backend specificato nella configurazione. ADOT ADOTpuò inviare dati a più backend, anche a fornitori esterni AWS, come mostrato nel diagramma seguente:
![È possibile personalizzare ADOT Collector quando si strumenta l'applicazione e si configura il raccoglitore.](images/adot-sdk.png)
AWS aggiornamenti regolari 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, consulta Introduzione
Usa l'SDK X-Ray
L'X-Ray SDK è un insieme di AWS API e librerie che inviano dati ai servizi di backend. AWS Usa l'SDK X-Ray per strumentare la tua applicazione e raccogliere dati di tracciamento. Non è possibile utilizzare X-Ray SDK per raccogliere dati di log o metrici.
Se si utilizza l'SDK X-Ray, sono disponibili le seguenti opzioni, in combinazione con un agente:
-
Usa l'SDK X-Ray conAWS X-Ray demone: usalo se non desideri aggiornare il codice dell'applicazione.
-
Usa l'SDK X-Ray con l' CloudWatch agente: (consigliato) L' CloudWatch agente è compatibile con l'SDK X-Ray.
Per utilizzare X-Ray SDK, procedi come segue:
-
Strumenta la tua applicazione utilizzando l'SDK X-Ray.
-
Configura un raccoglitore per indicargli dove inviare i dati raccolti. È possibile utilizzare l' CloudWatch agente o il demone X-Ray per raccogliere le informazioni di tracciamento.
Dopo aver ricevuto i dati, il raccoglitore o l'agente li invia a un AWS backend specificato nella configurazione dell'agente. L'X-Ray SDK può inviare dati solo a un AWS backend, come mostrato nel diagramma seguente:
![Usa l'SDK X-Ray con l' CloudWatch agente o il demone X-Ray.](images/xray-sdk.png)
Se si utilizzaJava, è possibile utilizzare l'X-Ray SDK per strumentare automaticamente l'applicazione. Per iniziare a utilizzare X-Ray SDK, consulta le librerie associate ai seguenti linguaggi di programmazione: