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:
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:
-
Editor di Monitoring (
roles/monitoring.editor
) sul tuo progetto. -
Visualizzatore Logging (
roles/logging.viewer
) su ogni progetto di cui vuoi visualizzare le voci di log. Questo ruolo non ti concede l'accesso a tutte le voce di log. Per ulteriori informazioni sui ruoli, consulta Controllo dell'accesso di Cloud Logging con IAM. -
Funzione di accesso alla visualizzazione dei log (
roles/logging.viewAccessor
) su ogni progetto in cui è archiviato il bucket di log per una visualizzazione del log a cui vuoi accedere. Il ruolo Funzione di accesso alla visualizzazione dei log concede l'accesso a tutte le visualizzazioni dei log archiviate dal progetto. Per informazioni su come ottenere l'accesso a visualizzazioni di log specifiche, vedi Controllare l'accesso a una visualizzazione di log.
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:
-
Nella console Google Cloud, vai alla pagina Dashboard
:
Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoraggio.
- Seleziona una dashboard o fai clic su Crea dashboard.
- Fai clic su add Aggiungi widget nella barra degli strumenti.
- Nella finestra di dialogo Add widget, seleziona
Log.
- (Facoltativo) Per aggiornare il titolo, inserisci quello nuovo nella casella Campo Titolo del widget.
(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 arrow_drop_down 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:
- Nella voce Ambito per, espandi arrow_drop_down Progetto, e seleziona Spazio di archiviazione.
- Nella voce Visualizzazioni spazio di archiviazione, espandi arrow_drop_down 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 add_circle Importa progetto, seleziona un progetto, quindi seleziona una o più visualizzazioni di log. Puoi importare solo progetti incluse nell'attuale ambito delle metriche.
(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.
(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.
Per applicare le modifiche alla dashboard, nella barra degli strumenti fai clic su Applica. Per ignorare le modifiche, fai clic su Annulla.
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:
- Espandi il menu Risorsa.
- Cerca e seleziona Risorsa controllata.
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:
- Espandi il menu Risorsa.
- Cerca e seleziona Risorsa controllata.
- Nel menu dei servizi, seleziona Cloud Functions.
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 filter_list 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 operatoreOR
:Ad esempio, se aggiungi i filtri
Get
eCompute
, le voci di log che contengono entrambe le parole.Ad esempio, se aggiungi i filtri
Get
,OR
eCompute
, registra vengono visualizzate le voci contenentiGet
oCompute
.
Il valore del campo Filtro filter_list 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 clausolajsonPayload.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:
- Nel widget del riquadro dei log, seleziona Visualizza in Esplora log.
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.
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:
-
Nella console Google Cloud, vai alla pagina Dashboard
:
Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoraggio.
- Seleziona una dashboard o fai clic su Crea dashboard.
- Fai clic su add Aggiungi widget nella barra degli strumenti.
- Nella finestra di dialogo Aggiungi widget, vai alla sezione Dati e e seleziona Analisi dei log.
- Nel riquadro Configura widget, configura i dati da visualizzare nel creando una query mediante SQL, quindi fai clic su Esegui query.
(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
epercentile-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.
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:
-
Nella console Google Cloud, vai alla pagina Dashboard
:
Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoraggio.
- Seleziona una dashboard o fai clic su Crea dashboard.
- Fai clic su add Aggiungi widget nella barra degli strumenti.
- Nella finestra di dialogo Aggiungi widget, vai alla sezione Visualizzazione. quindi seleziona il riquadro Error Reporting.
- Seleziona il progetto di cui vengono mostrati i gruppi di errori. espandi arrow_drop_down Progetti, poi effettua una selezione.
- (Facoltativo) Aggiorna il titolo.
(Facoltativo) Per limitare le risorse per cui vengono visualizzati errori, procedi nel seguente modo:
- espandi arrow_drop_down Tutte le risorse e seleziona una risorsa.
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.
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:
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
- Nel riquadro dei log viene visualizzato il messaggio "Nessuna voce trovata" messaggio
Passaggi successivi
Per informazioni su come Cloud Monitoring offre visibilità sulle metriche e log archiviati in più progetti Google Cloud, consulta Panoramica degli ambiti delle metriche.
Per informazioni su come configurare una dashboard per visualizzare i log o gli errori utilizzando l'API, consulta le seguenti risorse:
Per scoprire di più sui gruppi di errori, consulta Panoramica di Error Reporting.