Trovare ed esplorare le tracce

Per visualizzare una rappresentazione aggregata dei dati di traccia o per trovare ed esplorare singole tracce o tracce che contengono etichette specifiche, utilizza la pagina Esplora tracce.

Lo screenshot seguente mostra come vengono visualizzati i dati di traccia:

Esempio di visualizzazione dei dati di traccia.

Per eseguire query che eseguono un'analisi aggregata degli intervalli, utilizza la pagina Observability Analytics o BigQuery. Entrambe le interfacce supportano l'esecuzione di query sui dati di intervallo utilizzando SQL. Quando utilizzi la pagina Observability Analytics, puoi visualizzare i risultati della query come tabella o come grafico. Per scoprire di più sull'utilizzo di SQL per eseguire query sui dati di traccia, consulta Eseguire query e analizzare le tracce.

Questa funzionalità è supportata solo per i progetti Google Cloud . Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione.

Informazioni sulla pagina Esplora tracce

Per aiutarti a identificare tendenze e pattern nei dati di traccia, i dati di latenza vengono aggregati e visualizzati nei grafici. La mappa termica utilizza il colore per rappresentare il numero di intervalli in una cella. Una cella con molti intervalli ha un colore più scuro rispetto a una con pochi intervalli. La descrizione comando di ogni cella mostra la latenza e altre informazioni. Puoi anche visualizzare i percentili di latenza e le informazioni sulla velocità di intervallo.

Quando esamini un problema, potresti voler visualizzare una traccia specifica o solo gli intervalli con determinate proprietà:

  • Per limitare gli intervalli visualizzati, applica filtri. Ad esempio, puoi filtrare in base a servizio, applicazione, stato di errore e altre proprietà.

  • Per visualizzare una traccia specifica, utilizza l'opzione Cerca traccia della barra degli strumenti.

Per identificare i valori anomali e visualizzare i dettagli dei singoli intervalli, utilizza la sezione tabellare:

  • Puoi ordinare le righe delle schede Intervalli e Raggruppati in base all'intestazione Durata.

  • Per capire quanti intervalli generano i diversi servizi, utilizza la scheda Raggruppato. Ogni riga corrisponde a un servizio e a un nome dell'intervallo e per ogni voce vengono visualizzate le statistiche di latenza.

Per esplorare i dettagli di un intervallo o di un raggruppamento, seleziona la voce da una riga nella sezione tabellare. Si apre un riquadro che mostra lo span nel contesto della relativa traccia. Da questa visualizzazione puoi esplorare lo span, i relativi attributi e visualizzare gli eventi e i dati di log. Puoi anche cercare intervalli e attributi nella traccia per parole chiave.

I dati di traccia visualizzati nella pagina Esplora tracce dipendono da quanto segue:

  • L'impostazione Ambito, che determina in quali viste il sistema cerca i dati di traccia. Quando si apre la pagina, l'elemento Ambito è impostato sull'ambito della traccia predefinito e il sistema esegue query sulle viste elencate in questo ambito per i dati di traccia.

    In un nuovo progetto, l'ambito di traccia predefinito elenca la visualizzazione _AllSpans per il progetto. Questa visualizzazione fornisce l'accesso in lettura a tutti i dati di traccia archiviati dal progetto.

  • Le tue autorizzazioni Identity and Access Management (IAM) nella visualizzazione cercata. Se non disponi dell'autorizzazione per visualizzare i dati di traccia per un progetto, la console Google Cloud mostra un messaggio di avviso e i dati del progetto non vengono visualizzati.

  • L'impostazione dell'intervallo di tempo.

  • I filtri che applichi.

Puoi salvare i dati di traccia in una dashboard personalizzata. Per saperne di più, consulta Visualizzare i dati di traccia in una dashboard personalizzata.

Il resto della pagina fornisce ulteriori informazioni su come trovare ed esplorare i dati di traccia.

Prima di iniziare

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

Questo ruolo predefinito contiene le autorizzazioni necessarie per visualizzare i dati di traccia utilizzando la console Google Cloud e per selezionare un ambito di traccia. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per visualizzare i dati di traccia utilizzando la console Google Cloud e per selezionare un ambito di traccia sono necessarie le seguenti autorizzazioni:

  • Per selezionare un ambito di traccia: cloudtrace.traceScopes.[get, list]
  • Per leggere l'ambito della traccia predefinito: observability.scopes.get

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Per saperne di più sui ruoli, consulta Controllare l'accesso con Identity and Access Management.

Visualizzare i dati di traccia aggregati

Per visualizzare le informazioni aggregate sui dati di traccia:

  1. Nella console Google Cloud , vai alla pagina Esplora tracce:

    Vai a Esplora tracce

    Puoi trovare questa pagina anche utilizzando la barra di ricerca.

    Potrebbero essere necessari diversi minuti dopo la scrittura dei primi dati di traccia in un progetto Google Cloud prima che questi dati siano disponibili per la visualizzazione. Se dopo aver atteso qualche minuto non visualizzi dati di traccia, è possibile che il progetto non abbia dati da visualizzare o che si sia verificato un problema di configurazione. Per informazioni su come risolvere questi problemi, vedi Risoluzione dei problemi: nessun dato nellTrace#39;interfaccia di traccia.