Visualizzazione dei tracciamenti Esplorazione della cronologia di tracciamento Visualizzazione dei dettagli del segmento Visualizzazione dei dettagli del sottosegmento

Visualizzazione delle tracce e dei dettagli delle tracce

Usa la pagina Tracce nella X-Ray console per trovare le tracce tramite URL, codice di risposta o altri dati dal riepilogo della traccia. Dopo aver selezionato una traccia dall'elenco delle tracce, la pagina dei dettagli della traccia mostra una mappa dei nodi di servizio associati alla traccia selezionata e una cronologia dei segmenti di traccia.

Visualizzazione dei tracciamenti

CloudWatch console

Per visualizzare le tracce nella console CloudWatch

Accedi Console di gestione AWS e apri la CloudWatch console all'indirizzo https://console.aws.amazon.com/cloudwatch/.
Nel riquadro di navigazione a sinistra, scegli X-Ray Tracce, quindi scegli Tracce. Puoi filtrare per gruppo o inserire un'espressione di filtro. Questo filtra le tracce visualizzate nella sezione Tracce nella parte inferiore della pagina.

In alternativa, è possibile utilizzare la mappa dei servizi per accedere a un nodo di servizio specifico e quindi visualizzare le tracce. Si apre la pagina Traces con una query già applicata.
Perfeziona la tua query nella sezione Query Refiners. Per filtrare le tracce in base a un attributo comune, scegli un'opzione dalla freccia in giù accanto a Perfeziona la query per. Le opzioni sono le seguenti:
- Nodo: filtra le tracce per nodo di servizio.
- Resource ARN: filtra le tracce in base a una risorsa associata a una traccia. Esempi di queste risorse includono un'istanza Amazon Elastic Compute Cloud (Amazon EC2), una AWS Lambda funzione o una tabella. Amazon DynamoDB
- Utente: filtra le tracce con un ID utente.
- Messaggio relativo alla causa principale dell'errore: filtra le tracce in base alla causa principale dell'errore.
- URL: filtra le tracce in base al percorso URL utilizzato dall'applicazione.
- Codice di stato HTTP: filtra le tracce in base al codice di stato HTTP restituito dall'applicazione. È possibile specificare un codice di risposta personalizzato o selezionare una delle seguenti opzioni:
  - 200— La richiesta è andata a buon fine.
  - 401— Nella richiesta mancavano credenziali di autenticazione valide.
  - 403— La richiesta non disponeva di autorizzazioni valide.
  - 404— Il server non è riuscito a trovare la risorsa richiesta.
  - 500— Il server ha riscontrato una condizione imprevista e ha generato un errore interno.
Scegli una o più voci, quindi scegli Aggiungi alla query per aggiungerle all'espressione di filtro nella parte superiore della pagina.
Per trovare una singola traccia, inserisci un ID di traccia direttamente nel campo della query. Puoi utilizzare il X-Ray formato o il formato World Wide Web Consortium (W3C). Ad esempio, una traccia creata utilizzando il AWS Distro for OpenTelemetry è in formato W3C.

Nota
Quando si interrogano le tracce create con un ID di W3C-format traccia, la console visualizza la traccia corrispondente nel formato. X-Ray Ad esempio, se si esegue una query 4efaaf4d1e8720b39541901950019ee5 in formato W3C, la console visualizza l' X-Ray equivalente:. 1-4efaaf4d-1e8720b39541901950019ee5
Scegli Esegui la query in qualsiasi momento per visualizzare un elenco di tracce corrispondenti nella sezione Tracce nella parte inferiore della pagina.
Per visualizzare la pagina dei dettagli della traccia per una singola traccia, seleziona un ID di traccia dall'elenco.

L'immagine seguente mostra una mappa di traccia contenente i nodi di servizio associati alla traccia e i bordi tra i nodi che rappresentano il percorso intrapreso dai segmenti che compongono la traccia. Un riepilogo di Trace segue la Trace Map. Il riepilogo contiene informazioni su un'GEToperazione di esempio, il relativo codice di risposta, la durata impiegata per l'esecuzione della traccia e l'età della richiesta. La cronologia dei segmenti segue il riepilogo della traccia che mostra la durata dei segmenti e dei sottosegmenti di traccia.

Se disponi di un'applicazione basata sugli eventi che utilizza Amazon SQS e Lambda, puoi visualizzare una vista connessa delle tracce per ogni richiesta nella mappa Trace. Nella mappa, le tracce dei produttori di messaggi sono collegate alle tracce dei AWS Lambda consumatori e vengono visualizzate come un bordo tratteggiato. Per ulteriori informazioni sulle applicazioni basate sugli eventi, vedere. Tracciamento delle applicazioni basate sugli eventi

Le pagine dei dettagli di Traces e Trace supportano anche il tracciamento tra account, che può elencare le tracce di più account nell'elenco di tracce e all'interno di una singola mappa di traccia.

X-Ray console

Per visualizzare le tracce nella console X-Ray

Apri la pagina Tracce nella X-Ray console. Il pannello di panoramica delle tracce mostra un elenco di tracce raggruppate per caratteristiche comuni, tra cui Error root causes, ResourceARN e. InstanceId
Per selezionare una feature comune per visualizzare un insieme raggruppato di tracce, espandi la freccia verso il basso accanto a Raggruppa per. L'illustrazione seguente mostra una panoramica delle tracce raggruppate per URL e un elenco delle tracce associate. AWS X-Ray applicazione di esempio
Scegli l'ID di una traccia per visualizzarla nell'elenco Trace. Puoi anche scegliere Service map nel pannello di navigazione per visualizzare le tracce per un nodo di servizio specifico. Quindi puoi visualizzare le tracce associate a quel nodo.

La scheda Timeline mostra il flusso di richieste per la traccia e include quanto segue:
- Una mappa del percorso per ogni segmento della traccia.
- Quanto tempo ha impiegato il segmento per raggiungere un nodo nella mappa di tracciamento.
- Quante richieste sono state fatte al nodo nella mappa di tracciamento.
La figura seguente mostra un esempio di Trace Map associata a una GET richiesta effettuata a un'applicazione di esempio. Le frecce mostrano il percorso seguito da ciascun segmento per completare la richiesta. I nodi del servizio mostrano il numero di richieste effettuate durante la GET richiesta.

Per ulteriori informazioni sulla scheda Timeline, consulta la seguente sezione Esplorazione della timeline di traccia.

La scheda Dati grezzi mostra le informazioni sulla traccia e sui segmenti e sottosegmenti che la compongono, in formato. JSON Queste informazioni possono includere quanto segue:
- Timestamp
- ID univoci
- Risorse associate al segmento o sottosegmento
- L'origine o l'origine del segmento o sottosegmento
- Informazioni aggiuntive sulla richiesta all'applicazione, ad esempio la risposta a una richiesta HTTP

Esplorazione della cronologia di tracciamento

La sezione Cronologia mostra una gerarchia di segmenti e sottosegmenti accanto a una barra orizzontale che corrisponde al tempo impiegato per completare le attività. La prima voce nell'elenco è il segmento, che rappresenta tutti i dati registrati tramite il servizio per una singola richiesta. I sottosegmenti sono rientrati ed elencati dopo il segmento. Le colonne contengono informazioni su ciascun segmento.

CloudWatch console

Nella CloudWatch console, la timeline dei segmenti fornisce le seguenti informazioni:

La prima colonna: elenca i segmenti e i sottosegmenti nella traccia selezionata.
La colonna Stato del segmento: elenca il risultato dello stato di ogni segmento e sottosegmento.
La colonna Codice di risposta: elenca un codice di stato della risposta HTTP a una richiesta del browser effettuata dal segmento o sottosegmento, se disponibile.
La colonna Durata: elenca la durata del segmento o sottosegmento.
La colonna Ospitato in: elenca lo spazio dei nomi o l'ambiente in cui viene eseguito il segmento o sottosegmento, se applicabile. Per ulteriori informazioni, consulta Dimensioni raccolte e combinazioni di dimensioni.
L'ultima colonna: visualizza le barre orizzontali che corrispondono alla durata di funzionamento del segmento o sottosegmento, in relazione agli altri segmenti o sottosegmenti nella timeline.

Per raggruppare l'elenco di segmenti e sottosegmenti per nodo di servizio, attiva Raggruppa per nodi.

X-Ray console

Nella pagina dei dettagli della traccia, scegli la scheda Cronologia per visualizzare la cronologia di ogni segmento e sottosegmento che compone una traccia.

Nella X-Ray console, la timeline fornisce le seguenti informazioni:

La colonna Nome: elenca i nomi dei segmenti e dei sottosegmenti nella traccia.
La colonna Res.: elenca un codice di stato della risposta HTTP a una richiesta del browser effettuata dal segmento o sottosegmento, se disponibile.
La colonna Durata: elenca la durata del segmento o sottosegmento.
La colonna Stato: elenca il risultato dello stato del segmento o sottosegmento.
Ultima colonna: visualizza le barre orizzontali che corrispondono alla durata di funzionamento del segmento o sottosegmento, in relazione agli altri segmenti o sottosegmenti nella timeline.

Per visualizzare i dati di traccia non elaborati utilizzati dalla console per generare la timeline, scegli la scheda Dati grezzi. I dati grezzi mostrano informazioni sulla traccia e sui segmenti e sottosegmenti che la compongono in formato. JSON Queste informazioni possono includere quanto segue:

Timestamp
ID univoci
Risorse associate al segmento o sottosegmento
L'origine o l'origine del segmento o sottosegmento
Informazioni aggiuntive sulla richiesta all'applicazione, ad esempio la risposta a una richiesta HTTP.

Quando si utilizza un AWS SDK o un SQL client strumentato per effettuare chiamate a risorse esterne, l' X-Ray SDK registra automaticamente i sottosegmenti. HTTP Puoi anche utilizzare l' X-Ray SDK per registrare sottosegmenti personalizzati per qualsiasi funzione o blocco di codice. I sottosegmenti aggiuntivi registrati mentre un sottosegmento personalizzato è aperto diventano figli del sottosegmento personalizzato.

Visualizzazione dei dettagli del segmento

Dalla timeline di tracciamento, scegliete il nome di un segmento per visualizzarne i dettagli.

Il pannello dei dettagli del segmento mostra le schede Panoramica, Risorse, Annotazioni, Metadati, Eccezioni e SQL. Si applica quanto segue:

La scheda Overview (Panoramica) mostra le informazioni su richiesta e risposta. Le informazioni includono il nome, l'ora di inizio, l'ora di fine, la durata, l'URL della richiesta, l'operazione della richiesta, il codice di risposta alla richiesta ed eventuali errori e guasti.
La scheda Risorse per un segmento mostra le informazioni dall' X-RaySDK e sulle AWS risorse che eseguono l'applicazione. Usa i plug-in Amazon EC2 o Amazon ECS per l' X-Ray SDK per registrare informazioni sulle risorse specifiche del servizio. AWS Elastic Beanstalk Per ulteriori informazioni sui plug-in, consulta la sezione Plugin di servizio in. Configurazione dell'X-Ray SDK per Java
Le schede rimanenti mostrano le annotazioni, i metadati e le eccezioni registrati per il segmento. Le eccezioni vengono acquisite automaticamente quando vengono generate da una richiesta strumentata. Le annotazioni e i metadati contengono informazioni aggiuntive che vengono registrate utilizzando le operazioni fornite dall'SDK. X-Ray Per aggiungere annotazioni o metadati ai segmenti, usa l'SDK. X-Ray Per ulteriori informazioni, consulta il link specifico della lingua elencato in Strumenting your application with SDK in. AWS X-Ray Strumentazione della tua applicazione per AWS X-Ray

Visualizzazione dei dettagli del sottosegmento

Dalla timeline di tracciamento, scegli il nome di un sottosegmento per visualizzarne i dettagli:

La scheda Panoramica contiene informazioni sulla richiesta e sulla risposta. Ciò include il nome, l'ora di inizio, l'ora di fine, la durata, la richiestaURL, l'operazione della richiesta, il codice di risposta alla richiesta ed eventuali errori e guasti. Per i sottosegmenti generati dai client analizzati, la scheda Overview (Panoramica) contiene informazioni sulla richiesta e la risposta dal punto di vista dell'applicazione.
La scheda Risorse per un sottosegmento mostra i dettagli sulle AWS risorse utilizzate per eseguire il sottosegmento. Ad esempio, la scheda delle risorse può includere una AWS Lambda funzione ARN, informazioni su una tabella DynamoDB, qualsiasi operazione chiamata e l'ID della richiesta.
Le schede rimanenti mostrano le annotazioni, i metadati e le eccezioni registrati nel sottosegmento. Le eccezioni vengono acquisite automaticamente quando vengono generate da una richiesta strumentata. Le annotazioni e i metadati contengono informazioni aggiuntive che vengono registrate utilizzando le operazioni fornite dall'SDK. X-Ray Usa l' X-Ray SDK per aggiungere annotazioni o metadati ai tuoi segmenti. Per ulteriori informazioni, consulta il link specifico della lingua elencato in Strumenting your application with SDK in. AWS X-Ray Strumentazione della tua applicazione per AWS X-Ray

Nel caso di sottosegmenti personalizzati, la scheda Overview (Panoramica) mostra il nome del sottosegmento, che è possibile impostare per specificare l'area del codice o della funzione che memorizza. Per ulteriori informazioni, consulta il link specifico della lingua elencato in Strumentazione dell'applicazione con SDK in. AWS X-Ray Generazione di sottosegmenti personalizzati con l' X-Ray SDK for Java

L'immagine seguente mostra la scheda Panoramica per un sottosegmento personalizzato. La panoramica contiene l'ID del sottosegmento, l'ID principale, il nome, l'ora di inizio e di fine, la durata, lo stato e gli errori o i guasti.