Questa pagina è stata tradotta dall'API Cloud Translation.

Trovare ed esplorare le tracce

Per trovare ed esplorare le singole tracce in dettaglio, utilizza la pagina Trace Explorer. Questa pagina mostra le tracce per le quali il tuo progetto Google Cloud immagazzina almeno uno span. I dati mostrati per ogni traccia e intervallo visualizzati includono informazioni di riepilogo, come la latenza e il tipo di comando, nonché informazioni dettagliate. Le informazioni dettagliate includono log, eventi e altre informazioni.

La pagina Esplorazione traccia mostra al massimo 1000 tracce.

Prima di iniziare

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

Potresti anche riuscire a 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.

Visualizzare le tracce recenti

Per visualizzare le tracce più recenti:

Nella console Google Cloud, vai alla pagina Esplora tracce.
Vai a Trace Explorer

Puoi trovare questa pagina anche utilizzando la barra di ricerca.

Se è la prima volta che utilizzi Trace, l'app potrebbe richiedere alcuni minuti per visualizzare le tracce. Lo screenshot seguente 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 sugli errori sono codificate nel colore di un punto. Il blu indica il successo e il rosso l'errore. Nello screenshot precedente, la maggior parte dei comandi è stata completata correttamente.
- La descrizione comando che si attiva quando tieni premuto il cursore sopra un punto, visualizza 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 visualizzata 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 cursore sul grafico Seleziona una traccia a un'estremità dell'intervallo di tempo e trascinalo orizzontalmente fino all'altra estremità dell'intervallo.
  Per ripristinare il grafico con l'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 cursore su un'estremità del valore di latenza e trascinalo verticalmente fino all'altra estremità.
  
  Per ripristinare il grafico con l'intervallo di tempo preimpostato, fai clic su Reimposta.
- Fai clic su Aggiungi filtro di traccia, seleziona un'opzione di filtro e poi seleziona o inserisci un valore del 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 MinLatency: 2000.
  
  Le seguenti opzioni di filtro sono sempre disponibili:
  - RootSpan: corrisponda al nome dell'intervallo principale.
  - SpanName: corrisponda al nome dell'intervallo.
  - Metodo: mostra le tracce i cui intervalli principali sono annotati con l'etichetta /http/method, se il valore dell'etichetta corrisponde al valore del filtro.
  - Stato: mostra 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: mostra le tracce la cui latenza è almeno uguale al valore del filtro. Il valore del filtro deve essere espresso in millisecondi.
  - HasLabel: mostra le tracce in cui l'etichetta specificata dal valore del filtro appare in almeno uno spazio.
  - Servizio: mostra le tracce che contengono almeno un intervallo il cui nome del servizio corrisponde al valore del filtro.
    
    Il nome del servizio per uno span viene estratto dall'attributo OpenTelemetryservice.name, se 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 visualizzare altre opzioni di filtro, ad esempio URL o etichette HTTP. Se hai un'etichetta definita dall'utente che corrisponde a un filtro predefinito, all'etichetta viene anteposto il prefisso ETIQUETTA per consentirti di distinguerle. Ad esempio, se crei un'etichetta Service, nel menu dei filtri vengono visualizzati sia Servizio sia Etichetta:servizio.
  
  Nota: per eseguire una corrispondenza esatta, anteponi al valore del filtro un segno più (+). Se ometti il segno più, una corrispondenza viene determinata eseguendo un test di prefisso con il valore del filtro. Per ulteriori dettagli sulle opzioni di filtro, consulta Filtri di Trace.

Trovare una traccia per ID

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

Nella console Google Cloud, vai alla pagina Esplora tracce.
Vai a Trace Explorer

Puoi trovare questa pagina anche utilizzando la barra di ricerca.
Seleziona un progetto Google Cloud da cui visualizzare i dati delle tracce.

Devi selezionare il progetto Google Cloud che memorizza i dati traccia, a meno che il progetto non faccia parte di un'organizzazione. Quando un progetto fa parte di un'organizzazione, puoi configurare il monitoraggio tra progetti, il che ti consente di visualizzare i dati di traccia di qualsiasi progetto dell'organizzazione. Per ulteriori informazioni, consulta Visualizzare le tracce in più progetti.
Inserisci l'ID nel campo ID traccia.

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

Esplorare una traccia

Per esplorare una traccia, fai clic su un punto nel grafico a dispersione. Quando fai clic su un punto nel grafico a dispersione, nella pagina Trace Explorer vengono apportate le seguenti modifiche:

Il grafico a dispersione viene aggiornato e il punto selezionato viene evidenziato con un cerchio attorno. 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 di 128 bit rappresentato come stringa esadecimale di 32 byte. Per maggiori dettagli, consulta Resource: Trace.
- Una riga di riepilogo che elenca l'ora di inizio, la durata e il numero di intervalli.
- Un menu Log ed eventi. La selezione del menu controlla la modalità di visualizzazione di log ed eventi. Per impostazione predefinita, se esiste un log o un evento, viene aggiunto un cerchio all'intervallo della traccia. I cerchi sovrapposti indicano che l'intervallo contiene più log o eventi. Per visualizzare ogni log o evento come riga nella tabella, espandi Log ed eventi e seleziona Mostra espanso.
- Una tabella. La prima riga della tabella è per la traccia. Viene aggiunta una riga per ogni intervallo della traccia.
  
  Per gli intervalli, la tabella elenca il nome dell'intervallo e il servizio associato. Il nome del servizio viene estratto dall'attributo OpenTelemetry service.name, se 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 della latenza, dello stato e, se presenti, delle annotazioni degli eventi. Una barra di latenza blu indica un completamento riuscito, mentre una barra di latenza rossa indica che si è verificato un errore. Ogni annotazione evento nello spazio è rappresentata da un cerchio sulla barra della latenza.

Di seguito è riportato un esempio del riquadro Dettagli su Trace:

Esempi del riquadro dei dettagli di Cloud Trace.

Cerca gli intervalli all'interno di una traccia

Puoi cercare parole chiave negli intervalli e negli attributi di una traccia. Ad esempio, nello screenshot precedente, alcuni elementi e una chiave dell'attributo sono evidenziati. Questi campi sono evidenziati perché corrispondono al termine di ricerca, ovvero net.sock.peer.port.

Per cercare gli intervalli in una traccia, nella barra degli strumenti del riquadro Dettagli traccia, inserisci il termine di ricerca nel campo Cerca nella traccia e premi Invio.

Trace esegue quindi una ricerca in campi selezionati di ogni intervallo nella traccia visualizzata. Una corrispondenza si verifica quando un campo sottoposto a ricerca contiene il termine di ricerca, ignorando le maiuscole. Viene eseguita la ricerca nei seguenti campi:

Nome dell'intervallo.
Nome del servizio.
Chiavi e valori degli attributi.

Al termine della ricerca, il riquadro Dettagli traccia viene aggiornato e i campi corrispondenti vengono evidenziati.

Ad esempio, se inserisci il termine get, viene evidenziato uno spazio con un attributo la cui chiave è /http/method e il cui valore è GET. Inoltre, gli elementi spanning con nomi come CurrencyService/GetSupportedCurrencies sono evidenziati.

Non puoi eseguire ricerche utilizzando un'espressione regolare e non puoi cercare log, eventi o metadati.

Visualizza i dettagli dell'intervallo

Per visualizzare informazioni dettagliate sulla traccia o su uno span specifico, nel riquadro Dettagli traccia fai clic sulla barra della latenza per la voce. Quando selezioni la barra della latenza, il riquadro Dettagli traccia viene ridisegnato e viene visualizzata una tabella con schede che fornisce informazioni aggiuntive sulla voce.

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

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

Per trovare le etichette associate a un intervallo, visualizza la scheda Attributi. Per informazioni sulle etichette, vedi Etichette di Trace. Il seguente screenshot mostra 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 dell'etichetta contiene g.co.
Per visualizzare le informazioni sulle voci e sugli eventi dei log correlati, se esistono, visualizza la scheda Log ed eventi. Per informazioni sulle annotazioni degli eventi, consulta Annotare gli intervalli di traccia. Il seguente screenshot mostra questa scheda:

Quando i dati dei log sono disponibili, per visualizzare i dettagli di una voce di log, fai clic su Mostra altro:
Per trovare informazioni sul numero di tracce dello stack disponibili e su informazioni dettagliate su una traccia dello stack acquisita, utilizza la scheda Tracce dello stack.
Per trovare informazioni generali sull'intervallo e una tabella di 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 di fine
- Tabella che elenca i link ad altri intervalli
  
  Ogni riga della tabella denominata Collegamenti elenca un collegamento tra l'intervallo corrente e un altro intervallo. Il campo Attributi elenca le coppie chiave-valore per l'intervallo a cui si fa riferimento. Il campo Traccia rimanda alla traccia per l'intervallo collegato. Quando 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.
Il seguente screenshot mostra questa scheda: