Visualizzare log ed errori in una dashboard personalizzata

Questo documento descrive i widget che puoi aggiungere alle dashboard personalizzate per visualizzare i dati dei log e degli errori nello stesso contesto dei dati delle metriche. Il widget del riquadro dei log visualizza le voci di log. Il widget del riquadro di segnalazione degli errori visualizza i gruppi di errori più recenti. Entrambi questi widget forniscono informazioni che potrebbero essere utili durante la risoluzione dei problemi. Il widget grafico di Log Analytics, che mostra i risultati di una query SQL, consente di identificare le tendenze nei dati dei log.

Esplora log e il widget del riquadro dei log

Esplora log è il modo standard per esaminare i log. L'aggiunta di un widget del riquadro dei log a una dashboard non cambia il modo in cui utilizzi Esplora log. Poiché i widget del riquadro dei log possono essere aggiunti alle dashboard personalizzate, offrono un modo per visualizzare le voci di log nello stesso contesto delle metriche.

Esplora log e il widget del riquadro dei log supportano lo stesso linguaggio di query e mostrano solo le voci di log per le quali disponi dell'autorizzazione di visualizzazione. I ruoli IAM (Identity and Access Management) sulle risorse che memorizzano le voci dei log determinano se puoi visualizzarle.

Esplora log e il widget del riquadro dei log sono entrambi preconfigurati per cercare le voci di log nelle risorse elencate nell'ambito di log predefinito. Se questo ambito non è accessibile, vengono cercate le voci di log che hanno origine nel progetto selezionato. Quando viene selezionato un progetto, i risultati di ricerca includono le voci di log instradate al progetto da un'area di destinazione in un altro progetto e poi archiviate in un bucket di log. Puoi configurare le risorse in cui cercare le voci di log. Ad esempio, puoi cercare le voci di log in base alla visualizzazione del log.

I widget del riquadro dei log mostrano una voce di log per riga, con colonne per la gravità, il timestamp e un riepilogo della voce di log. Per visualizzare la rappresentazione in formato JSON di una voce di log, fai clic sul pulsante Visualizza dettagli log. La struttura di ogni riepilogo delle voci varia in base al tipo di log. Ad esempio, la seguente immagine mostra due voci di log:

Nella figura precedente, la prima voce di log mostra informazioni su una richiesta di servizio. Il riepilogo mostra informazioni sul servizio, un indirizzo email e una versione in formato stringa della struttura JSON per la voce. La seconda voce mostra i risultati di una richiesta e solo una frase che riassume l'azione che si è verificata.

Per informazioni generali su Cloud Logging, consulta le seguenti risorse:

• Concetti di base
• Lingua delle query di Logging
• Esplora log

Prima di iniziare

Per ottenere le autorizzazioni necessarie per aggiungere un widget del riquadro dei log a una dashboard personalizzata utilizzando la console Google Cloud e per configurarlo in modo da visualizzare le voci di log nei progetti o nelle visualizzazioni dei log, chiedi all'amministratore di concederti i seguenti ruoli IAM:

• Editor di monitoraggio (roles/monitoring.editor) nel tuo progetto.
• Visualizzatore log (roles/logging.viewer) su ogni progetto di cui vuoi visualizzare le voci di log. Questo ruolo non ti concede l'accesso a ogni voce di log. Per ulteriori informazioni sui ruoli, consulta Controllo dell'accesso a Cloud Logging con IAM.
• Funzione di accesso alla visualizzazione log (roles/logging.viewAccessor) in ogni progetto che memorizza il bucket di log per una visualizzazione di log a cui vuoi accedere. Il ruolo Accesso alle visualizzazioni dei log concede l'accesso a tutte le visualizzazioni dei log archiviate dal progetto. Per informazioni su come ottenere l'accesso a visualizzazioni dei log specifiche, consulta Controllare l'accesso a una visualizzazione dei log.

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

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

Visualizzare le voci di log in una dashboard

Questa sezione descrive come aggiungere e configurare un widget del riquadro dei log utilizzando la console Google Cloud. Per informazioni sull'utilizzo dell'API Cloud Monitoring, consulta Dashboard con un widget LogsPanel.

Puoi inserire fino a 40 widget in una dashboard.

Per aggiungere un widget del riquadro dei log alla dashboard utilizzando la console:

1. Nella console Google Cloud, vai alla pagina  Dashboard:

   Vai a Dashboard

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

2. Seleziona una dashboard o fai clic su Crea dashboard.
3. Nella barra degli strumenti, fai clic su  Aggiungi widget.
4. Nella finestra di dialogo Aggiungi widget, seleziona  Log.
5. (Facoltativo) Per aggiornare il titolo, inserisci il nuovo titolo nel campo Titolo widget.

6. Configura le risorse in cui cercare le voci di log:

   • Per eseguire ricerche per progetto, imposta l'elemento Ambito per su Progetto, quindi espandi l'elemento Progetti e completa la finestra di dialogo.

     Nota: devi espandere il menu Progetti e selezionare almeno un progetto. Nessun progetto viene selezionato automaticamente.

     Il menu Progetti elenca tutti i progetti Google Cloud nell'ambito delle metriche corrente. Se una voce del menu include il testo "Non disponi dell'autorizzazione a livello di progetto per visualizzare i log in questo progetto", non disponi delle autorizzazioni necessarie per visualizzare le voci log disponibili nel progetto Google Cloud.

     Le voci di log visualizzate includono quelle che hanno origine nel progetto Google Cloud e quelle che vengono instradate al progetto Google Cloud da un'area di destinazione in un altro progetto.

   • Per cercare voci di log per visualizzazioni dei log nei bucket di log, imposta la voce Definisci ambito su Archiviazione, quindi espandi la voce Visualizzazioni dell'archiviazione e completa la finestra di dialogo.

     Nota: devi espandere il menu Visualizzazioni dello spazio di archiviazione e selezionare almeno una visualizzazione dei log. Nessuna vista dei log viene selezionata automaticamente.

     Il menu Visualizzazioni di archiviazione elenca le visualizzazioni dei log nei bucket dei log del progetto Google Cloud selezionato.

     Per selezionare le visualizzazioni dei log nei bucket dei log in altri progetti Google Cloud, nel menu, fai clic su Importa progetto, seleziona un progetto e poi una o più visualizzazioni dei log. Puoi importare solo i progetti inclusi nell'ambito corrente delle metriche.

     Nota: se l'utente corrente non dispone dell'autorizzazione per accedere a tutte le visualizzazioni dei log in cui un widget del riquadro dei log cerca le voci di log, il widget mostra un errore. Per ulteriori informazioni, consulta Il riquadro dei log mostra il messaggio di autorizzazione negata.

   • Per cercare le risorse incluse in un ambito di log, che può includere progetti e visualizzazioni di log, imposta la voce Ambito per su Ambito log, quindi espandi la voce Ambiti log e seleziona un ambito di log.

     Gli ambiti dei log sono in Anteprima pubblica.

7. (Facoltativo) Per limitare i log visualizzati dal widget del riquadro dei log, inserisci una query nel campo Editor query e, se hai disattivato l'esecuzione automatica delle query, fai clic su Esegui query. Per una breve introduzione alle query, consulta Esempi di query.

8. (Facoltativo) Applica le variabili al widget del riquadro dei log. Le variabili sono filtri a livello di dashboard che si applicano solo a widget specifici. Per ulteriori informazioni, consulta Applicare una variabile a un widget.

9. Per applicare le modifiche alla dashboard, fai clic su Applica nella barra degli strumenti. Per ignorare le modifiche, fai clic su Annulla.

10. Per salvare la dashboard modificata, fai clic su Salva nella barra degli strumenti.

    Il widget del riquadro dei log mostra una tabella delle voci di log. Puoi anche utilizzare la barra di filtro del widget per modificare temporaneamente le voci di log visualizzate dal widget. Per ulteriori informazioni, consulta la sezione Filtrare le voci di log.

Esempi di query

Per compilare il campo Editor di query, puoi inserire del testo nel campo o effettuare selezioni dai menu. Il campo Editor di query utilizza lo stesso linguaggio di query di Esplora log. Per informazioni sulla risoluzione dei problemi, consulta la sezione Problemi di sintassi.

I menu Gravità e Nome log ti consentono di selezionare più opzioni. Di seguito è riportato un esempio di un'istruzione di query che corrisponde a più livelli di gravità:

severity=(WARNING OR ERROR OR CRITICAL OR ALERT OR EMERGENCY)

Il menu Risorsa ti consente di filtrare per risorsa. Puoi selezionare un tipo di risorsa, ad esempio Risorsa sottoposta a controllo, oppure puoi spostarti tra le finestre per selezionare un metodo specifico.

Ad esempio, per aggiungere una query per la risorsa sottoposta a revisione:

1. Espandi il menu Risorsa.
2. Cerca e seleziona Risorsa sottoposta a controllo.

3. Fai clic su Applica.

   Questi passaggi aggiungono la seguente clausola al campo Editor di query:

   resource.type="audited_resource"
   

Analogamente, per aggiungere una query per gli audit log delle funzioni Cloud Run, svolgi i seguenti passaggi:

1. Espandi il menu Risorsa.
2. Cerca e seleziona Risorsa sottoposta a controllo.
3. Nel menu dei servizi, seleziona Cloud Functions.

4. Fai clic su Applica.

   Questi passaggi aggiungono la seguente clausola al campo Editor di query:

   resource.type="audited_resource" resource.labels.service="cloudfunctions.googleapis.com"
   

Filtra le voci di log

Puoi modificare le voci di log visualizzate da un widget del riquadro dei log modificando i valori dei seguenti campi o menu:

• Selettore dell'ora della dashboard: il widget del riquadro dei log recupera solo le voci di log scritte nell'intervallo specificato da questo campo.

• Campo Filtro nel widget del riquadro dei log: Il filtro specificato viene applicato al termine della query. Il valore di questo campo viene mantenuto solo per la sessione corrente.

• Menu Gravità nel widget del riquadro dei log: il filtro per livello di gravità viene applicato al termine della query. Il valore di questo campo viene mantenuto solo per la sessione corrente.

• Query sul widget del riquadro dei log: il widget del riquadro dei log mostra solo le voci di log corrispondenti alla query. Se non specifichi una query, vengono visualizzati tutti i log nell'intervallo di tempo selezionato. Se specifichi una query, il widget del riquadro dei log mostra un'icona Mostra query, che mostra la query corrente come descrizione comando.

  Per modificare la query, modifica il widget del riquadro dei log.

• Progetto Google Cloud nel widget del riquadro dei log: per modificare questa impostazione, modifica il widget del riquadro dei log.

• Filtri dashboard: se esistono filtri della dashboard, l'impostazione del filtro viene applicata alla query del widget del riquadro dei log. Ad esempio, se aggiungi il filtro della dashboard cluster_name: mycluster, la query viene aggiornata in modo da includere resource.labels."cluster_name"="mycluster". Per ulteriori informazioni sui filtri della dashboard, consulta Aggiungere filtri temporanei e Aggiungere filtri permanenti.

Il resto di questa sezione fornisce ulteriori informazioni su come filtrare le voci di log.

Esempio: filtrare le voci di log in base alla data

Per visualizzare i log più recenti in un widget del riquadro dei log, utilizza i campi di tempo nella barra degli strumenti della dashboard. Ad esempio, seleziona 1H. A condizione che non selezioni un intervallo di tempo personalizzato, il widget mostra sempre i log più recenti, anche se sono più vecchi dell'intervallo di tempo selezionato.

Quando esamini un incidente, potresti voler limitare le voci del log a quelle che si trovano in un intervallo di tempo specifico. Per configurare le voci di log in modo che vengano visualizzate nei log in un intervallo di tempo fisso, esegui una o entrambe le seguenti operazioni:

• Seleziona un intervallo di tempo utilizzando il selettore dell'intervallo di tempo.
• Inserisci una clausola timestamp nel campo Editor di query del riquadro di configurazione e poi seleziona Applica filtro.

Quando specifichi un intervallo di tempo, il widget del riquadro dei log non viene aggiornato automaticamente.

Esempio: filtrare le voci di log in base alla gravità

Quando monitori il debug di una situazione di errore, potresti voler visualizzare solo i messaggi di errore e nascondere dalla visualizzazione tutte le altre voci dei log. Per configurare un widget del riquadro dei log in modo che mostri solo le voci di log chesoddisfano livelli di gravità specifici, esegui una o entrambe le seguenti operazioni:

• Per applicare un filtro temporaneo, seleziona un valore per il menu Gravità nel widget del riquadro dei log. Questo menu specifica un livello di gravità minimo. Ad esempio, un valore "Avviso" consente di recuperare le voci di log con gravità "Errore", ma non quelle con gravità "Avviso". Per impostazione predefinita, il valore di questo campo è impostato su Default, che include tutte le voci del log.

  L'impostazione del menu Gravità viene ignorata quando esci dalla dashboard.

• Per applicare un filtro permanente, inserisci una clausola severity nel campo Editor di query del riquadro di configurazione e poi seleziona Applica filtro.

Esempio: filtra le voci di log in base a una stringa o una frase

Filtrare le voci di log in base a una stringa o una frase specifica consente di eliminare dalla visualizzazione le voci di log non di interesse. Ad esempio, per visualizzare le voci di log che includono un indirizzo email specifico, puoi filtrare in base a quell'indirizzo.

• Per applicare un filtro temporaneo in modo da visualizzare solo le voci di log che contengono una parola o una frase specifica, utilizza il campo Filtro. Il test contiene non è sensibile alle maiuscole.

  Se aggiungi più filtri, vengono visualizzati solo i log che corrispondono a tutti i filtri perché viene inserito un AND implicito tra i filtri adiacenti. Tuttavia, puoi inserire esplicitamente un operatore OR:

  • Ad esempio, quando aggiungi i filtri Get e Compute, vengono visualizzate le voci di log che contengono entrambe le parole.

  • Ad esempio, quando aggiungi i filtri Get, OR e Compute, vengono visualizzate le voci di log che contengono Get o Compute.

  Il valore del campo Filtro non è persistente.

• Per applicare un filtro permanente, modifica la query memorizzata nel campo Editor di query e poi seleziona Applica filtro. Per informazioni sulla sintassi delle query, consulta Lingua delle query di logging.

  Ad esempio, per visualizzare solo le voci di log con un campo MESSAGE il cui valore contiene la stringa "lampada", aggiungi la clausola jsonPayload.MESSAGE:"lamp" al campo Editor di query.

Visualizzare le voci di log in Esplora log

I widget del riquadro dei log mostrano i campi chiave delle voci di log, ma non la voce di log completa. Per esaminare tutti i campi di una voce di log:

1. Nel widget del riquadro dei log, seleziona Visualizza in Esplora log.

2. Nella finestra di dialogo, seleziona il progetto Google Cloud in cui aprire Esplora log.

   Esplora log si apre in una nuova scheda del browser e i filtri selezionati nel widget del riquadro dei log vengono applicati automaticamente.

3. Seleziona la voce di log che vuoi visualizzare.

Visualizzare i grafici generati da una query di Log Analytics

Anteprima

Questa funzionalità è soggetta ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Questa sezione descrive come configurare e salvare un grafico generato da una query Log Analytics in una dashboard personalizzata. L'analisi dei log consente di eseguire ricerche e aggregare i log per generare informazioni utili utilizzando query SQL.

Oltre a utilizzare la pagina Log Analytics per configurare e salvare i grafici in una dashboard, puoi salvare un grafico di Log Analytics direttamente in Monitoraggio nel seguente modo:

1. Nella console Google Cloud, vai alla pagina  Dashboard:

   Vai a Dashboard

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

2. Seleziona una dashboard o fai clic su Crea dashboard.
3. Nella barra degli strumenti, fai clic su  Aggiungi widget.
4. Nella finestra di dialogo Aggiungi widget, vai alla sezione Dati e poi seleziona Log Analytics.

5. Nel riquadro Configura widget, configura i dati da visualizzare e poi fai clic su Esegui query.

   Per selezionare i dati da visualizzare, puoi creare una query SQL o selezionare una query salvata o recente.

6. (Facoltativo) Nella scheda Risultati, personalizza la configurazione del grafico utilizzando il riquadro Visualizza.

   Nel riquadro Visualizza, puoi modificare il tipo di grafico e personalizzare le righe e le colonne da includere nel grafico modificando la dimensione, la misura e la suddivisione:

   • Dimensione: la dimensione deve essere una colonna di timestamp, numerica o di stringa. Per impostazione predefinita, la dimensione è impostata sulla prima colonna basata su timestamp nello schema. Se nella query non è presente alcun timestamp, la prima colonna di stringhe viene selezionata come dimensione. Puoi anche personalizzare la dimensione nel pannello Visualizzazione del grafico. Quando una colonna del timestamp è selezionata come dimensione, il grafico mostra come cambiano i dati nel tempo.

   • Misura: puoi selezionare più misure nel riquadro Visualizzazione del grafico. Quando selezioni una misura, devi selezionare anche la funzione di aggregazione da applicare ai relativi valori raggruppati, ad esempio count, sum, average e percentile-99. Ad esempio, count-distinct restituisce il numero di valori univoci in una determinata colonna.

   • Suddivisione: per suddividere una singola serie di dati in più serie in base a un'altra colonna, aggiungi una suddivisione.

   Per ulteriori informazioni sulla personalizzazione della configurazione del grafico, consulta Personalizzare la configurazione del grafico.

7. Per salvare la dashboard modificata, fai clic su Salva nella barra degli strumenti.

I grafici di Log Analytics possono essere modificati anche dopo essere stati salvati in una dashboard. Per ulteriori informazioni, consulta Modificare la configurazione di un widget.

Visualizzare gli errori in una dashboard

Questa sezione descrive come aggiungere e configurare un riquadro per la segnalazione degli errori utilizzando la console Google Cloud. Per informazioni su come aggiungere un riquadro per la segnalazione degli errori a una dashboard utilizzando l'API Cloud Monitoring, consulta Dashboard con un widget ErrorReportingPanel.

Per aggiungere un riquadro di segnalazione degli errori alla dashboard utilizzando la console:

1. Nella console Google Cloud, vai alla pagina  Dashboard:

   Vai a Dashboard

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

2. Seleziona una dashboard o fai clic su Crea dashboard.
3. Nella barra degli strumenti, fai clic su  Aggiungi widget.
4. Nella finestra di dialogo Aggiungi widget, vai alla sezione Visualizzazione e poi seleziona Riquadro Error Reporting.
5. Seleziona il progetto di cui vengono visualizzati i gruppi di errori, espandi Progetti e poi effettua una selezione.
6. (Facoltativo) Aggiorna il titolo.

7. (Facoltativo) Per limitare le risorse per le quali vengono visualizzati gli errori:

   1. Espandi Tutte le risorse e seleziona una risorsa.

   2. Dopo aver selezionato una risorsa, puoi selezionare Applica oppure utilizzare i menu aggiuntivi per perfezionare i criteri di filtro:

      • Per visualizzare gli errori relativi alle risorse App Engine, seleziona Servizi GAE e poi fai clic su Applica.

      • Per visualizzare gli errori relativi a un servizio App Engine specifico, seleziona Servizi GAE, seleziona il servizio e poi fai clic su Applica.

8. Per applicare le modifiche alla dashboard, fai clic su Applica nella barra degli strumenti. Per ignorare le modifiche, fai clic su Annulla.

   L'esempio seguente mostra un riquadro di segnalazione degli errori:

   

9. Per salvare la dashboard modificata, fai clic su Salva nella barra degli strumenti.

Risoluzione dei problemi

• Il riquadro dei log indica che vengono visualizzati dati parziali
• Il riquadro dei log segnala una query non valida
• Il riquadro dei log mostra il messaggio "Nessuna voce trovata"

Passaggi successivi

• Per informazioni su come Cloud Monitoring fornisce visibilità alle metriche e ai log archiviati in più progetti Google Cloud, consulta Panoramica dell'ambito delle metriche.

• Per informazioni su come configurare una dashboard in modo da mostrare log o errori utilizzando l'API, consulta quanto segue:

  • Dashboard con un widget LogsPanel.
  • Dashboard con un widget ErrorReportingPanel.

• Per scoprire di più sui gruppi di errori, consulta la Panoramica di Error Reporting.