Utilizzo di un SDK - AWS X-Ray
Usa il ADOT SDKUsa il X-Ray SDK

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

Utilizzo di un SDK

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. AWS Management ConsoleÈ inoltre possibile utilizzare an AWS SDK per sviluppare programmi che utilizzano gli X-RayAPIs. È possibile utilizzare AWS Distro for OpenTelemetry (ADOT) SDK o X-RaySDK.

Se si utilizza unSDK, è possibile aggiungere personalizzazioni al flusso di lavoro sia quando si strumenta l'applicazione sia quando si configura il collettore o l'agente. È possibile utilizzare an SDK per eseguire le seguenti attività che non è possibile 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 il ADOT SDK se desideri la flessibilità di utilizzare uno standard OpenTelemetry SDK con livelli aggiuntivi di AWS sicurezza e ottimizzazione. AWS Distro for OpenTelemetry (ADOT) SDK è un pacchetto indipendente dal fornitore che consente l'integrazione con i backend di altri fornitori e non di AWS servizi senza dover ristrumentare il codice.

Usa X-Ray SDK se stai già utilizzando X-RaySDK, ti integri 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à, vedere. Scelta tra AWS Distro for OpenTelemetry e X-Ray SDKs

Usa il ADOT SDK

ADOTSDKSi tratta di un insieme di librerie e agenti open source APIs 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 Utilizzatelo ADOT SDK per strumentare la vostra applicazione e raccogliere log, metadati, metriche e tracce. Puoi anche utilizzarlo ADOT per monitorare i servizi e impostare un allarme in base alle tue metriche in. CloudWatch

Se utilizzi il ADOTSDK, hai le seguenti opzioni, in combinazione con un agente:

  • Utilizzalo ADOT SDK con l'CloudWatch agente, consigliato.

  • Utilizzalo ADOT SDK con ADOTCollector: consigliato se desideri utilizzare un software indipendente dal fornitore con AWS livelli di sicurezza e ottimizzazione.

Per utilizzare il ADOTSDK, procedi come segue:

  • Strumenta la tua applicazione utilizzando il ADOTSDK. Per ulteriori informazioni, consultate la documentazione relativa al linguaggio di programmazione in uso nella documentazione ADOT tecnica.

  • 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 collector.

AWS aggiornamenti regolari ADOT per aggiungere funzionalità e allinearsi al framework. OpenTelemetry Gli aggiornamenti e i piani futuri di sviluppo ADOT fanno parte di una tabella di marcia disponibile al pubblico. ADOTsupporta diversi linguaggi di programmazione, tra cui:

  • Go

  • Java

  • JavaScript

  • Python

  • .NET

  • Ruby

  • PHP

Se stai usando Python, ADOT puoi strumentare automaticamente la tua applicazione. Per iniziare a utilizzareADOT, consulta Introduzione e Guida introduttiva alla AWS distribuzione per OpenTelemetry Collector.

Usa il X-Ray SDK

X-Ray SDK è un insieme di AWS APIs librerie che inviano dati ai servizi di AWS backend. Usa X-Ray SDK per strumentare la tua applicazione e raccogliere dati di tracciamento. Non è possibile utilizzare X-Ray SDK per raccogliere dati di registro o metrici.

Se si utilizza l'X-RaySDK, sono disponibili le seguenti opzioni, in combinazione con un agente:

  • Usa X-Ray SDK con AWS X-Ray demone — Usalo se non desideri aggiornare il codice dell'applicazione.

  • Usa l'X-Ray SDK con l' CloudWatch agente: (consigliato) L'agente è compatibile con l' CloudWatch agente X-Ray. SDK

Per utilizzare gli X-RaySDK, effettuate le seguenti operazioni:

  • Strumenta la tua applicazione utilizzando gli X-RaySDK.

  • Configura un raccoglitore per dirgli 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. X-Ray SDK può inviare dati solo a un AWS backend, come mostrato nel diagramma seguente:

Usa X-Ray SDK con l' CloudWatch agente o il demone X-Ray.

Se si utilizzaJava, è possibile utilizzare l'X-Ray SDK per strumentare automaticamente l'applicazione. Per iniziare a usare X-RaySDK, consulta le librerie associate ai seguenti linguaggi di programmazione: