Risoluzione dei problemi

Questa pagina contiene informazioni per la risoluzione dei problemi relativi a Trace.

Problemi noti

In questa sezione sono elencati i problemi noti:

  • Gli span scritti nel tuo progetto Google Cloud utilizzando l'API Telemetry non sono accessibili all'Cloud Trace API. Ad esempio, se provi a elencare queste tracce, il comando non riesce e viene visualizzato l'errore 404 Not Found.

Risolvere i problemi relativi alla pagina Esplora tracce

Questa sezione descrive come risolvere i problemi quando utilizzi la pagina Esplora tracce.

Nessun dato nella pagina Esplora tracce

Stai utilizzando la pagina Esplora tracce e non riesci a visualizzare alcuna traccia nel tuo progetto Google Cloud quando prevedi che siano presenti dati di traccia.

Prova a seguire questi passaggi:

  1. Verifica che l'API Cloud Trace sia abilitata e che i dati vengano scritti nel tuo progetto:

    1. Nella console Google Cloud , vai alla pagina API e servizi abilitati:

      Vai a API e servizi abilitati

    2. Se l'Cloud Trace API è elencata, vai al passaggio successivo. In caso contrario, abilita l'API.

      Per abilitare l'API, fai clic su Abilita API e servizi, cerca &quotCloud Trace APIe", seleziona l'opzione e poi fai clic su Abilita.

  2. Nella pagina API e servizi abilitati, individua la riga con l'etichetta API Cloud Trace.

  3. Se la colonna etichettata Errore elenca un valore diverso da zero, si sono verificati errori di lettura o scrittura dei dati di traccia tramite l'Cloud Trace API. Per saperne di più sull'origine degli errori, seleziona API Cloud Trace, seleziona la scheda Metriche e poi trova il grafico intitolato Errori per metodo API:

    • Se le scritture non vanno a buon fine, concedi all'account di servizio che fornisce le credenziali di autenticazione il ruolo Agente Cloud Trace (roles/cloudtrace.agent). Questo ruolo include l'autorizzazione cloudtrace.traces.patch, che consente alle applicazioni di scrivere dati di intervallo in un progetto Google Cloud .

      Per saperne di più, consulta Ruoli IAM di Cloud Trace.

    • Se le letture non vanno a buon fine, assicurati che il tuo ruolo IAM nel progetto Google Cloud includa le autorizzazioni del ruolo Utente Cloud Trace (roles/cloutrace.user). Per un elenco delle autorizzazioni per questo ruolo, consulta Ruoli IAM di Cloud Trace.

  4. La colonna Richieste elenca il numero di richieste inviate all'Cloud Trace API. Quando questa colonna è zero, non vengono inviati dati di traccia tramite l'API.

    App Engine, Cloud Run e Cloud Run Functions inviano dati di traccia senza utilizzare l'Cloud Trace API. Se utilizzi solo questi servizi, vai al passaggio successivo.

    Se hai un'applicazione che invia dati di traccia tramite l'Cloud Trace API e la colonna delle richieste è zero, controlla le tue applicazioni e i tuoi proxy per verificare che siano configurati per inviare le tracce al progetto corretto.

  5. Nella pagina Esplora tracce, verifica che l'archiviazione Tracee sia inizializzata:

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

      Vai a Trace Explorer

      Puoi trovare questa pagina anche utilizzando la barra di ricerca.

    2. Se l'archiviazione delle tracce non è inizializzata, la pagina Explorer tracce mostra un banner contenente il seguente testo:

      Trace storage is not initialized in this project. Enable trace storage to begin collecting trace data.

      Per inizializzare l'archiviazione Trace, fai clic su Abilita nel banner. L'inizializzazione viene completata in genere entro pochi minuti.

      Quando l'inizializzazione va a buon fine, viene visualizzato un banner di notifica. Trace inserisce i dati di traccia inviati nell'ultima ora, che in precedenza erano archiviati in un buffer. Puoi aggiornare la pagina tra qualche minuto, quando i dati inizieranno a essere visualizzati nell'Esplora tracce.

      Se visualizzi un messaggio di errore che indica che l'inizializzazione non è riuscita, un Google Cloud membro del team di assistenza deve risolvere manualmente il problema. Fai clic su Apri un ticket per avviare la procedura.

  6. Verifica che la pagina Esplora tracce stia cercando i dati di traccia nel tuo progetto attuale. Nella barra degli strumenti, vai all'elemento Ambito, espandi il menu Perfeziona ambito, seleziona Progetto corrente e poi seleziona Applica.

La ricerca di una traccia specifica non va a buon fine

Inserisci un ID traccia nella pagina Esplora tracce. La traccia non viene trovata e viene visualizzato un messaggio simile al seguente:

The select trace with ID abcde does not exist or is older than 30 days and has been deleted per our retention policy.

Per risolvere questo errore, prova quanto segue:

  1. Verifica che il timestamp associato all'ID traccia rientri nel periodo di conservazione.

  2. Identifica il progetto Google Cloud che archivia la traccia e assicurati che il selettore di risorse nella console Google Cloud selezioni questo progetto. Per impostazione predefinita, la pagina Esplora tracce ha accesso solo ai dati di traccia archiviati nel progetto selezionato.

Dati meno recenti mancanti nella pagina Esplora tracce

Stai utilizzando la pagina Esplora tracce e puoi visualizzare i dati recenti, ma quando imposti il selettore dell'intervallo di tempo su 30 giorni o su un valore più grande, i dati meno recenti non vengono visualizzati.

La pagina Esplora tracce non mostra i dati per periodi di tempo superiori al periodo di conservazione dei dati di Cloud Trace, ovvero 30 giorni.

Se il selettore dell'intervallo di tempo è di 30 giorni o meno, i dati mancanti indicano che il database interrogato dalle query della pagina Trace Explorer è stato creato più di recente rispetto all'impostazione dell'intervallo di tempo. Ad esempio, se imposti questo valore su 20 giorni e puoi visualizzare solo i dati degli ultimi 10 giorni, il database è stato creato 10 giorni prima. Inoltre, questo database contiene solo tracce inviate al tuo progetto Google Cloud dopo la creazione del database.

Intervalli mancanti in una traccia

Apri la pagina Esplora tracce e seleziona un intervallo da visualizzare. Il riquadro Dettagli mostra la traccia, ma mancano alcuni intervalli.

I periodi potrebbero mancare per i seguenti motivi:

  • La pagina Esplora tracce non esegue la ricerca in tutti i progetti Google Cloud che archiviano i dati di intervallo per la traccia.

  • Il tuo ruolo IAM in un progetto che archivia i dati degli span per la traccia non contiene le autorizzazioni necessarie per visualizzare i dati di traccia. Google Cloud

  • Si è verificato un problema con la strumentazione. Ad esempio, solo alcuni intervalli in una traccia sono stati inviati al tuo progetto Google Cloud .

Per risolvere questi problemi, procedi nel seguente modo:

  1. Nella pagina Esplora tracce, assicurati di impostare l'elemento Ambito su un ambito della traccia che elenca i progetti che archiviano gli span per la traccia selezionata.

    Se non esiste un ambito della traccia che includa i progetti che hai identificato nel passaggio precedente, crea o modifica un ambito della traccia esistente. Per saperne di più, consulta la pagina Creare e gestire gli ambiti di traccia.

  2. Verifica di disporre del ruolo Utente Cloud Trace (roles/cloudtrace.user) nei progetti che archiviano i dati degli intervalli.

Non disponi delle autorizzazioni necessarie per visualizzare i dati di traccia

Stai visualizzando la pagina Esplora tracce e vedi la seguente notifica:

You don't have the required permissions to view trace data for one or more projects listed in the trace scope.

Per risolvere il problema, nella barra degli strumenti:

  1. Espandi l'elemento Ambito e identifica l'ambito della traccia selezionato.
  2. Nel riquadro a comparsa Perfeziona ambito, seleziona Gestisci ambiti.
  3. Individua l'ambito della traccia che hai identificato nel primo passaggio, quindi espandi i dettagli per visualizzare l'elenco dei Google Cloud progetti.
  4. Per ogni progetto Google Cloud nell'ambito della traccia, verifica di disporre del ruolo Utente Cloud Trace (roles/cloudtrace.user). Se non disponi di questo ruolo in un progetto, chiedi a un amministratore o al proprietario del progetto di concedertelo.

L'inizializzazione dell'archiviazione delle tracce non riesce

Tenti di inizializzare l'archiviazione delle tracce facendo clic su Attiva nel banner mostrato in Esplora tracce e visualizzi il seguente errore:

Initializing trace storage has failed for an unexpected reason. Please file a support ticket for assistance.

Se l'inizializzazione dell'archivio non va a buon fine, un Google Cloud membro del team di assistenza deve risolvere manualmente il problema. Per contattare l'assistenza, fai clic su Invia un ticket.

Messaggio con ID intervallo mancante nella traccia

La traccia contiene il messaggio "ID span mancante".

Nei sistemi di tracciamento distribuito, sono previste tracce incomplete. Una traccia è incompleta quando uno span campionato contiene un riferimento a un altro span che non è stato ricevuto. Il riferimento non risolto può verificarsi per i seguenti motivi:

  • L'intervallo a cui viene fatto riferimento non è stato campionato.
  • L'intervallo a cui viene fatto riferimento è stato campionato, ma non è ancora stato ricevuto da Cloud Trace oppure è stato ricevuto, ma non archiviato.

Quando visualizzi una traccia incompleta, Cloud Trace mostra il messaggio "ID intervallo mancante" nel riquadro dei dettagli della traccia.

Se visualizzi costantemente il messaggio "ID span mancante", prova a procedere nel seguente modo:

  • Per i componenti che gestisci, assicurati che rispettino e propaghino il flag sampled dell'intestazione, quando questo campo è presente. Questa impostazione è un suggerimento per i componenti secondari per campionare la richiesta. Per saperne di più sulle intestazioni di traccia, consulta Protocolli per la propagazione del contesto.

    I serviziGoogle Cloud in genere rispettano questo suggerimento. Tuttavia, limitano anche la velocità con cui scrivono i dati di traccia.

  • Se utilizzi Cloud Service Mesh, assicurati di seguire le indicazioni per propagare il contesto di traccia per queste configurazioni. Per indicazioni su Cloud Service Mesh, consulta Propagazione del contesto di traccia.

Impossibile correlare i dati di log e traccia

Stai eseguendo una delle seguenti operazioni:

  • Stai visualizzando un intervallo di traccia e vuoi visualizzare le voci di log associate. Tuttavia, non sono elencati dati di log oppure, quando apri la pagina Esplora log, non vengono visualizzate voci di log.

  • Stai visualizzando una voce di log e vuoi visualizzare gli intervalli di traccia associati. Tuttavia, quando utilizzi le opzioni della voce di log per aprire la pagina Esplora tracce, non vengono visualizzati dati di traccia.

Per risolvere questi errori, configura l'ambito di osservabilità. Questo ambito specifica quali ambiti di traccia e di log utilizzare quando vengono aperte le pagine di esplorazione corrispondenti. Per saperne di più, consulta Configurare gli ambiti di osservabilità per le query multiprogetto.

Nessun dato di traccia dopo l'aggiornamento dell'app Go per utilizzare OpenTelemetry

La tua applicazione si basa sulla libreria client per acquisire le tracce e, dopo l'aggiornamento dell'applicazione per utilizzare OpenTelemetry, non visualizzi più i dati di Cloud Trace.

Poiché alcune librerie client Cloud per Go sono integrate con OpenCensus, devi utilizzare un bridge OpenCensus. Per saperne di più sul problema risolto dal bridge, consulta OpenCensus Bridge.

Per informazioni sull'aggiornamento delle librerie client di Google Cloud per Go, consulta Issue #4237.