Mostra gli eventi in una dashboard

Questo documento descrive come visualizzare gli eventi sui grafici di una dashboard. Un evento è un'attività, ad esempio un deployment o un arresto anomalo, che influisce sul funzionamento di un sistema. La visualizzazione degli eventi può aiutarti a correlare i dati provenienti da origini diverse quando stai risolvendo un problema.

Gli eventi vengono identificati eseguendo query sui log generati nel progetto Google Cloud, o con routing diretto al progetto Google Cloud, per tipi di eventi specifici. Non vengono eseguite query sui log di altri progetti Google Cloud, anche se sono archiviati in un bucket di log nel progetto Google Cloud attuale. Puoi utilizzare le query fornite in Esplora log e nei criteri di avviso basati su log. Per un elenco degli eventi e delle query corrispondenti, consulta la pagina Tipi di evento.

Se configuri una dashboard per visualizzare gli eventi, i grafici nelle tue dashboard vengono annotati nel momento in cui si verificano. I filtri della dashboard, che limitano i dati visualizzati da una dashboard, in genere filtrano sia i dati delle serie temporali sia gli eventi.

Lo screenshot seguente mostra un grafico che mostra un'annotazione, con la descrizione comando per l'annotazione attivata:

Grafico che mostra annotazioni di eventi informativi e di avviso.

Ogni annotazione può elencare più eventi. Nello screenshot precedente viene elencato un evento per un deployment GKE.

Prima di iniziare

Per ottenere le autorizzazioni necessarie per visualizzare grafici e log e per creare criteri di avviso, chiedi all'amministratore di concederti i seguenti ruoli IAM sul tuo progetto:

  • Visualizza i grafici e per visualizzare e creare criteri di avviso: Editor Monitoring (roles/monitoring.editor).
  • Visualizza tutti i log, tranne i log di accesso ai dati creati nel progetto Google Cloud: Visualizzatore log (roles/logging.viewer).
  • Visualizza i log degli accessi ai dati creati nel tuo progetto Google Cloud: Visualizzatore log privati (roles/logging.privateLogViewer).

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

Potresti anche essere in grado di ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Mostra eventi

Per un elenco di tipi di eventi, riferimenti per la risoluzione dei problemi e query che possono essere utilizzati con Esplora log o con criteri di avviso basati su log, consulta la pagina Tipi di eventi.

Console

Per mostrare gli eventi:

  1. Nel pannello di navigazione della console Google Cloud, seleziona Monitoring e poi  Dashboard:

    Vai a Dashboard

  2. Seleziona la dashboard che vuoi visualizzare.

  3. Nella barra degli strumenti della dashboard, assicurati che l'opzione Eventi sia attiva.

    Se il pulsante di attivazione/disattivazione Eventi non è visualizzato, significa che la dashboard non supporta la visualizzazione degli eventi.

  4. Per ogni tipo di evento da visualizzare, fai clic su Aggiungi evento nella barra degli strumenti della dashboard, poi seleziona il tipo di evento dal menu.

    Ad esempio, potresti configurare la dashboard in modo da visualizzare gli eventi "Deployment del carico di lavoro GKE".

    Dopo aver aggiunto un tipo di evento, Cloud Monitoring esegue una query sui dati dei log, il che richiede alcuni istanti, e poi aggiunge le annotazioni ai grafici nella dashboard:

    • Informazioni: un messaggio informativo.
    • Avviso: indica un errore, ad esempio un riavvio o un arresto anomalo.
    • Avviso: indica che è stato aperto un incidente.

  5. Per visualizzare il riepilogo di un evento o per accedere ai link ai log, utilizza il puntatore per attivare la descrizione comando.

Visualizzare i log per un evento

Quando visualizzi un grafico che mostra annotazioni di eventi, puoi accedere ai log associati agli eventi:

  • Per visualizzare i log per un evento specifico, utilizza il puntatore per attivare la descrizione comando di un'annotazione che elenca l'evento, vai all'evento e fai clic su Visualizza log.

  • Per visualizzare i log per tutti gli eventi identificati dall'annotazione, utilizza il puntatore per attivare la descrizione comando per l'annotazione, vai alla riga di riepilogo della descrizione comando e fai clic su Visualizza log.

In un'altra scheda del browser, Esplora log si apre con i parametri di query impostati per eseguire una query per l'evento specifico o per la raccolta di eventi.

Crea criteri di avviso

Per ricevere una notifica quando viene visualizzato un evento nei log, configura un avviso basato su log. I criteri di avviso basati su log eseguono query sui log non appena li ricevono. Quando la query restituisce un risultato non vuoto, viene creato un incidente e vengono inviate delle notifiche.

Console

Per creare un avviso basato su log:

  1. Se non hai configurato un canale di notifica, procedi nel seguente modo:

    1. Nel pannello di navigazione della console Google Cloud, seleziona Monitoring e poi  Avvisi:

      Vai ad Avvisi

    2. Fai clic su Modifica canale di notifica.
    3. Vai al tipo di canale di notifica che vuoi configurare, fai clic su Aggiungi nuovo, quindi completa la finestra di dialogo.

  2. Nel pannello di navigazione della console Google Cloud, seleziona Logging, quindi Esplora log:

    Vai a Esplora log

  3. Nella barra degli strumenti, seleziona Crea avviso.

  4. Inserisci un nome per il criterio di avviso e fai clic su Avanti.

  5. Nella sezione Definisci le voci di log per le quali inviare un avviso, inserisci una query o aggiorna la query copiata dal riquadro Query quando hai selezionato Crea avviso.

    Per ogni tipo di evento, nella pagina Tipi di evento viene elencata una query adatta all'utilizzo in un avviso basato su log.

  6. Completa la finestra di dialogo e fai clic su Salva.

Nascondi eventi

Console

Per nascondere tutti gli eventi, nella barra degli strumenti della dashboard assicurati che l'opzione Eventi sia disattivata.

Per nascondere un tipo di evento, imposta il pulsante di attivazione/disattivazione per quel tipo di evento su Off.

Passaggi successivi