Revisione dei log con Esplora log di Cloud Logging

Questo documento fornisce informazioni su come utilizzare il visualizzatore log di Cloud Logging per esaminare i log.

Prima di iniziare

Configura la tua applicazione per utilizzare l'API Cloud Logging.
Accedi al tuo account per accedere alle risorse Google Cloud.
- Seleziona Strumenti -> Google Cloud Tools -> Gestisci account... per selezionare il tuo account.

Accesso a Esplora log

Per accedere a Esplora log di Cloud Logging, seleziona Strumenti -> Google Cloud Tools -> Mostra Esplora log di Stackdriver.

Viene visualizzata la scheda Google Stackdriver Logging.

In alternativa, puoi aprire Esplora log per un progetto specifico da Google Cloud Explorer selezionando Strumenti -> Google Cloud Tools -> Google Cloud Explorer. Fai clic con il pulsante destro del mouse sul progetto e seleziona Sfoglia log Stackdriver.

Immagine che mostra la panoramica della scheda Esplora log

Esplorare l'interfaccia

L'interfaccia di Esplora log include i seguenti componenti principali:

Una barra di ricerca per filtrare le voci di log per etichetta o ricerca testuale.
Menu a discesa per filtrare l'elenco per risorse, log e livelli di gravità.
Menu a discesa Vai a data/ora per visualizzare una data e un'ora specifiche nei log.
Un pulsante Aggiorna per recuperare i log più recenti in ordine decrescente.
Il flusso di log di caricamento automatico consente di stabilire se visualizzare o meno le nuove voci di log all'arrivo.
- Se fai clic su Riproduci, viene avviato lo stream dei log più recenti. Se scorri la visualizzazione dei log, il flusso verrà interrotto.
- Fai clic su Metti in pausa per interrompere il flusso di log.
La tabella dei riepiloghi dei log su cui puoi fare clic per visualizzare i dettagli completi delle singole voci di log.
Una Freccia giù Espandi tutto nell'angolo in alto a destra del riquadro delle voci di log mostra i dettagli di tutte le voci di log. Questa azione può richiedere del tempo se il riquadro ha molte voci di log.
Se disponibile, un link all'origine per individuare il codice sorgente che genera la voce di log.

Accesso al codice sorgente in corso...

Esplora log consente di accedere al codice sorgente che genera una voce di log. Per abilitare questa funzionalità, devi creare il progetto da un repository Git locale e aggiungere informazioni sulla posizione di origine alle voci di log.

Aggiunta della posizione di origine al log in corso...

Configura la tua applicazione per fornire informazioni sulla posizione del codice sorgente nei log:

Scrivi le informazioni sulla posizione per le voci di log utilizzando il seguente esempio di GitHub.
Esegui il deployment di un file source_context.json nella directory principale dell'applicazione.

Se pubblichi la soluzione tramite Cloud Tools for Visual Studio, l'estensione genera ed esegue il deployment del file automaticamente.

Dopo aver completato questi passaggi, le voci di log contengono un campo sourceLocation con informazioni File e Line. La riga facoltativa Function può contenere il nome dell'assemblaggio, la versione o il nome della funzione.

Immagine che mostra una voce di log espansa e un link per accedere al codice sorgente

Se fai clic sul link sorgente, accedi al codice sorgente, se è possibile accedere al file sorgente.

Immagine che mostra il codice sorgente a cui si accede da un link nella voce di log

Visualizzazione dei log

Nell'interfaccia Esplora log puoi filtrare le voci di log o cercare log specifici da visualizzare.

Filtrare i log

Puoi filtrare le voci di log per visualizzare solo i log che ti interessano.

Nel menu a discesa del tipo di risorsa e dell'istanza, puoi selezionare tutte le istanze di un particolare tipo di risorsa che vuoi visualizzare o visualizzare un'istanza specifica. Per un elenco dei tipi di risorse, consulta Risorse e servizi monitorati.
Nel menu a discesa del tipo di log, seleziona i log denominati che vuoi visualizzare o seleziona Tutti i log. Il menu mostra solo i log generati dalla risorsa selezionata.
Nel menu a discesa Gravità del log, seleziona il livello di gravità che vuoi visualizzare. La selezione di Tutti i livelli di log include le voci di log che non hanno un livello di gravità.
Nel menu a discesa Vai a data/ora, seleziona una data e un'ora. Scegli se visualizzare i log prima o dopo il timestamp selezionato.

Puoi inoltre fare clic su A filtro avanzato per accedere alla barra dei filtri avanzati in cui puoi filtrare le voci di log tramite query. Per ulteriori informazioni, fai clic sul link Guida per i filtri avanzati.

Ricerca nei log

Nella barra di ricerca, cerca le parole chiave presenti nelle voci di log.

Visualizzazione di log simili

Puoi fare clic sul valore di un singolo campo nella visualizzazione espansa voce di log, quindi mostrare o nascondere tutte le voci di log con lo stesso valore.

Immagine che mostra come fare clic per trovare voci di log simili

Quando visualizzi voci di log simili, viene visualizzata la barra dei filtri avanzati, dove puoi modificare il filtro e fare clic su Invia filtri. Per ulteriori informazioni, fai clic sul link Guida per i filtri avanzati.