Correlare le voci di log

In Esplora log, puoi correlare le voci di log associate alla stessa traccia per raggrupparle e visualizzarle insieme, il che semplifica le operazioni di risoluzione dei problemi in una richiesta. Quando correli le voci di log impostando il campo trace nell'oggetto LogEntry, Esplora log visualizza le voci di log figlio nidificate sotto la voce di log della richiesta principale.

Quando le voci di log possono essere correlate

Affinché le voci di log siano correlate, ogni voce deve includere il campo trace. Quando strumenti un'applicazione con OpenTelemetry, gli ID traccia e span vengono estratti dal contesto della traccia e inclusi nei dati di log OTLP inviati al tuo progetto. Se utilizzi Google Cloud esportatori, questi estraggono anche questi campi. In alternativa, puoi impostare manualmente il campo trace.

I seguenti Google Cloud servizi acquisiscono i dati di traccia e scrivono voci di log che includono informazioni sulla traccia:

  • Ambiente standard di App Engine
  • Cloud Run Functions
  • Cloud Run

Inoltre, gli ambienti Compute Engine e Google Kubernetes Engine acquisiscono e includono i dati di traccia quando utilizzano l'Ops Agent o il collettore OpenTelemetry.

Per informazioni sulla strumentazione dell'applicazione per raccogliere i dati di traccia, consulta Strumentazione per Cloud Trace.

Requisiti di correlazione

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 uno dei seguenti formati:

    TRACE_ID

    o

    projects/PROJECT_ID/traces/TRACE_ID

    Nelle espressioni precedenti, PROJECT_ID è l'ID del tuo progetto e TRACE_ID è l'ID della traccia.

  • Il valore del campo trace è lo stesso in tutte le voci di log.

  • Ogni voce di log ha un valore logName diverso.

  • Il timestamp della voce di log principale non è successivo al timestamp di nessuna voce di log figlio.

Prima di iniziare

Per ottenere le autorizzazioni necessarie per utilizzare Esplora log per visualizzare le voci di log, chiedi all'amministratore di concederti i seguenti ruoli IAM:

  • Per visualizzare le voci di log nel bucket _Required e quelle nella visualizzazione _Default nel bucket _Default o per selezionare un ambito di log: Visualizzatore log (roles/logging.viewer) sul tuo progetto, sulla tua cartella o sulla tua organizzazione.
  • Per visualizzare tutte le voci di log nei bucket _Required e _Default: Visualizzatore log privati (roles/logging.privateLogViewer) sul tuo progetto, sulla tua cartella o sulla tua organizzazione.

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Visualizzare e cercare le voci di log correlate in Esplora log

Per visualizzare e cercare le voci di log utilizzando una struttura padre-figlio:

  1. Nella Google Cloud console, vai alla pagina segmento 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 Correlare per, seleziona il nome del log principale. Ad esempio, seleziona request_log per le applicazioni App Engine.

    Il riquadro Risultati delle query mostra una riga per ogni voce di log che corrisponde al nome del log principale.

    Per visualizzare le voci di log correlate, fai clic su Espandi questa voce di log:

    Visualizzazione delle voci di log correlate.

    Lo screenshot precedente mostra una voce di log principale con due voci di log figlio.

    Se espandi una voce di log principale e non vengono visualizzate voci di log figlio, significa che nessun'altra voce di log nell'intervallo di tempo della query condivide l'ID traccia.

  3. (Facoltativo) Inserisci un termine di ricerca o aggiorna l'espressione della query per filtrare o cercare le voci di log correlate.

    Ad esempio, se inserisci "app log message" nella barra di ricerca e fai clic su Esegui query, il riquadro Risultati delle query mostra solo le voci di log che contengono il testo "app log message".

Passaggi successivi