Correlare le voci di log

Questo documento descrive come raggruppare e visualizzare le voci di log in un formato "padre-figlio" utilizzando Esplora log. In genere, quando scrivi voci di log in Cloud Logging, ogni voce di log viene visualizzata separatamente e senza correlazione. Tuttavia, puoi raggruppare o correlare le voci di log utilizzando il campo trace nell'oggettoLogEntry.

Quando metti in correlazione le voci di log, puoi visualizzare una voce di log principale con più voci di log secondarie in Esplora log.

Configurare le voci di log correlate

Per configurare le voci di log correlate, puoi compilare manualmente il campo trace oppure puoi instrumentare l'applicazione per inviare trace a Cloud Trace utilizzando le librerie client di Google. Le seguenti configurazioni acquisiscono automaticamente i dati di tracciamento:

  • Ambiente standard di App Engine

  • Cloud Run Functions e Cloud Run

Per informazioni sull'instrumentazione dell'applicazione per raccogliere i dati di traccia, consulta Panoramica dell'instrumentazione per Cloud Trace.

Affinché Esplora log possa correlare una raccolta di voci di log, queste devono soddisfare i seguenti requisiti:

  • Il campo trace nell'oggetto LogEntry è 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 della traccia.

  • I campi trace nelle voci di log sono gli stessi.

  • Ogni voce di log appartiene a un log univoco. ovvero il valore dei campi logName deve essere diverso.

Visualizzare le voci di log correlate in Esplora log

Per visualizzare le voci di log secondarie correlate a una voce di log principale che stai visualizzando in Esplora log, espandi la voce di log.

Ad esempio, per visualizzare la voce di log delle richieste di App Engine e le voci di log dell'applicazione, procedi nel seguente modo:

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

    Vai a Esplora log

    Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Logging.

  2. Nel menu a discesa Risorsa, seleziona GAE Application.

  3. Nel menu a discesa Nome log, seleziona request_log.

  4. Nel riquadro Risultati delle query, per espandere una voce di log, fai clic su Espandi.

    Le voci di log dell'applicazione correlate alla voce di log della richiesta sono nidificate nella voce di log della richiesta:

    Le voci di log dell'applicazione sono nidificate nella voce di log delle richieste.

    Nello screenshot precedente, la voce di log padre ha 10 voci di log figlio. Puoi espandere queste voci di log secondarie per visualizzarne i dettagli.

Cerca voci di log correlate

La ricerca correlata ti consente di cercare sia le voci di log principali sia quelle secondarie con una query. Il risultato della ricerca è un elenco di voci di log principali che corrispondono alla query nelle voci di log principali o secondarie. Ad esempio, per cercare la stringa "app log message" nelle voci di log secondarie e principali, procedi nel seguente modo:

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

    Vai a Esplora log

    Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Logging.

  2. Inserisci "app log message" nel campo di ricerca e fai clic su Esegui query. Le voci di log secondarie contenenti "app log message" sono elencate nel riquadro Risultati delle query.

  3. Nel riquadro Risultati query, fai clic su Correlate by (Correlate per) e seleziona un log principale. Per visualizzare i log delle richieste di App Engine, seleziona request_log e fai clic su Applica.

  4. Nel riquadro Risultati delle query, vengono elencate tutte le voci di log principali che contengono la stringa "app log message" o che hanno una voce secondaria che contiene la stringa.

    Per visualizzare le voci di log secondarie nidificate, espandi la voce di log principale facendo clic su Espandi.

    Le voci di log dell'applicazione sono nidificate nella voce di log delle richieste.

    Nello screenshot precedente, la voce di log genitore contiene 10 voci di log secondarie che contengono la stringa "app log message". Puoi espandere queste voci del log figlio per visualizzarne i dettagli.

    Se hai selezionato un log principale e non vedi voci di log nel riquadro Risultati delle query, non esistono voci principali e secondarie correlate che corrispondono alla tua query.

Passaggi successivi