Questa pagina è stata tradotta dall'API Cloud Translation.

Trovare ed esplorare le tracce

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

La pagina Esplora tracce mostra al massimo 1000 le tracce audio.

Prima di iniziare

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

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite la ruoli o altri ruoli predefiniti ruoli.

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

Visualizza 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, potrebbero essere necessari alcuni minuti prima che le tracce vengano visualizzate. Il seguente screenshot mostra un esempio di Esplora tracce pagina:

Il grafico a dispersione mostra un punto per ogni richiesta nell'elemento intervallo di tempo:
- Le coordinate (x,y) per una richiesta corrispondono alle tempi e latenza della richiesta.
- Le informazioni sull'errore sono codificate nel colore di un punto. Il blu indica operazione riuscita, mentre il rosso indica un errore. Nella precedente screenshot mostra che la maggior parte dei comandi è stata completata correttamente.
- La descrizione comando che si attiva quando tieni il puntatore 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, l'ora di dati più recente . Per visualizzare un intervallo di tempo personalizzato:
  1. Seleziona un'opzione preimpostata più lunga di quella personalizzata intervallo di tempo.
  2. Posiziona il puntatore sul grafico Seleziona una traccia alla fine del tempo impostato. intervallo e trascina il puntatore orizzontalmente all'altra estremità del intervallo di tempo.
  Per ripristinare l'intervallo di tempo preimpostato nel grafico, fai clic su Reimposta.
- Filtra per latenza. Per impostazione predefinita, tutte le tracce nell'intervallo di tempo selezionato vengono visualizzati. Per limitare la visualizzazione alle tracce la cui latenza è all'interno di un intervallo, posiziona il puntatore a un'estremità del valore di latenza e trascina il puntatore verticalmente verso l'altra estremità.
  
  Per ripristinare l'intervallo di tempo preimpostato nel grafico, fai clic su Reimposta.
- Fai clic su Aggiungi filtro di traccia, seleziona un'opzione di filtro e quindi 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 HTTP GET 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: associa il nome dell'intervallo principale.
  - SpanName: associa il nome dell'intervallo.
  - Metodo: visualizza le tracce i cui intervalli principali sono annotati con il /http/method, in cui il valore dell'etichetta corrisponde il valore del filtro.
  - Stato: visualizza le tracce i cui intervalli principali sono annotati con il Etichetta /http/status_code, in cui l'etichetta del valore corrisponde il valore del filtro. Il valore del filtro può contenere codici di stato specifici ad esempio 301 o intervalli di valori di stato, ad esempio 3xx.
  - MinLatency: visualizza tracce la cui latenza è almeno pari a come valore del filtro. Il valore del filtro deve essere espresso in millisecondi.
  - HasLabel: mostra le tracce in cui l'etichetta specificata dal filtro viene visualizzato in almeno un intervallo.
  - Servizio: mostra tracce che contengono almeno un intervallo il cui nome servizio corrisponde al valore del filtro.
    
    Il nome del servizio per un intervallo viene estratto da OpenTelemetry attributo service.name, quando questo attributo è impostato. Se questo attributo non è impostato e se il servizio è in esecuzione App Engine, il nome del servizio App Engine visualizzati. In caso contrario, il servizio non è specificato.
  - Versione: (solo App Engine) visualizza 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, l'etichetta definita dall'utente è preceduta dal prefisso LABEL per consentirti di distinguere tra i due. Ad esempio, se crei un'etichetta Service, vedi sia Servizio che LABEL:Servizio nel menu del filtro.
  
  Nota: per eseguire una corrispondenza esatta, aggiungi un segno più davanti al valore del filtro (+). Se ometti il segno più, la corrispondenza è determinata eseguendo un test del prefisso con il valore del filtro. Per ulteriori dettagli sulle opzioni di filtro, consulta Filtri di Trace.

Trova una traccia per ID

Quando stai risolvendo un incidente o un errore, potresti conoscere l'ID della 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 di traccia.

Devi selezionare il progetto Google Cloud in cui sono archiviati i dati di traccia, a meno che il tuo progetto fa parte di un'organizzazione. Quando un progetto fa parte di un'organizzazione, puoi configurare il tracciamento tra progetti consente di visualizzare i dati di traccia di qualsiasi progetto nell'organizzazione. Per saperne di più, consulta Visualizzare le tracce tra progetti.
Inserisci l'ID nel campo ID traccia.

Quando inserisci un ID valido, il riquadro Dettagli traccia viene compilato con e informazioni sulla traccia e sui suoi intervalli. Puoi utilizzare le opzioni in questo 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 nel grafico a dispersione, si verificano le seguenti variazioni: alla pagina Esplora tracce:

Il grafico a dispersione viene aggiornato e il punto selezionato è evidenziato con un cerchio intorno al punto. I punti che rappresentano tutti gli altri le tracce sono attenuate.
Il riquadro Dettagli traccia mostra quanto segue:
- L'identificatore della traccia. L'identificatore univoco globale per la traccia è un Numero intero a 128 bit rappresentato come una stringa esadecimale a 32 byte. Per maggiori dettagli, consulta Resource: Trace.
- Una riga di riepilogo che elenca l'ora di inizio, la durata e il numero intervalli.
- A Log e eventi. La selezione del menu controlla il modo in cui log ed eventi vengono visualizzate le informazioni. Per impostazione predefinita, quando esiste un log o un evento, viene aggiunta una cerchia l'intervallo di traccia. I cerchi sovrapposti indicano che l'intervallo è più log o eventi. Per visualizzare ogni log o evento come riga nella tabella, espandi Log e eventi e Seleziona Mostra espansi.
- Una tabella. La prima riga della tabella è dedicata 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 con l'intervallo. Il nome del servizio viene estratto Attributo OpenTelemetry service.name, quando questo attributo è impostato. Se questo attributo non è impostato e se il servizio è in esecuzione App Engine, il nome del servizio App Engine visualizzati. In caso contrario, il servizio non è specificato.
  
  La colonna Latenza fornisce una rappresentazione visiva della latenza, e, se presenti, annotazioni degli eventi. Una barra di latenza blu indica un completamento riuscito, una barra di latenza rossa indica che si è verificato un errore. Ogni annotazione evento nello spazio è rappresentata da un cerchio barra di latenza.

Quanto segue mostra un esempio di riquadro Dettagli traccia:

Esempi del riquadro dei dettagli di Cloud Trace.

Cerca intervalli all'interno di una traccia

Puoi cercare intervalli e attributi in una traccia per parole chiave. Ad esempio: nello screenshot precedente, sono evidenziati alcuni intervalli e una chiave attributo. Questi campi sono evidenziati perché corrispondono al termine di ricerca, che era net.sock.peer.port.

Per cercare le sezioni in una traccia, nella barra degli strumenti del riquadro Dettagli traccia: inserisci il termine di ricerca nel campo Trova in Trace, quindi premi Invio.

Dopodiché, Trace cerca i campi selezionati di ogni intervallo nella della traccia visualizzata. Si verifica una corrispondenza quando un campo cercato contiene il termine di ricerca, ignorando maiuscole e minuscole. La ricerca viene eseguita nei seguenti campi:

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

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

Ad esempio, se inserisci il termine get, viene generato un intervallo con un attributo la cui è /http/method con valore GET evidenziato. Inoltre, gli intervalli con nomi come CurrencyService/GetSupportedCurrencies sono evidenziati.

Non puoi effettuare ricerche utilizzando un'espressione regolare né cercare nei log, eventi o metadati.

Visualizza dettagli intervallo

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

Se selezioni la barra della latenza per la prima riga della tabella, la riga con il nome ID traccia, la tabella contiene due schede: Riepilogo e Log. Il riepilogo elenca le 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 nella traccia.

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

Per trovare le etichette associate a un intervallo, visualizza la scheda Attributi. Per informazioni sulle etichette, consulta Etichette di traccia. Il seguente screenshot 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 dell'etichetta contiene g.co.
Per visualizzare informazioni su voci di log ed eventi correlati, se presenti: visualizzare la scheda Log e eventi. Per informazioni sulle annotazioni degli eventi, consulta Annotazione degli intervalli di tracce. Il seguente screenshot illustra questa scheda:

Quando sono disponibili i dati del log, per vedere i dettagli di una voce di log, fai clic su Mostra altro:
Per trovare informazioni sul numero di analisi dello stack disponibili, informazioni dettagliate su una traccia dello stack acquisita, utilizza la funzionalità Analisi dello stack .
Per trovare informazioni generali sull'intervallo e una tabella di link ad altri puoi visualizzare la sezione Metadati e Link. Queste informazioni includono seguenti:
- ID intervallo
  
  L'ID intervallo è un numero intero a 64 bit diverso da 0. Per maggiori dettagli, vedi TraceSpan.
- ID intervallo padre
- ID progetto
- Ora di inizio e ora di fine
- Tabella che elenca i link ad altri intervalli
  
  Ogni riga della tabella denominata Link elenca un collegamento tra l'intervallo corrente e un altro intervallo. Il campo Attributi elenca le coppie chiave-valore per l'intervallo collegato. Il campo Trace rimanda alla traccia del file collegato a uno span. Se questo campo contiene Traccia corrente, il valore collegato a un intervallo è nella stessa traccia dell'intervallo attuale. Altrimenti, il campo contiene un ID traccia. Per informazioni sui link, vedi Pagina di riferimento dell'API Links.
Il seguente screenshot illustra questa scheda: