Questo documento fornisce informazioni su come utilizzare lo Visualizzatore dei log Cloud Logging per esaminare i log.
Prima di iniziare
Configura l'applicazione in modo da utilizzare l'API Cloud Logging.
Accedi al tuo account per accedere alle risorse Google Cloud.
- Seleziona Strumenti -> Strumenti Google Cloud -> Gestisci account… per selezionare il tuo account.
Accesso a Esplora log
Per accedere a Esplora log di Cloud Logging, seleziona Strumenti -> Strumenti Google Cloud -> Mostra Esplora log di Stackdriver.
Si apre la scheda Google Stackdriver Logging.
In alternativa, puoi aprire Esplora log per un progetto specifico da Google Cloud Explorer selezionando Strumenti -> Strumenti Google Cloud -> Google Cloud Explorer. Fai clic con il tasto destro del mouse sul progetto e seleziona Esamina i log di Stackdriver.
Navigare nell'interfaccia
L'interfaccia di Esplora log è composta dai seguenti componenti principali:
Una barra di ricerca per filtrare le voci di log in base all'etichetta o alla ricerca di testo.
Menu a discesa per filtrare l'elenco per risorse, log e livelli di gravità.
Menu a discesa Vai all'ora per visualizzare una data e un'ora specifiche nei log.
Un pulsante Aggiorna per recuperare i log più recenti in ordine decrescente.
L'opzione Carica automaticamente lo stream di log controlla se visualizzare o meno le nuove voci di log man mano che arrivano.
Se fai clic su Riproduci, viene avviato lo stream degli ultimi log. Lo stream si interromperà se scorri la visualizzazione dei log.
Se fai clic su In pausa, lo stream di log viene interrotto.
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 per visualizzare i dettagli di tutte le voci di log. Questa operazione potrebbe richiedere del tempo se il riquadro contiene molte voci di log.
Se disponibile, un link alla fonte per individuare il codice sorgente che genera la voce del log.
Navigazione al codice sorgente
Logs Explorer ti consente di accedere al codice sorgente che genera una voce di log. Per attivare questa funzionalità, devi compilare il progetto da un repository git locale e aggiungere le informazioni sulla posizione dell'origine alle voci di log.
Aggiunta della posizione di origine al log
Configura l'applicazione in modo da fornire informazioni sulla posizione del codice sorgente nei log:
Scrivi i dati sulla posizione per le voci di log utilizzando il seguente esempio di GitHub.
Esegui il deployment di un file
source_context.jsonnella directory principale dell'applicazione.Se pubblichi la soluzione tramite Cloud Tools for Visual Studio, l'estensione genera e distribuisce automaticamente il file.
Dopo aver completato questi passaggi, le voci di log contengono un campo sourceLocation con informazioni su File e Line. La riga facoltativa Function può contenere il nome, la versione o il nome della funzione dell'assembly.
Se il file di origine è accessibile, facendo clic sul link di origine si accede al codice sorgente.
Visualizzazione dei log
Nell'interfaccia di Esplora log, puoi filtrare le voci dei log o cercare log specifici da visualizzare.
Filtrare i log
Puoi filtrare le voci di log in modo da visualizzare solo quelle che ti interessano.
Nel menu a discesa del tipo di risorsa e dell'istanza, puoi selezionare tutte le istanze di un determinato 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 Tutti i log. Il menu mostra solo i log generati dalla risorsa selezionata.
Nel menu a discesa della gravità del log, seleziona il livello di gravità da 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 al momento, seleziona una data e un'ora. Scegli se visualizzare i log prima o dopo il timestamp selezionato.
Puoi anche fare clic su Al filtro avanzato per accedere alla barra dei filtri avanzati, dove puoi filtrare le voci di log tramite query. Fai clic sul link Guida ai filtri avanzati per saperne di più.
Ricerca nei log
Nella barra di ricerca, cerca le parole chiave visualizzate nelle voci del log.
Visualizzazione di log simili
Puoi fare clic sul valore di un singolo campo nella visualizzazione espansa della voce di log e poi mostrare o nascondere tutte le voci di log con lo stesso valore.
Quando vengono visualizzate voci di log simili, viene visualizzata la barra dei filtri avanzati, in cui puoi modificare il filtro e fare clic su Invia filtri. Fai clic sul link Guida ai filtri avanzati per saperne di più.