Visualizza log ed errori in una dashboard personalizzata

Questo documento descrive i widget che puoi aggiungere alle tue dashboard personalizzate in modo da poter visualizzare i dati di log ed errori nello stesso contesto del i dati delle metriche. Il widget del riquadro dei log visualizza le voci di log. Il widget del riquadro per la segnalazione degli errori mostra i gruppi di errori più recenti. Entrambe le opzioni i widget forniscono informazioni che potrebbero essere utili durante la risoluzione dei problemi. Il widget del grafico di Analisi dei log, che visualizza 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 dashboard personalizzate, sono 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 ed entrambi mostrano solo voci di log che puoi visualizzare. Il tuo Ruoli IAM (Identity and Access Management) nelle risorse in cui sono archiviate le voci di log. recuperate vengono utilizzate per determinare se è possibile visualizzare le voci di log corrispondenti.

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

I widget del riquadro dei log mostrano una voce di log per riga, con colonne per la gravità, il timestamp e un della voce di log. Per visualizzare la rappresentazione in formato JSON di un 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, viene visualizzata la prima voce di log le informazioni su una richiesta di servizio. Il riepilogo mostra le informazioni servizio, un indirizzo email e una versione in formato stringa del Struttura JSON della voce. La seconda voce mostra i risultati di una richiesta e mostra 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 configurarla in modo che mostri le voci di log nei progetti o nelle visualizzazioni log, chiedi all'amministratore di concederti seguenti ruoli IAM:

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

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

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 del tuo progetto Google Cloud e quelle indirizzate al tuo progetto Google Cloud. Tuttavia, puoi configurare per quali voci di log il widget del riquadro dei log recupera dai bucket di log. Ad esempio, potresti configura il widget in modo che mostri solo le voci di log che indicano una condizione di errore o solo le voci di log in una visualizzazione log.

Puoi aggiungere fino a 40 widget a una dashboard.

Per aggiungere alla dashboard un widget del riquadro dei log utilizzando la console, procedi 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 Monitoraggio.

  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 quello nuovo nella casella Campo Titolo del widget.

  6. (Facoltativo) Per modificare le voci di log recuperate, esegui una delle seguenti operazioni:

    • Per recuperare le voci di log da un progetto diverso o da più progetti, nella voce Project espandere Progetto attuale e completare . Il menu elenca tutti i progetti Google Cloud nell'ambito delle metriche attuale.

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

    • Per recuperare le voci di log incluse nelle visualizzazioni di log, procedi nel seguente modo: sui bucket di log, segui questi passaggi:

      1. Nella voce Ambito per, espandi Progetto, e seleziona Spazio di archiviazione.
      2. Nella voce Visualizzazioni spazio di archiviazione, espandi Progetto attuale e completa la finestra di dialogo. Il menu elenca le visualizzazioni dei log sui bucket di log in del tuo progetto Google Cloud. Per selezionare le visualizzazioni dei log nei 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 progetti incluse nell'attuale ambito delle metriche.

  7. (Facoltativo) Per limitare i log visualizzati dal widget del riquadro dei log, inserisci una query nel campo Editor di 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.

  8. (Facoltativo) Applica le variabili del modello al widget del riquadro dei log. Per ulteriori informazioni le informazioni, vedi Aggiungere filtri permanenti a una dashboard personalizzata.

  9. Per applicare le modifiche alla dashboard, nella barra degli strumenti fai clic su Applica. 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 del log recuperato che corrispondono anche alla tua query. Puoi anche usare il filtro del widget barra per modificare temporaneamente le voci di log visualizzate dal widget. Per ulteriori informazioni, consulta la sezione intitolata Filtra le voci di log.

Esempi di query

Per compilare il campo Editor di query, puoi inserire del testo nella oppure effettuare selezioni dai menu. L'editor di query utilizza lo stesso linguaggio di query del Esplora log. Per informazioni sulla risoluzione dei problemi, consulta 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 di un tipo di risorsa, ad esempio Risorsa controllata, oppure puoi 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.

    Questi passaggi aggiungono la seguente clausola all'editor di query campo:

    resource.type="audited_resource"

Analogamente, per aggiungere una query per gli audit log di Cloud Functions, seguenti:

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

  4. Fai clic su Applica.

    Questi passaggi aggiungono la seguente clausola all'editor di query campo:

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

Filtrare le voci di log

Puoi modificare le voci di log visualizzate dal 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 voci di log corrispondenti nell'intervallo specificato da questo campo.

  • Campo Filter (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 sessione corrente.

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

  • Query sul widget del riquadro dei log: viene visualizzato il widget del riquadro dei log solo le voci di log corrispondenti alla query. Se non specifichi una query, tutti i log dell'intervallo di tempo selezionato. Se specifichi una query, Nel widget del riquadro dei log viene visualizzata la dicitura 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 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 filtro della dashboard cluster_name: mycluster, la query aggiornato per includere resource.labels."cluster_name"="mycluster". Per ulteriori informazioni sui filtri della dashboard, consulta Aggiungere filtri temporanei e Aggiungi filtri permanenti.

Il resto di questa sezione fornisce ulteriori informazioni su come filtra 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 precedente all'intervallo di tempo selezionato.

Quando indaghi su un incidente, è consigliabile limitare a quelle voci che rientrano in un intervallo di tempo specifico. A le voci di log devono mostrare i log entro un intervallo di tempo fisso, esegui una delle seguenti operazioni o entrambe:

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

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

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

Quando monitori il debug di una situazione di errore, potresti volere solo per visualizzare i messaggi di errore e nascondere dalla visualizzazione 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 specifici livelli di gravità, esegui una o entrambe le seguenti operazioni:

  • Per applicare un filtro temporaneo, seleziona un valore per il menu Gravità in il widget del riquadro dei log. Questo menu specifica un livello di gravità minimo. Ad esempio, il valore "Avviso" restituisce voci di log con gravità "Errore" recuperate, ma quelle Voci di log con gravità "Avviso" non vengono recuperate. Per impostazione predefinita, il valore di questo campo è impostato su Default, che include tutti i log le voci corrispondenti.

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

  • Per applicare un filtro permanente, inserisci una clausola severity nella campo Editor query del riquadro di configurazione, e 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 visualizza le voci di log che non ti interessano. Ad esempio, per visualizzare le voci di log che includono un indirizzo email specifico, puoi filtrarlo 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 Filtro. Il test contiene non fa distinzione tra maiuscole e minuscole.

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

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

    • Ad esempio, se aggiungi i filtri Get, OR e Compute, registra vengono visualizzate le voci 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 e 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" 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 i 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 selezionate nel widget del riquadro dei log vengono applicate 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 un della query di Analisi dei log in una dashboard personalizzata. L'analisi dei log ti consente e aggregare log per generare insight utili mediante 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 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 Monitoraggio.

  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 e seleziona Analisi dei log.
  5. Nel riquadro Configura widget, configura i dati da visualizzare nel creando una query mediante SQL, quindi fai clic su Esegui query.

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

    Nel riquadro Display puoi modificare il tipo di grafico e personalizzare le righe e le colonne vengono rappresentate in un grafico modificando dimensione, misura suddivisione:

    • Dimensione: La dimensione deve essere una colonna con timestamp, numeri o stringhe. Per impostazione predefinita, la dimensione è impostata su la prima colonna basata su timestamp nello schema. Se nella query non è presente alcun timestamp, viene selezionata come dimensione la prima colonna. Puoi anche personalizzare il contenuto della dimensione nel riquadro Visualizzazione del grafico. Quando viene selezionata 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, deve anche selezionare la funzione di aggregazione affinché venga eseguita sui relativi valori raggruppati, 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, vedi 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 ulteriori informazioni, vedi 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 Error Reporting in una dashboard utilizzando 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 Monitoraggio.

  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. quindi seleziona il riquadro Error Reporting.
  5. Seleziona il progetto di cui vengono mostrati i gruppi di errori. espandi Progetti, poi effettua una selezione.
  6. (Facoltativo) Aggiorna il titolo.

  7. (Facoltativo) Per limitare le risorse per cui vengono visualizzati errori, procedi nel seguente modo:

    1. espandi Tutte le risorse e seleziona una risorsa.

    2. Dopo aver selezionato una risorsa, puoi selezionare Applica. In alternativa, puoi utilizza i menu aggiuntivi per perfezionare i criteri del filtro:

      • Per visualizzare gli errori per le risorse App Engine, seleziona Servizi GAE, quindi 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, nella barra degli strumenti fai clic su Applica. 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.

Risoluzione dei problemi

Passaggi successivi