Usa un SDK - AWS X-Ray

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.

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

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: