Questo documento descrive come collegare una voce di log a una traccia. Esegui
il collegamento impostando un campo nella voce di log.
Utilizzando i campi di traccia nella struttura LogEntry, ovvero spanId, trace e traceSampled, puoi correlare log e tracce per una migliore risoluzione dei problemi distribuiti.
Associare manualmente una voce di log a una traccia o a uno span
Se utilizzi l'API Cloud Logging per scrivere dati di log o se scrivi
dati di log strutturati,
puoi associare una voce di log a una traccia o a uno span. La voce di log
può anche registrare se la traccia è stata campionata. Per informazioni su come
l'Ops Agents converte i dati di log strutturati in
campi in un LogEntry, vedi Campi speciali nei payload strutturati.
Per associare una voce di log a una traccia, imposta il campo trace
nell'oggetto LogEntry:
- Formato preferito:
TRACE_ID - Formato legacy:
projects/PROJECT_ID/traces/TRACE_ID
Nelle espressioni precedenti, PROJECT_ID è l'ID progetto Google Cloud e
TRACE_ID è l'identificatore della traccia.
Per associare una voce di log a uno span quando utilizzi l'API Cloud Logging,
imposta il campo spanId nell'oggetto LogEntry
sull'encoding esadecimale a 16 caratteri dell'ID dello span.
Ad esempio, per associare una voce di log a un intervallo con ID 74,
imposta l'ID intervallo su 000000000000004a.
Per indicare che stai utilizzando il campionamento delle tracce e che la traccia è stata campionata
per l'archiviazione al momento della scrittura della voce di log, imposta il campo traceSampled nell'oggetto
LogEntry. Quando utilizzi il campionamento delle tracce,
è possibile che venga creata una voce di log quando la traccia stessa non viene acquisita.
Associare automaticamente una voce di log a una traccia o a uno span
Quando utilizzi le librerie client di Cloud Logging, in alcuni casi i campi di traccia in una voce di log possono essere impostati automaticamente. I valori impostati manualmente hanno la precedenza sui valori impostati automaticamente.
Ad esempio, se utilizzi OpenTelemetry e stai registrando da uno span OpenTelemetry attivo, i campi di traccia nella voce di log vengono compilati dal contesto OpenTelemetry.
In alternativa, in alcuni casi, quando è presente una richiesta HTTP, i campi di traccia possono essere impostati dal campo W3C traceparent o dal valore X-Cloud-Trace-Context nella richiesta HTTP.
Per ulteriori informazioni sulla compilazione automatica dei campi di traccia nelle voci di log, consulta la seguente documentazione delle librerie client specifiche per lingua:
Visualizzazione dei log
Puoi visualizzare la voce di log per una traccia insieme al grafico a cascata o
in Esplora log. Quando utilizzi Esplora log, l'intervallo di timestamp viene limitato automaticamente
all'intervallo di timestamp della traccia. Se non ci sono voci di log da visualizzare,
Esplora log mostra il messaggio
No entries found matching current filter.
Nel riquadro Dettagli traccia, per visualizzare la voce di log della traccia, esegui una delle seguenti operazioni:
Per visualizzare le voci del log di traccia insieme al grafico a cascata, vai al grafico a cascata e fai clic su Mostra log. Quando l'opzione Mostra log non viene visualizzata, non sono disponibili voci di log.
Per visualizzare la voce di log in Esplora log, fai clic su Visualizza accanto all'etichetta Log nella sezione Dettagli. Tieni presente che quando hai una traccia di Cloud Load Balancing, fai clic su Visualizza accanto all'etichetta Log VM.
Per saperne di più sulla visualizzazione delle voci di log in Cloud Logging, consulta Utilizzo di Esplora log.
Autorizzazioni di visualizzazione dei log
Per visualizzare le voci di log, devi disporre dell'autorizzazione logging.logEntries.list
nel tuo progetto. Questa autorizzazione viene fornita dai ruoli IAM (Identity and Access Management) Visualizzatore log e Visualizzatore progetto.
Per visualizzare i log dell'istanza VM, devi disporre dell'autorizzazione compute.instances.get
nel tuo progetto. Questa autorizzazione viene fornita dai ruoli IAM Visualizzatore rete Compute Engine e Visualizzatore progetto.