Domande frequenti su AWS X-Ray

Una traccia X-Ray è una set di punti di dati che condividono lo stesso ID della traccia. Ad esempio, quando un cliente effettua una richiesta all’applicazione, viene assegnato un ID traccia univoco. Man mano che la richiesta segue il suo iter tra i servizi dell’applicazione, questi ultimi restituiscono a X-Ray le informazioni riguardanti la richiesta utilizzando questo ID traccia univoco. L’informazione restituita da ciascun servizio dell’applicazione a X-Ray è un segmento e una traccia è un insieme di segmenti.

Un segmento X-Ray incapsula tutti i punti di dati per un singolo componente (ad esempio, un servizio di autorizzazione) dell’applicazione distribuita. I segmenti includono dati definiti dal sistema e definiti dall’utente sotto forma di annotazioni e sono composti da uno o più sotto-segmenti che rappresentano le chiamate da remoto effettuate dal servizio. Ad esempio, quando un’applicazione effettua una chiamata a un database in risposta a una richiesta, viene creato un segmento per quella richiesta con un sotto-segmento che rappresenta la chiamata al database e il relativo risultato. Il sotto-segmento può contenere dati come la query, la tabella utilizzata, il timestamp e lo stato di errore.

Un’annotazione di X-Ray corrisponde ai dati definiti dal sistema o dall’utente associati a un segmento. Un segmento può contenere più annotazioni. Le annotazioni definite dal sistema possono includere i dati aggiunti al segmento da servizi AWS, mentre le annotazioni definite dall’utente sono metadati aggiunti a un segmento da uno sviluppatore. Per esempio, i dati sulla regione per chiamate associate a un servizio AWS verranno inseriti automaticamente in un segmento creato da una tua applicazione, mentre sarà tua facoltà scegliere se aggiungere al segmento i dati sulla regione per chiamate verso servizi non AWS.

Gli errori di X-Ray sono annotazioni di sistema associate a un segmento per una chiamata a cui segue una risposta di errore. L’errore include il messaggio di errore, la traccia dello stack e qualsiasi informazione aggiuntiva (ad esempio, versione o ID impegno) che associ l’errore con un file di origine.

Per garantire un’esperienza performante e a costi ridotti, X-Ray non raccoglie dati per ogni richiesta inviata a un’applicazione. Raccoglie invece dati per un numero statisticamente significativo di richieste. X-Ray non deve essere utilizzato come strumento di controllo o di verifica della conformità in quanto non è in grado di garantire la completezza dei dati.

Il daemon di X-Ray raccoglie le tracce e le invia al servizio X-Ray per l'aggregazione, l'analisi e l'archiviazione. Il daemon semplifica l'invio di dati al servizio X-Ray, anziché utilizzare direttamente le API.

Puoi iniziare a usare X-Ray inserendo nella tua applicazione l’SDK del linguaggio di X-Ray e istallando il daemon X-Ray. Per ulteriori informazioni, consulta la Guida per l'utente di X-Ray.

X-Ray può essere utilizzato con applicazioni distribuite di qualsiasi dimensione per tracciare ed eseguire il debug sia di richieste sincrone che di eventi asincroni. Per esempio, X-Ray può essere utilizzato per tracciare le richieste Web inviate a un’applicazione Web o eventi asincroni che utilizzano le code di Amazon SQS.

X-Ray può essere utilizzato con applicazioni in esecuzione su EC2, ECS, Lambda, Amazon SQS, Amazon SNS ed Elastic Beanstalk. Inoltre, l’SDK di X-Ray acquisisce automaticamente metadati per le chiamate API effettuate verso servizi AWS che utilizzano l’SDK AWS. L’SDK di AWS offre anche add-on per MySQL e driver PostgreSQL.

Se stai utilizzando Elastic Beanstalk, sarà necessario includere le librerie di X-Ray specifiche per il linguaggio nel tuo codice applicazione. Per applicazioni in esecuzione su altri servizi AWS, come EC2 o ECS, occorrerà installare il daemon di X-Ray e dotare di strumentazione il tuo codice applicazione.

Sì, X-Ray offre un set di API per l’acquisizione dei dati della richiesta, l’esecuzione delle query delle tracce e la configurazione del servizio. È possibile utilizzare l’API di X-Ray per creare applicazioni di analisi e visualizzazione in aggiunta a quelle fornite da X-Ray.

Sì. X-Ray registra tutte le chiamate API come eventi di gestione. Inoltre, registra le chiamate sulle tracce come eventi di dati, tra cui su PutTraceSegments e getTimeServiceStatistics tra le altre API. Per impostazione predefinita, gli eventi relativi ai dati non vengono registrati. Per registrare gli eventi relativi ai dati, devi configurare il percorso o il data store degli eventi di CloudTrail per raccoglierli.

Per maggiori informazioni, vedi Prodotti e servizi regionali.

Sì, X-Ray può essere utilizzato per tracciare richieste che coinvolgono più richieste o servizi in varie regioni. I dati di X-Ray vengono memorizzati a livello locale nella regione in cui avviene l’elaborazione, ma con informazioni sufficienti per consentire ad applicazioni client di combinare i dati e offrire una vista globale delle tracce. L’annotazione relativa alla regione per i servizi AWS verrà aggiunta automaticamente, tuttavia i clienti dovranno instrumentare servizi personalizzati per aggiungere l’annotazione regionale che garantisce il supporto in più regioni.

I dati di tracciamento inviati a X-Ray diventano disponibili per il recupero e il filtraggio entro 30 secondi da quando il servizio li riceve.

X-Ray conserva i dati di tracciamento degli ultimi 30 giorni. Ciò consente di riferire le query sui dati di tracciamento ai 30 giorni precedenti.

X-Ray fa il possibile per presentare informazioni di tracciamento complete. Tuttavia, in alcune circostanze (problemi di connettività, ritardo nella ricezione dei segmenti, ecc.) è possibile che le informazioni di tracciamento fornite dalle API di X-Ray siano parziali. In queste situazioni, X-Ray utilizza appositi tag per contrassegnare le tracce come incomplete o parziali.

Sì, il daemon X-Ray può assumere un ruolo che gli consente di pubblicare dati in un account diverso da quello nel quale è attualmente in esecuzione. Ciò ti consente di pubblicare dati da diversi componenti della tua applicazione in un account centrale.