Correla voci di log

Questo documento descrive come raggruppare e visualizzare le voci di log in un formato "principale-secondario" utilizzando Esplora log. In genere, quando scrivi voci di log in Cloud Logging, ogni voce viene visualizzata separatamente e non è correlata. Tuttavia, puoi raggruppare o correlare le voci di log utilizzando il campo trace nell'oggetto LogEntry.

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

Configura voci di log correlate

Per configurare voci di log correlate, puoi completare manualmente il campo trace, Oppure puoi instrumentare la tua richiesta per inviare tracce a Cloud Trace utilizzando le librerie client di Google. Le seguenti configurazioni vengono acquisire i dati di traccia:

  • Ambiente standard di App Engine

  • Funzioni di Cloud Run e Cloud Run

Per informazioni sull'instrumentazione dell'applicazione per raccogliere i dati delle tracce, consulta la Panoramica dell'instrumentazione per Cloud Trace.

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

  • Il campo trace nell'oggetto LogEntry sia 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 del log appartiene a un log univoco. In altre parole, il valore dell'attributo logName devono essere diversi.

Visualizza 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 del log delle richieste di App Engine e il 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 Applicazione GAE.

  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 delle richieste sono nidificate nella voce di log delle richieste:

    Le voci del log delle applicazioni sono nidificate nella voce del log delle richieste.

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

Cercare le voci di log correlate

La ricerca correlata ti consente di cercare le voci di log principali e secondarie con una query. Il risultato della ricerca è un elenco di voci di log padre che corrispondono alla query in le voci di log padre o figlio. Ad esempio, per cercare la stringa "messaggio di log dell'app" sia nelle voci di log secondarie che in quelle 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 "messaggio di log dell'app" sono elencate nel riquadro Risultati della query.

  3. Nel riquadro Risultati della query, fai clic su Correla 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, tutte le voci di log principali contenenti la stringa "app log message" o che hanno un elemento secondario che contiene la stringa sono in elenco.

    Per visualizzare le voci di log figlio nidificate, tp espandi la voce di log padre, fai clic su Espandi.

    Le voci del log delle applicazioni sono nidificate nella voce del log delle richieste.

    Nello screenshot precedente, la voce di log padre ha 10 voci di log figlio che contengono la stringa "messaggio di log dell'app". Puoi espandere questo log figlio voci per visualizzarne i dettagli.

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

Passaggi successivi