Visualizza log ed errori in una dashboard personalizzata

Questo documento descrive i widget che puoi aggiungere alle tue dashboard personalizzate in modo da visualizzare i dati di log ed errori nello stesso contesto dei dati delle metriche. Il widget del riquadro dei log mostra le voci di log. Il widget del riquadro dei report sugli errori mostra i gruppi di errori più recenti. Entrambi questi widget forniscono informazioni che potrebbero essere utili durante la risoluzione dei problemi. Il widget del grafico di Analisi dei log, che mostra i risultati di una query SQL, consente di identificare le tendenze nei dati di log.

Esplora log e widget del riquadro dei log

Esplora log è il metodo standard per analizzare i log. L'aggiunta di un widget del riquadro dei log a una dashboard non cambierà il modo in cui utilizzi Esplora log. Poiché i widget del riquadro dei log possono essere aggiunti alle dashboard personalizzate, consentono di 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 ed entrambi mostrano solo le voci di log che hai l'autorizzazione a visualizzare. I ruoli IAM (Identity and Access Management) per le risorse in cui sono archiviate le voci di log recuperate vengono utilizzati per determinare se puoi visualizzare queste voci di log.

Esplora log e il widget del riquadro dei log sono preconfigurati per recuperare dai bucket di log le voci di log che hanno origine nel progetto Google Cloud attuale o che sono instradate al progetto attuale. Puoi configurare le voci di log che vengono recuperate. Ad esempio, puoi specificare che le voci di log di una visualizzazione di log vengano recuperate per la visualizzazione.

I widget del riquadro dei log visualizzano 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, l'immagine seguente mostra due voci di log:

Un'immagine di due voci di log nel widget del riquadro 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 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 risorse seguenti:

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 configurare il widget in modo che mostri le voci di log nei progetti o nelle visualizzazioni di log, chiedi all'amministratore di concederti i seguenti ruoli IAM:

Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.

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

Visualizza le voci di log su 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.

Un widget del riquadro dei log è preconfigurato per recuperare le voci di log che hanno origine nel progetto Google Cloud e quelle instradate al progetto Google Cloud. Tuttavia, puoi configurare le voci di log che il widget del riquadro dei log recupera dai bucket di log. Ad esempio, puoi configurare il widget in modo che mostri solo le voci di log che indicano un qualche tipo di condizione di errore o solo queste voci di log in una vista di log.

Puoi aggiungere fino a 40 widget a una dashboard.

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

  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. Fai clic su  Aggiungi widget nella barra degli strumenti.
  4. Nella finestra di dialogo Add widget, seleziona  Log.
  5. (Facoltativo) Per aggiornare il titolo, inserisci il nuovo titolo nel campo Titolo widget.

  6. (Facoltativo) Per modificare le voci di log recuperate, procedi in uno dei seguenti modi:

    • Per recuperare le voci di log da un progetto diverso o da più progetti, nella voce Progetto espandi Progetto corrente e completa la finestra di dialogo. Il menu elenca tutti i progetti Google Cloud nell'ambito delle metriche attuale.

      Se una voce nel menu include il testo "Non hai l'autorizzazione a livello di progetto per visualizzare i log in questo progetto", non hai le autorizzazioni necessarie per visualizzare le voci di log per il progetto Google Cloud.

    • Per recuperare le voci di log incluse nelle visualizzazioni dei log nei bucket di log, segui questi passaggi:

      1. Nella voce Ambito per, espandi Progetto, quindi seleziona Archiviazione.
      2. Nella voce Visualizzazioni archiviazione, espandi Progetto corrente e completa la finestra di dialogo. Il menu elenca le visualizzazioni dei log sui bucket di log nel progetto Google Cloud. Per selezionare le visualizzazioni dei log sui bucket di log in altri progetti Google Cloud, nel menu fai clic su Importa progetto, seleziona un progetto, quindi seleziona una o più visualizzazioni di log. Puoi importare solo i progetti inclusi nell'ambito delle metriche attuale.

  7. (Facoltativo) Per limitare i log visualizzati dal widget del riquadro dei log, inserisci una query nel campo Editor query e, se hai disabilitato 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 del modello al widget del riquadro dei log. Per scoprire di più, consulta Aggiungere filtri permanenti a una dashboard personalizzata.

  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 recuperate corrispondenti alla query. Puoi anche usare la barra dei filtri del widget per modificare temporaneamente le voci di log visualizzate. 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 di query utilizza lo stesso linguaggio per le query di Esplora log. Per informazioni sulla risoluzione dei problemi, consulta la pagina Problemi di sintassi.

I menu Gravità e Nome log 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 ti consente di filtrare in base alla risorsa. Puoi selezionare un tipo di risorsa, ad esempio Risorsa controllata, oppure navigare tra le finestre per selezionare un metodo specifico.

Ad esempio, per aggiungere una query per Risorsa controllata, segui questi passaggi:

  1. Espandi il menu Risorsa.
  2. Cerca e seleziona Risorsa controllata.

  3. Fai clic su Applica.

    In questi passaggi, aggiungi la seguente clausola al campo Editor di query:

    resource.type="audited_resource"

Analogamente, per aggiungere una query per gli audit log di Cloud Functions, segui questi passaggi:

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

  4. Fai clic su Applica.

    In questi passaggi, aggiungi 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 riquadro di 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 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 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 l'icona Mostra query, che mostra la query attuale 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 della 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 informazioni aggiuntive 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 temporali nella barra degli strumenti della dashboard. Ad esempio, seleziona 1H. Se non selezioni un intervallo di tempo personalizzato, il widget visualizza sempre i log più recenti, anche quando sono precedenti alla finestra temporale selezionata.

Quando indaghi su un incidente, ti consigliamo di limitare le voci di log solo a quelle che si trovano in un intervallo di tempo specifico. Per configurare le voci di log in modo che mostrino i log entro un intervallo di tempo fisso, esegui una o entrambe le seguenti operazioni:

  • Utilizza il selettore dell'intervallo di tempo per selezionare un intervallo di tempo.
  • Inserisci una clausola timestamp nel campo Editor query del riquadro di configurazione, quindi seleziona Applica filtro.

Se 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 dal display tutte le altre voci di log. Per configurare un widget del riquadro dei log in modo che mostri solo le voci di log che soddisfano livelli di gravità specifici, esegui una delle seguenti operazioni o entrambe:

  • 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, il valore "Avviso" genera le voci di log con gravità "Errore" recuperate, mentre quelle con gravità "Avviso" non vengono recuperate. Per impostazione predefinita, il valore di questo campo è impostato su Default, che include tutte le voci di 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, quindi seleziona Applica filtro.

Esempio: filtrare 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 che non sono di interesse. Ad esempio, per visualizzare le voci di log che includono un indirizzo email specifico, puoi filtrare per 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 fa distinzione tra maiuscole e minuscole.

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

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

    • Ad esempio, se aggiungi i filtri Get, OR e Compute, vengono visualizzate le voci di log contenenti Get o Compute.

    Il valore del campo Filtro non è permanente.

  • Per applicare un filtro permanente, modifica la query archiviata nel campo Editor di query, 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 "lamp", aggiungi la clausola jsonPayload.MESSAGE:"lamp" al campo Editor di query.

Visualizza 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 Analisi dei log

Questa sezione descrive come configurare e salvare un grafico generato da una query di Analisi dei log 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 Monitoring seguendo questi passaggi:

  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. Fai clic su  Aggiungi widget nella barra degli strumenti.
  4. Nella finestra di dialogo Aggiungi widget, vai alla sezione Dati e seleziona Analisi dei log.
  5. Nel riquadro Configura widget, configura i dati da visualizzare nel grafico creando una query mediante SQL, quindi fai clic su Esegui query.

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

    Nel riquadro Visualizzazione, puoi modificare il tipo di grafico e personalizzare le righe e le colonne da rappresentare cambiando la dimensione, la misura e la suddivisione:

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

    • Misura: puoi selezionare più misure nel riquadro Visualizzazione grafico. Quando selezioni una misura, devi selezionare anche la funzione di aggregazione da eseguire sui 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 di dati 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 Analisi dei log possono essere modificati anche dopo essere stati salvati in una dashboard. Per maggiori informazioni, consulta Modificare la configurazione di un widget.

Visualizza 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 sull'aggiunta di un riquadro per la segnalazione degli errori a una dashboard tramite l'API Cloud Monitoring, consulta Dashboard con un widget ErrorReportingPanel.

Per aggiungere un riquadro per la 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. Fai clic su  Aggiungi widget nella barra degli strumenti.
  4. Nella finestra di dialogo Aggiungi widget, vai alla sezione Visualizzazione e seleziona riquadro Error Reporting.
  5. Seleziona il progetto di cui vengono visualizzati i gruppi di errori, espandi Progetti, quindi effettua una selezione.
  6. (Facoltativo) Aggiorna il titolo.

  7. (Facoltativo) Per limitare le risorse per cui vengono visualizzati 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 per le risorse App Engine, seleziona Servizi GAE e fai clic su Applica.

      • Per visualizzare gli errori per un servizio App Engine specifico, seleziona Servizi GAE, seleziona il servizio e 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:

    Esempio di un riquadro di configurazione del riquadro dei report degli errori.

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

Risolvere i problemi

Passaggi successivi