Questo documento descrive come associare una traccia a un LogEntry di Cloud Logging.
Associa una voce di log a una traccia o a un intervallo
Se utilizzi l'API Cloud Logging per scrivere dati di log o dati di log strutturati, puoi associare una voce di log a una traccia o a un intervallo. 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, consulta Campi speciali nei payload strutturati.
Per associare una voce di log a una traccia, imposta il campo trace nell'oggetto LogEntry.
Il campo trace deve essere impostato su una stringa con il seguente formato:
projects/PROJECT_ID/traces/TRACE_ID
dove PROJECT_ID è l'ID progetto Google Cloud e
TRACE_ID è l'identificatore traccia
Per associare una voce di log a un intervallo quando utilizzi l'API Cloud Logging, imposta il campo spanId nell'oggetto LogEntry sulla codifica esadecimale di 16 caratteri dell'ID dell'intervallo.
Ad esempio, per associare una voce di log a un intervallo che ha un 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 non viene acquisita.
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, questo è automaticamente limitato all'intervallo di timestamp della traccia. Se non ci sono voci di log da visualizzare, Esplora log visualizza il messaggio No entries found matching current filter.
Dal riquadro Dettagli traccia, per visualizzare la voce di log relativa alla 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 non è visualizzato Mostra log, 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 ulteriori informazioni 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 progetto. Questa autorizzazione è fornita dai ruoli Visualizzatore log e Visualizzatore progetto Identity and Access Management (IAM).
Per visualizzare i log delle istanze VM, devi disporre dell'autorizzazione compute.instances.get nel progetto. Questa autorizzazione è fornita dai ruoli IAM Visualizzatore rete Compute Engine e Visualizzatore progetto.