Trova ed esplora le tracce

Per trovare ed esplorare le singole tracce in dettaglio, utilizza la pagina Esplora traccia. Questa pagina mostra le tracce per cui il progetto Google Cloud archivia almeno un intervallo. I dati mostrati per ogni traccia e intervallo visualizzati includono informazioni di riepilogo, come la latenza e il tipo di comando, nonché informazioni dettagliate. che includono log, eventi e altre informazioni.

La pagina Esplora traccia mostra al massimo 1000 tracce.

Prima di iniziare

Per ottenere le autorizzazioni necessarie per visualizzare i dati di traccia utilizzando la console Google Cloud, chiedi all'amministratore di concederti il ruolo IAM Utente Cloud Trace (roles/cloudtrace.user) per il tuo progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.

Potresti anche essere in grado di ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Per ulteriori informazioni sui ruoli, consulta Controllare l'accesso con Identity and Access Management.

Visualizza tracce recenti

Per visualizzare le tracce più recenti:

Nel pannello di navigazione della console Google Cloud, seleziona Trace e poi Trace Explorer:
Vai a Trace Explorer

Se è la prima volta che utilizzi Trace, potrebbero volerci alcuni minuti prima che le tracce vengano visualizzate. Il seguente screenshot mostra un esempio della pagina Trace Explorer:

Il grafico a dispersione mostra un punto per ogni richiesta nell'intervallo di tempo selezionato:
- Le coordinate (x,y) di una richiesta corrispondono al tempo e alla latenza della richiesta.
- Le informazioni sull'errore sono codificate con il colore di un punto. Il blu indica l'esito positivo, mentre il rosso indica un errore. Nello screenshot precedente, la maggior parte dei comandi è stata completata correttamente.
- La descrizione comando che si attiva quando tieni il puntatore sopra un punto mostra la data, l'ora, l'URI e la latenza:
(Facoltativo) Per filtrare le tracce e gli intervalli visualizzati, esegui una delle seguenti operazioni:
- Filtra per ora. Per impostazione predefinita, viene mostrata l'ora di dati più recente. Per visualizzare un intervallo di tempo personalizzato:
  1. Seleziona un'opzione preimpostata più lunga dell'intervallo di tempo personalizzato.
  2. Posiziona il puntatore sul grafico Seleziona una traccia a un'estremità dell'intervallo temporale e trascina il puntatore orizzontalmente fino all'altra estremità dell'intervallo.
  Per ripristinare il grafico all'intervallo di tempo preimpostato, fai clic su Reimposta.
- Filtra per latenza. Per impostazione predefinita, vengono visualizzate tutte le tracce nell'intervallo di tempo selezionato. Per limitare la visualizzazione alle tracce la cui latenza rientra in un intervallo, posiziona il puntatore a un'estremità del valore di latenza e trascinalo verticalmente fino all'altra estremità.
  
  Per ripristinare il grafico all'intervallo di tempo preimpostato, fai clic su Reimposta.
- Fai clic su Aggiungi filtro di traccia, seleziona un'opzione di filtro, poi seleziona o inserisci un valore di filtro. Se aggiungi più filtri, vengono visualizzate solo le tracce che soddisfano tutti i filtri. Ad esempio, per mostrare tutte le tracce che contengono un comando GET HTTP e la cui latenza è di almeno 2 secondi, aggiungi i filtri Method: GET e MinLatenza: 2000.
  
  Le seguenti opzioni di filtro sono sempre disponibili:
  - RootSpan: corrisponde al nome dell'intervallo principale.
  - SpanName: corrisponde al nome dell'intervallo.
  - Metodo: visualizza le tracce i cui intervalli principali sono annotati con l'etichetta /http/method, dove il valore dell'etichetta corrisponde al valore del filtro.
  - Stato: visualizza le tracce i cui intervalli principali sono annotati con l'etichetta /http/status_code, dove l'etichetta del valore corrisponde al valore del filtro. Il valore del filtro può contenere codici di stato specifici, come 301, o intervalli di valori di stato, come 3xx.
  - MinLatency: visualizza le tracce la cui latenza è almeno pari al valore del filtro. Il valore del filtro deve essere in millisecondi.
  - HasLabel: mostra le tracce in cui l'etichetta specificata dal valore del filtro compare in almeno un intervallo.
  - Servizio: visualizza le tracce che contengono almeno un intervallo il cui nome di servizio corrisponde al valore del filtro.
    
    Il nome del servizio per un intervallo viene estratto dall'attributo OpenTelemetry service.name, quando questo attributo è impostato. Se questo attributo non è impostato e se il servizio è in esecuzione su App Engine, viene visualizzato il nome del servizio App Engine. In caso contrario, il servizio non è specificato.
  - Versione: (solo App Engine) mostra le tracce che contengono almeno un intervallo la cui versione dell'applicazione corrisponde al valore del filtro.
  Potresti vedere altre opzioni di filtro, ad esempio URL o etichette HTTP. Se hai un'etichetta definita dall'utente che corrisponde a un filtro predefinito, l'etichetta definita dall'utente avrà come prefisso LABEL in modo che tu possa distinguere tra i due. Ad esempio, se crei un'etichetta Service, vedrai sia Servizio che LABEL:Servizio nel menu del filtro.
  
  Nota: per eseguire una corrispondenza esatta, anteponi un segno più (+) al valore del filtro. Se ometti questo segno più, la corrispondenza viene determinata eseguendo un test con prefisso con il valore del filtro. Per maggiori dettagli sulle opzioni di filtro, consulta Filtri di tracciamento.

Trova una traccia per ID

Quando stai risolvendo un incidente o un errore, potresti conoscere l'ID traccia. Per esplorare questa traccia:

Nel pannello di navigazione della console Google Cloud, seleziona Trace e poi Trace Explorer:
Vai a Trace Explorer
Seleziona un progetto Google Cloud da cui visualizzare i dati di traccia.

Devi selezionare il progetto Google Cloud che archivia i dati di traccia, a meno che il progetto non faccia parte di un'organizzazione. Quando un progetto fa parte di un'organizzazione, puoi configurare il tracciamento tra progetti, in modo da visualizzare i dati di traccia da qualsiasi progetto nell'organizzazione. Per saperne di più, vedi Visualizzare le tracce tra progetti.
Inserisci l'ID nel campo ID traccia.

Quando inserisci un ID valido, il riquadro Dettagli traccia viene compilato con le informazioni sulla traccia e sui relativi intervalli. Puoi usare le opzioni nel riquadro per esplorare la traccia.

Esplora una traccia

Per esplorare una traccia, fai clic su un punto nel grafico a dispersione. Quando fai clic su un punto del grafico a dispersione, alla pagina Esplora traccia vengono apportate le seguenti modifiche:

Il grafico a dispersione viene aggiornato e il punto selezionato viene evidenziato con un cerchio disegnato intorno a quest'ultimo. I punti che rappresentano tutte le altre tracce sono attenuati.
Il riquadro Dettagli traccia mostra quanto segue:
- L'identificatore della traccia. Questo identificatore univoco globale per la traccia è un numero intero a 128 bit rappresentato come una stringa esadecimale di 32 byte. Per maggiori dettagli, consulta Resource: Trace.
- Una riga di riepilogo in cui sono elencate l'ora di inizio, la durata e il numero di intervalli.
- Un menu Log ed eventi. La selezione del menu controlla come vengono visualizzati log ed eventi. Per impostazione predefinita, se esiste un log o un evento, viene aggiunto un cerchio all'intervallo di traccia. I cerchi sovrapposti indicano che l'intervallo ha più log o eventi. Per visualizzare ogni log o evento sotto forma di riga nella tabella, espandi Log ed eventi e seleziona Mostra espansi.
- Una tabella. La prima riga della tabella è riservata alla traccia. Viene aggiunta una riga per ogni intervallo nella traccia.
  
  Per gli intervalli, la tabella elenca il nome dell'intervallo e il servizio associato all'intervallo. Il nome del servizio viene estratto dall'attributo di OpenTelemetry service.name, quando questo attributo è impostato. Se questo attributo non è impostato e se il servizio è in esecuzione su App Engine, viene visualizzato il nome del servizio App Engine. In caso contrario, il servizio non è specificato.
  
  La colonna Latenza fornisce una rappresentazione visiva delle annotazioni di eventi, lo stato e, se presenti. Una barra di latenza blu indica che il completamento è riuscito, mentre una barra di latenza rossa indica che si è verificato un errore. Ogni annotazione di evento nello spazio è rappresentata da un cerchio nella barra di latenza.

Di seguito è riportato un esempio di riquadro Dettagli traccia:

Esempi del riquadro dei dettagli di Cloud Trace.

Visualizza dettagli intervallo

Per visualizzare informazioni dettagliate sulla traccia o su un intervallo specifico, nel riquadro Dettagli traccia fai clic sulla barra di latenza della voce. Quando selezioni la barra di latenza, il riquadro Dettagli traccia viene ridisegnato e mostra una tabella a schede che fornisce informazioni aggiuntive sulla voce.

Se selezioni la barra di latenza per la prima riga della tabella, la riga con il nome ID traccia, la tabella contiene due schede: Riepilogo e Log. Nella scheda Riepilogo sono elencate informazioni generali sulla traccia. Ad esempio, per i comandi HTTP, questa scheda visualizza il tipo di comando HTTP, il servizio e le informazioni sulla latenza per ogni intervallo nella traccia.

Se selezioni la barra di latenza per le altre righe della tabella, ovvero una riga per un intervallo, la tabella conterrà quattro schede: Attributi, Log ed eventi, Analisi dello stack, Metadati e link:

Per trovare le etichette associate a un intervallo, visualizza la scheda Attributi. Per informazioni sulle etichette, consulta Trace etichette. Lo screenshot seguente illustra questa scheda:

Per individuare un'etichetta specifica o un gruppo di etichette, aggiungi un filtro. Ad esempio, se aggiungi il filtro Chiave: g.co, la tabella elenca tutte le etichette in cui la chiave di etichetta contiene g.co.
Per visualizzare le informazioni su voci di log ed eventi correlati, se presenti, visualizza la scheda Log ed eventi. Per informazioni sulle annotazioni di eventi, consulta Annotazione degli intervalli di traccia. Lo screenshot seguente illustra questa scheda:

Quando i dati di log sono disponibili, per visualizzare i dettagli di una voce di log, fai clic su Mostra altro:
Per trovare informazioni sul numero di analisi dello stack disponibili e informazioni dettagliate su un'analisi dello stack acquisita, utilizza la scheda Analisi dello stack.
Per trovare informazioni generali sull'intervallo e una tabella dei link ad altri intervalli, visualizza la scheda Metadati e link. Queste informazioni includono quanto segue:
- ID intervallo
  
  L'ID intervallo è un numero intero a 64 bit diverso da 0. Per maggiori dettagli, consulta TraceSpan.
- ID intervallo padre
- ID progetto
- Ora di inizio e ora di fine
- Tabella che elenca i link ad altri intervalli
  
  Ogni riga nella tabella denominata Link elenca un collegamento tra l'intervallo corrente e un altro. Il campo Attributi elenca le coppie chiave-valore per l'intervallo collegato. Il campo Trace rimanda alla traccia per l'intervallo collegato. Se questo campo contiene Traccia corrente, l'intervallo collegato si trova nella stessa traccia dell'intervallo corrente. In caso contrario, il campo contiene un ID traccia. Per informazioni sui link, consulta la pagina di riferimento dell'API Links.
Lo screenshot seguente illustra questa scheda: