Che cos'è AWS X-Ray?

AWS X-Ray fornisce informazioni di tracciamento su tutte le risposte e le chiamate ricevute effettuate da un'applicazione strumentata, tra cui:

Utilizza dati di tracciamento e visualizzazioni per ottenere informazioni dettagliate sulle prestazioni dell'applicazione, identificare i problemi e trovare opportunità di ottimizzazione. Utilizza gli strumenti di analisi di X-Ray per visualizzare, filtrare e analizzare i dettagli di qualsiasi richiesta riconducibile alla tua applicazione.

Come funziona X-Ray

Per utilizzare X-Ray, è necessario innanzitutto strumentare l'applicazione in modo che X-Ray possa tenere traccia del modo in cui l'applicazione gestisce una richiesta. L'aggiunta di strumentazione all'applicazione consente a X-Ray di inviare dati di traccia e metadati per le richieste in entrata e in uscita e altri eventi all'interno dell'applicazione. Ad esempio, è possibile indirizzare tutte le richieste HTTP in entrata e le chiamate downstream a quelle effettuate dall'applicazione Java. Servizi AWS È inoltre possibile strumentare automaticamente la propria applicazione. Per ulteriori informazioni, consulta Strumentazione dell'applicazione per ulteriori informazioni.

X-Ray assegna un ID di traccia a qualsiasi richiesta ricevuta dall'applicazione strumentata. Se l'applicazione interagisce con un altro componente, X-Ray crea un segmento. Questo segmento è associato all'ID di traccia originale e tiene traccia della qualità dell'interazione con quel componente.

X-Ray tiene traccia dell'ID di traccia e dei segmenti durante l'intero flusso di lavoro dell'applicazione. È possibile analizzare l'intero flusso di lavoro o isolare un pezzo per un'analisi dettagliata. Per ulteriori informazioni sui segmenti, consulta la sezione seguenteConcetti.

X-Ray tiene traccia dell'applicazione mentre interagisce con i nodi di servizio, o componenti, per soddisfare una richiesta in arrivo nel modo seguente:

I passaggi precedenti sono illustrati nel diagramma seguente:

In che modo X-Ray interagisce con la vostra applicazione strumentata

Quando l'applicazione strumentata riceve una richiesta, X-Ray esegue le seguenti operazioni:

X-Ray utilizza i dati di traccia AWS delle risorse con cui l'applicazione interagisce per generare una mappa di traccia dettagliata. La mappa di tracciamento mostra il client, il servizio front-end e i servizi di backend richiamati dal servizio front-end in un'unica richiesta. Usa la mappa di tracciamento per identificare strozzature, picchi di latenza e altri problemi per risolvere o migliorare le prestazioni delle tue applicazioni.

X-Ray genererà anche una mappa dei servizi che fornisce una visione generale del modo in cui l'applicazione interagisce con i nodi di servizio. I bordi della mappa dei servizi collegano i nodi di servizio. Mostrano la frequenza con cui i nodi comunicano tra loro e la latenza di tali comunicazioni.

L'immagine seguente mostra un esempio di mappa dei servizi, che mostra come l'applicazione interagisce con i diversi componenti. È possibile visualizzare una mappa dei servizi nella console. L'immagine mostra un'applicazione che riceve una richiesta da un client. Quindi, l'immagine mostra come l'applicazione interagisce con due tabelle DynamoDB e Amazon SNS.

L'immagine seguente è un esempio dei dati disponibili nella console per un singolo segmento di una traccia. L'immagine mostra una sequenza temporale che elenca diversi segmenti e l'ora di inizio e la durata di ogni segmento rispetto agli altri. L'immagine mostra anche lo stato del segmento e il codice di risposta HTTP.

Concetti

AWS X-Ray riceve i dati dai servizi sotto forma di segmenti. X-Ray raggruppa quindi i segmenti che hanno una richiesta comune in tracce. X-Ray elabora le tracce per generare un grafico di servizio che fornisce una rappresentazione visiva dell'applicazione.

Segmenti

Le risorse di elaborazione che eseguono la logica dell'applicazione inviano i dati sulle loro attività sotto forma di segmenti. Un segmento contiene il nome della risorsa, i dettagli relativi alla richiesta e i dettagli sull'attività eseguita. Ad esempio, quando una richiesta HTTP raggiunge l'applicazione, il segmento può memorizzare i seguenti dati:

L'immagine seguente è un esempio di panoramica delle informazioni restituite su un segmento. L'immagine mostra informazioni su un ID, l'ora di inizio e di fine, eventuali errori o guasti e il codice di richiesta e risposta di una richiesta HTTP:

Il framework di tracciamento, composto da SDK o API, raccoglie informazioni dalle intestazioni di richiesta e risposta, dal codice dell'applicazione e dai metadati relativi alle risorse su cui viene eseguita l' AWS applicazione. Puoi scegliere quali dati X-Ray raccoglie modificando la configurazione o il codice dell'applicazione per strumentare le richieste in entrata, le richieste downstream e i servizi. AWS

Puoi utilizzare un framework di tracciamento come un SDK o un'API per registrare ulteriori informazioni, tra cui annotazioni e metadati. Per dettagli sulla struttura di segmenti e sottosegmenti e sulle informazioni registrate, vedere. Documenti relativi al segmento X-Ray I documenti dei segmenti possono avere dimensioni fino a 64 kB.

Sottosegmenti

È possibile dividere un segmento in sottosegmenti. I sottosegmenti forniscono informazioni temporali più granulari e dettagli sulle chiamate downstream effettuate dall'applicazione per soddisfare la richiesta originale. Un sottosegmento contiene dettagli aggiuntivi su una chiamata a un' Servizio AWS API HTTP esterna o a un database SQL. È inoltre possibile definire sottosegmenti per strumentare funzioni o righe di codice specifiche dell'applicazione.

X-Ray utilizza sottosegmenti per generare segmenti dedotti e nodi downstream sulla mappa di traccia per servizi che non inviano segmenti propri, come Amazon DynamoDB. I sottosegmenti consentono di visualizzare tutte le dipendenze a valle, anche se le dipendenze non supportano il tracciamento o sono esterne. AWS

I sottosegmenti rappresentano la vista di una chiamata a valle da parte dell'applicazione che opera come client. Se anche il servizio downstream è dotato di strumentazione, il relativo segmento sostituisce il segmento dedotto dal sottosegmento del cliente a monte. Il nodo sul grafico del servizio utilizza le informazioni del segmento del servizio, se disponibili. L'edge tra i due nodi utilizza il sottosegmento del servizio upstream.

Ad esempio, quando si chiama DynamoDB con un client SDK AWS strumentato, l'SDK X-Ray registra un sottosegmento per quella chiamata. DynamoDB non invia un segmento, quindi il sottosegmento contiene informazioni su quanto segue:

Il diagramma seguente mostra la mappa dei servizi per un'applicazione di esempio. Nell'immagine, il client invia una richiesta a un'applicazione Scorekeep di esempio. L'applicazione Scorekeep effettua due chiamate a DynamoDB. Un bordo nella mappa dei servizi rappresenta ciascuna di queste chiamate. Seleziona un bordo per visualizzare lo stato di integrità, il numero e la frequenza delle chiamate effettuate a una tabella DynamoDB. L'immagine seguente mostra le tracce che corrispondono a un bordo filtrato in base al tempo di risposta.

Quando si chiama un altro servizio strumentato con un'applicazione strumentata, il servizio downstream invia il proprio segmento. Questo segmento registra la visualizzazione della stessa chiamata registrata dal servizio upstream in un sottosegmento. Nel grafico dei servizi, i nodi di entrambi i servizi contengono informazioni sulla tempistica e sugli errori relative ai rispettivi segmenti. Il margine tra di essi contiene informazioni provenienti dal sottosegmento del servizio upstream. Il servizio a valle registra l'inizio e la fine del lavoro sulla richiesta. Il servizio upstream registra la latenza di andata e ritorno, incluso il tempo impiegato dalla richiesta per spostarsi tra i due servizi.

L'immagine seguente mostra le informazioni di traccia filtrate in base al tempo di risposta da un edge che corrisponde a una funzione Lambda upstream.

Grafico del servizio

X-Ray utilizza i dati inviati dall'applicazione per generare un grafico di servizio. Ogni AWS risorsa che invia dati a X-Ray appare come un nodo di servizio nel grafico. Gli edge collegano i servizi che interagiscono per soddisfare le richieste, connettono i client all'applicazione e connettono l'applicazione ai servizi e alle risorse a valle che utilizza.

Un grafo del servizio è un documento in formato JSON che contiene le informazioni sui servizi e sulle risorse che costituiscono la tua applicazione. La console X-Ray utilizza il grafico del servizio per generare una visualizzazione o una mappa dei servizi.

L'immagine seguente mostra una mappa dei servizi. La mappa dei servizi mostra la relazione tra la richiesta del cliente all'applicazione e i servizi con cui l'applicazione interagisce per soddisfare la richiesta. Nell'immagine seguente, un'applicazione Scorekeep di esempio interagisce con due tabelle DynamoDB e Amazon SNS.

In un'applicazione distribuita, X-Ray combina i nodi di tutti i servizi che elaborano le richieste con lo stesso ID di traccia in un unico grafico di servizio. Il primo servizio con cui interagisce la richiesta aggiunge un'intestazione di tracciamento che viene propagata tra il front-end e i servizi che chiama.

Ad esempio, Scorekeep esegue un'API Web che richiama una AWS Lambda funzione per generare un nome casuale. Quindi, l'SDK X-Ray genera l'ID di traccia e tiene traccia delle chiamate alla funzione Lambda. AWS Lambda passa i dati di tracciamento e l'ID di traccia alla funzione Lambda. L'X-Ray SDK utilizza anche lo stesso ID di traccia per inviare dati a un agente o a un raccoglitore. Di conseguenza, i nodi per l'API, il AWS Lambda servizio e la funzione Lambda appaiono tutti come nodi separati ma connessi sulla mappa di traccia.

I dati del grafico del servizio vengono conservati per 30 giorni.

Tracce

Un tracciamento raccoglie tutti i segmenti generati da una singola richiesta. La traccia utilizza un ID di traccia per tracciare il percorso di una richiesta tramite l'applicazione. Tale richiesta è in genere una richiesta HTTP GET o POST che attraversa un sistema di bilanciamento del carico, interagisce con il codice dell'applicazione e genera chiamate downstream verso altri AWS servizi o API Web esterne. Il primo servizio supportato con cui interagisce la richiesta HTTP aggiunge un'intestazione trace ID alla richiesta. Il servizio quindi propaga l'ID di traccia a valle per tenere traccia della latenza, della disposizione e di altri dati della richiesta.

L'immagine seguente mostra un esempio di applicazione che serve una richiesta. HTTP Il riepilogo della traccia contiene il codice di HTTP risposta, l'ora di invio della richiesta e quanto tempo fa l'applicazione ha fornito la richiesta. L'immagine seguente mostra anche una sequenza temporale per ogni segmento di traccia. La sequenza temporale mostra lo stato, il codice di HTTP risposta e il tempo impiegato dal segmento per terminare. Un grafico mostra la durata, l'ora di inizio e di fine di ogni segmento della traccia rispetto agli altri segmenti.

Per ulteriori informazioni su come vengono tracciate le fatture a raggi X, consulta la sezione AWS X-Ray Prezzi per informazioni su come vengono fatturate le tracce a raggi X. I dati di tracciamento vengono conservati per 30 giorni.

Campionamento

L'X-Ray SDK applica un algoritmo di campionamento per garantire un tracciamento efficiente e fornire un campione rappresentativo delle richieste servite dall'applicazione. Questo algoritmo determina quali richieste vengono tracciate. Per impostazione predefinita, X-Ray SDK registra la prima richiesta ricevuta all'inizio di ogni secondo e il cinque percento di eventuali richieste aggiuntive.

Per evitare di incorrere in costi del servizio durante l'acquisizione delle nozioni di base, il tasso di campionamento di default è conservativo. È possibile configurare X-Ray per modificare la frequenza di campionamento predefinita e configurare regole aggiuntive che applicano il campionamento in base alle proprietà del servizio o della richiesta.

Ad esempio, potresti voler disabilitare il campionamento e tracciare tutte le richieste di chiamate che modificano lo stato o gestiscono utenti o transazioni. Per chiamate di sola lettura ad alto volume, come sondaggi in background, controlli di integrità o manutenzione della connessione.

Per ulteriori informazioni, consulta Configura le regole di campionamento e l'API. CreateSamplingRule

Intestazione di tracciamento

Tutte le richieste vengono tracciate, fino a un numero minimo, che puoi configurare. Dopo aver raggiunto tale livello minimo, X-Ray traccia solo una percentuale delle richieste per evitare costi aggiuntivi. X-Ray aggiunge la decisione di campionamento e l'ID di traccia alle richieste HTTP nelle intestazioni di tracciamento che iniziano con. X-Amzn-Trace-Id X-Ray aggiunge queste intestazioni quando una richiesta interagisce con il primo AWS servizio che si integra con X-Ray. L'SDK X-Ray legge queste intestazioni e le include nella risposta.

X-Amzn-Trace-Id: Root=1-5759e988-bd862e3fe1be46a994272793;Sampled=1

Se la richiesta proviene da un'applicazione analizzata, l'intestazione di tracciamento può anche contenere un ID segmento padre. Ad esempio, se l'applicazione richiama un'API Web HTTP downstream con un client HTTP strumentato, X-Ray SDK aggiunge l'ID del segmento per la richiesta originale all'intestazione di tracciamento della richiesta downstream. Un'applicazione strumentata che serve la richiesta downstream utilizza l'ID del segmento principale per connettere le due richieste.

X-Amzn-Trace-Id: Root=1-5759e988-bd862e3fe1be46a994272793;Parent=53995c3f42cd8ad8;Sampled=1

Lambda o altri Servizi AWS potrebbero aggiungere parte di un'intestazione che inizia con Lineage come parte dei loro meccanismi di elaborazione. Non dovresti usare direttamente la parte aggiunta dell'intestazione trace.

X-Amzn-Trace-Id: Root=1-5759e988-bd862e3fe1be46a994272793;Sampled=1;Lineage=a87bd80c:1|68fd508a:5|c512fbe3:2

Espressioni filtro

Anche se si campiona un piccolo sottoinsieme di dati, un'applicazione complessa può generare molti dati di traccia. Utilizzate le espressioni di filtro per trovare tracce specifiche, comprese quelle per richieste individuali, percorsi o utenti specifici.

L'immagine seguente mostra una casella di testo nella console X-Ray che è possibile utilizzare per filtrare in base a un gruppo definito dall'utente. Per ulteriori informazioni sui gruppi, vedere la seguente sezione Gruppi.

Gruppi

È possibile utilizzare un gruppo all'interno di un'espressione di filtro per ridurre la quantità di dati di traccia e concentrarsi sui dati che soddisfano i criteri del gruppo.

Utilizza un gruppo per generare grafici di servizio, riepiloghi di traccia e CloudWatch metriche specifici per quel gruppo. Puoi chiamare per nome o tramite Amazon Resource Name (ARN). X-Ray controlla le tracce in ingresso rispetto all'espressione del filtro di gruppo man mano che vengono archiviate nel servizio X-Ray. CloudWatchpubblica ogni minuto le metriche per le tracce che corrispondono ai criteri del gruppo.

L'aggiornamento dell'espressione di filtro di un gruppo non modifica i dati già registrati. L'aggiornamento si applica solo per le successive tracce. Ciò può comportare un grafo unito delle espressioni nuove e vecchie. Per evitare di unire gruppi non connessi all'interno di un unico grafico, elimina il gruppo corrente e https://docs.aws.amazon.com/xray/latest/api/API_CreateGroup.html creane uno nuovo.

Per ulteriori informazioni sui gruppi, consulta. Configura i gruppi

Annotazioni e metadati

Quando si strumenta l'applicazione, l'SDK X-Ray registra le informazioni sulle richieste in entrata e in uscita. L'SDK registra anche informazioni sulle AWS risorse utilizzate e sull'applicazione stessa. Puoi aggiungere al documento di segmento altre informazioni come annotazioni e metadati. Le annotazioni e i metadati vengono combinati a livello di traccia. Possono essere aggiunti a qualsiasi segmento o sottosegmento.

Le annotazioni sono coppie chiave-valore indicizzate per essere utilizzate con le espressioni di filtro. Utilizzale per registrare i dati che desideri utilizzare per raggruppare le tracce nella console oppure per chiamare l'API GetTraceSummaries.

X-Ray indica fino a 50 annotazioni per traccia.

I metadati sono coppie chiave-valore con valori di qualsiasi tipo, inclusi oggetti ed elenchi, che non sono indicizzati. Utilizza i metadati per registrare dati aggiuntivi che desideri memorizzare all'interno del tracciamento ma non ti servono per effettuare ricerche all'interno dei tracciamenti.

È possibile visualizzare annotazioni e metadati nella finestra dei dettagli del segmento o del sottosegmento, all'interno della pagina dei dettagli di Trace nella console. CloudWatch Per ulteriori informazioni, consulta Visualizzare le tracce e i dettagli della traccia in. Esplora la console X-Ray

Errori, malfunzionamenti ed eccezioni

X-Ray tiene traccia degli errori nel codice dell'applicazione e di quelli restituiti dai servizi downstream. X-Ray tiene traccia dei seguenti codici di risposta delle richieste: HTTP

Se si verifica un'eccezione mentre l'applicazione sta servendo una richiesta strumentata, l'SDK X-Ray registra i dettagli sull'eccezione, incluso l'ID di traccia dello stack, se disponibile. È possibile visualizzare le eccezioni nei dettagli dei segmenti nella console X-Ray.