Visualizzare log ed errori in una dashboard personalizzata

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

Questa funzionalità è supportata solo per i progetti Google Cloud . Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione della cartella app.

Esplora log e il widget del riquadro dei log

Esplora log è il modo standard per esaminare i log. L'aggiunta di un widget del pannello dei log a una dashboard non cambia il modo in cui utilizzi Esplora log. Poiché i widget del pannello dei log possono essere aggiunti alle dashboard personalizzate, forniscono 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 che hai l'autorizzazione a visualizzare. I tuoi ruoli IAM (Identity and Access Management) sulle risorse che archiviano le voci di log determinano se puoi visualizzare le voci di log archiviate.

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 sink 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 per visualizzazione log.

I widget del pannello dei log mostrano una voce di log per riga, con colonne per gravità, 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 della voce varia in base al tipo di log. Ad esempio, l'immagine seguente mostra due voci di log:

Un'immagine di due voci di log nel widget del pannello dei log.

Nell'immagine 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 formattata come stringa della struttura JSON per la voce. La seconda voce mostra i risultati di una richiesta e visualizza solo una frase che riassume l'azione eseguita.

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

Prima di iniziare

Completa i seguenti passaggi nel progetto Google Cloud in cui vuoi visualizzare i log nelle dashboard personalizzate:

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

    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 le voci di log su una dashboard

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

Puoi inserire fino a 100 widget in una dashboard.

Per aggiungere un widget del pannello dei log alla dashboard utilizzando la console, segui questi passaggi:

  1. Nella Google Cloud console, 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. Nella barra degli strumenti della console Google Cloud , seleziona il tuo Google Cloud progetto. Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione della cartella app.
  3. Seleziona una dashboard o fai clic su Crea dashboard.
  4. Nella barra degli strumenti, fai clic su  Aggiungi widget.
  5. Nella finestra di dialogo Aggiungi widget, seleziona  Log.
  6. (Facoltativo) Per aggiornare il titolo, inserisci il nuovo titolo nel campo Titolo widget.

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

    • Per eseguire la ricerca per progetto, imposta la voce Ambito per su Progetto, quindi espandi la voce Progetti e completa la finestra di dialogo.

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

      Le voci di log visualizzate includono quelle che hanno origine nel tuo progettoGoogle Cloud e quelle indirizzate al tuo progettoGoogle Cloud da un sink in un altro progetto.

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

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

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

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

  8. (Facoltativo) Per limitare i log visualizzati dal widget del pannello 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, vedi Esempi di query.

  9. (Facoltativo) Applica le variabili al widget del riquadro dei log.

    Puoi aggiornare la query di un widget in modo che dipenda da una variabile, in modo che quando modifici il valore della variabile, i dati visualizzati dal widget cambino. Puoi anche utilizzare una variabile per controllare la visibilità di un widget. Per ulteriori informazioni, consulta i seguenti documenti:

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

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

    Il widget del riquadro dei log mostra una tabella di voci di log. Puoi anche utilizzare la barra dei filtri 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 testo nel campo o effettuare selezioni dai menu. Il campo Editor query utilizza lo stesso linguaggio di query di Esplora log. Per informazioni sulla risoluzione dei problemi, vedi Problemi di sintassi.

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

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

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

Ad esempio, per aggiungere una query per Risorsa sottoposta ad audit:

  1. Espandi il menu Risorsa.
  2. Cerca e seleziona Risorsa sottoposta ad audit.

  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 di Cloud Run Functions, procedi nel seguente modo:

  1. Espandi il menu Risorsa.
  2. Cerca e seleziona Risorsa sottoposta ad audit.
  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"

Filtrare le voci di log

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

  • Selettore dell'ora della dashboard: il widget del pannello 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 conservato 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 conservato solo per la sessione corrente.

  • Query sul widget del riquadro dei log: il widget del riquadro dei log mostra solo le voci di log che corrispondono 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 visualizza la query corrente come descrizione comando.

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

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

  • Filtri della dashboard: quando esistono filtri della dashboard, l'impostazione del filtro viene applicata alla query del widget del riquadro dei log. Ad esempio, se aggiungi il filtro del dashboard cluster_name: mycluster, la query viene aggiornata in modo da includere resource.labels."cluster_name"="mycluster". Per ulteriori informazioni sui filtri dei dashboard, vedi 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 per data

Per visualizzare i log più recenti in un widget del pannello dei log, utilizza i campi temporali nella barra degli strumenti della dashboard. Ad esempio, seleziona 1 ora. Se non selezioni un intervallo di tempo personalizzato, il widget mostra sempre i log più recenti, anche se sono più vecchi della finestra temporale selezionata.

Quando esamini un incidente, potresti voler limitare le voci di log a quelle che rientrano in un intervallo di tempo specifico. Per configurare le voci di log in modo che mostrino solo i log che si trovano 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 query del riquadro di configurazione, quindi seleziona Applica filtro.

Quando specifichi un intervallo di tempo, il widget del pannello 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 tutte le altre voci dei log. Per configurare un widget del pannello dei log in modo che visualizzi solo le voci di log che soddisfano 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 "Warning" comporta il recupero delle voci di log con gravità "Error", ma non di quelle con gravità "Notice". Per impostazione predefinita, il valore di questo campo è impostato su Default, che include tutte le voci di log.

    L'impostazione per il menu Gravità viene eliminata quando esci dalla dashboard.

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

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

Il filtraggio delle voci di log in base a una stringa o una frase specifica consente di eliminare dalla visualizzazione le voci di log che non sono 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 contains non distingue tra maiuscole e minuscole.

    Se aggiungi più filtri, vengono visualizzati solo i log che corrispondono a tutti i filtri perché tra i filtri adiacenti viene inserito un AND implicito. 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 query e poi seleziona Applica filtro. Per informazioni sulla sintassi delle query, consulta Linguaggio di 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 query.

Visualizzare le voci di log in Esplora log

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

  1. Nel widget del pannello 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 pannello dei log vengono applicati automaticamente.

  3. Seleziona la voce di log che vuoi visualizzare.

Visualizzare i grafici generati da una query di Analisi dei log

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 cercare e aggregare i log per generare insight utili utilizzando query SQL.

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

  1. Nella Google Cloud console, 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. Nella barra degli strumenti della console Google Cloud , seleziona il tuo Google Cloud progetto. Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione della cartella app.
  3. Seleziona una dashboard o fai clic su Crea dashboard.
  4. Nella barra degli strumenti, fai clic su  Aggiungi widget.
  5. Nella finestra di dialogo Aggiungi widget, vai alla sezione Dati e seleziona Analisi dei log.

  6. Nella finestra di dialogo Configura widget, configura i dati da visualizzare, quindi fai clic su Esegui query.

    Per selezionare i dati da visualizzare, puoi creare una query SQL o selezionarne una salvata o recente. Le visualizzazioni dei log e le visualizzazioni di Analytics su cui puoi eseguire query sono elencate nella sezione Visualizzazioni e schema. Se fai clic su un'origine dati, viene visualizzato un elenco di campi per quell'origine dati sotto l'intestazione Schema.

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

    Nel riquadro Visualizzazione, puoi modificare il tipo di grafico e personalizzare le righe e le colonne rappresentate nel grafico modificando la dimensione, la misura e la distribuzione:

    • Dimensione: La dimensione deve essere una colonna di timestamp, numerica o stringa. Per impostazione predefinita, la dimensione è impostata sulla prima colonna basata sul timestamp nello schema. Se nella query non è presente alcun timestamp, la prima colonna di stringa viene selezionata come dimensione. Puoi anche personalizzare la dimensione nel pannello Visualizzazione grafico. Quando una colonna timestamp viene selezionata come dimensione, il grafico mostra come cambiano i dati nel tempo. Quando una colonna di stringa viene selezionata come dimensione per un grafico a barre, puoi ordinare i dati in ordine crescente o decrescente, il che ordina la dimensione in ordine lessicale. Puoi anche mantenere l'ordine di ordinamento "predefinito", che ordina la dimensione in base ai valori della misura corrispondente in ordine decrescente.

    • Misura: puoi selezionare più misure nel riquadro Visualizzazione grafico. Quando selezioni una misura, devi anche selezionare la funzione di aggregazione da eseguire sui 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 dividere una singola serie di dati in più serie di dati in base a un'altra colonna, aggiungi una suddivisione.

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

  8. 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 saperne di più, consulta Modificare la configurazione di un widget.

Visualizzare gli errori su una dashboard

Questa sezione descrive come aggiungere e configurare un pannello di segnalazione degli errori utilizzando la console Google Cloud . Per informazioni sull'aggiunta di un riquadro di 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 Google Cloud console, 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. Nella barra degli strumenti della console Google Cloud , seleziona il tuo Google Cloud progetto. Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione della cartella app.
  3. Seleziona una dashboard o fai clic su Crea dashboard.
  4. Nella barra degli strumenti, fai clic su  Aggiungi widget.
  5. Nella finestra di dialogo Aggiungi widget, vai alla sezione Visualizzazione e seleziona Pannello Error Reporting.
  6. Seleziona il progetto di cui vengono visualizzati i gruppi di errori, espandi Progetti e poi fai una selezione.
  7. (Facoltativo) Aggiorna il titolo.

  8. (Facoltativo) Per limitare le risorse per le quali vengono visualizzati gli errori, procedi nel seguente modo:

    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 mostrare gli errori relativi alle risorse App Engine, seleziona Servizi GAE, quindi fai clic su Applica.

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

  9. 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:

    Esempio di un riquadro di configurazione del pannello di segnalazione degli errori.

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

Risoluzione dei problemi

Passaggi successivi