La correlazione delle voci di log di Cloud Logging con le tracce e gli intervalli di Cloud Trace
consente di visualizzare i log insieme ai grafici a cascata delle tracce o in
Esplora log durante la risoluzione dei problemi relativi alle richieste distribuite. Per collegare i log alle tracce, puoi impostare manualmente i campi trace, spanId e traceSampled in un oggetto LogEntry oppure utilizzare le librerie client Logging per compilare automaticamente questi campi dal contesto OpenTelemetry o dalle intestazioni delle richieste HTTP.
Associare manualmente una voce di log a una traccia o 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 Agent 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 precedente:
projects/PROJECT_ID/traces/TRACE_ID
Nelle espressioni precedenti, PROJECT_ID è l'ID progetto Google Cloud e TRACE_ID è l'identificatore di traccia.
Per associare una voce di log a uno span quando utilizzi l'API Logging,
imposta il campo spanId nell'oggetto LogEntry
sulla codifica esadecimale a 16 caratteri dell'ID dello span.
Ad esempio, per associare una voce di log a uno span con ID 74,
imposta l'ID span su 000000000000004a.
Per indicare che stai utilizzando il campionamento delle tracce e che la traccia è stata campionata
per l'archiviazione quando è stata scritta la 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
Le librerie client di Logging possono impostare automaticamente i campi di traccia in alcuni casi. I valori impostati manualmente hanno la precedenza su quelli impostati automaticamente.
Ad esempio, se utilizzi OpenTelemetry e stai registrando i log 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:
Visualizza i 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 tempo 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.
Per visualizzare la voce di log per la traccia dal riquadro Dettagli 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. 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 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 è fornita dai ruoli IAM (Identity and Access Management) Visualizzatore log e Visualizzatore progetto.
Per visualizzare i log delle istanze VM, devi disporre dell'autorizzazione compute.instances.get
nel tuo progetto. Questa autorizzazione viene fornita dai ruoli IAM Visualizzatore di rete Compute Engine e Visualizzatore progetto.