Mostrare gli eventi in una dashboard

Questo documento descrive come configurare una dashboard per mostrare le annotazioni degli eventi. Un evento è un'attività, come un deployment o un arresto anomalo, che influisce sul funzionamento di un sistema. La visualizzazione delle annotazioni degli eventi può aiutarti a correlare i dati provenienti da origini diverse durante la risoluzione di un problema.

Informazioni sulle annotazioni degli eventi

Puoi mostrare gli eventi nella maggior parte delle dashboard elencate nella pagina Dashboard della console Google Cloud. Analogamente, puoi configurare alcune schede Osservabilità specifiche per i servizi, come quelle per Compute Engine e Google Kubernetes Engine, per mostrare gli eventi. Per configurare i tipi di eventi visualizzati da una dashboard o da una scheda Osservabilità, puoi utilizzare la console Google Cloud. Per le dashboard che crei, classificate come personalizzate, puoi anche utilizzare l'API Cloud Monitoring.

A meno che non utilizzi l'API Cloud Monitoring o non intraprendi un'azione per salvare le tue selezione di tipi di eventi, le selezioni si applicano solo alla sessione corrente. Quando utilizzi la console Google Cloud, le selezioni vengono bloccate e salvate.

Per un elenco dei tipi di eventi, riferimenti per la risoluzione dei problemi e altre informazioni, consulta la pagina Tipi di eventi.

Tipi di eventi consigliati

Potresti vedere i seguenti tipi di eventi abilitati in una dashboard o in una scheda Osservabilità, anche se non ne hai selezionato nessuno:

• Avviso aperto.
• Incidente di Personalized Service Health, quando l'API Service Health è abilitata.
• Per ogni tipo di risorsa con i dati mostrati nella dashboard, un tipo di evento.

Quando un tipo di evento viene aggiunto automaticamente, si tratta di un tipo di evento consigliato. Puoi lasciare questi tipi di eventi nello stato consigliato, salvarli nel file JSON della dashboard o ignorarli, rimuovendo il consiglio. Per determinare i tipi di eventi salvati, espandi il menu Annotazioni e visualizza la sezione Fissati.

Come vengono identificati gli eventi

Le dashboard eseguono query su diverse origini dati per identificare gli eventi da mostrare nella dashboard:

• Gli eventi di avviso vengono identificati dal monitoraggio. Gli eventi di avviso forniscono informazioni su quando sono stati aperti gli incidenti.

• Gli eventi Personalized Service Health vengono identificati dalle query inviate da Monitoring all'API Service Health. Questi eventi indicano quando si verifica un'interruzione in un servizio Google Cloud.

• Tutti gli altri tipi di eventi vengono identificati analizzando le voci di log che passano per gli sink di Cloud Logging nel progetto Google Cloud. Queste voci di log includono quelle generate dal progetto e quelle instradate al progetto. Per ricevere una notifica quando si verifica uno di questi eventi, puoi creare un criterio di avviso basato su log. Nel criterio di avviso, utilizza le query fornite nella pagina Tipi di evento.

Come vengono visualizzati gli eventi

Per tutti gli eventi, man mano che si verificano, i grafici della dashboard vengono annotati. Gli eventi identificati analizzando le voci di log vengono visualizzati con un unico riferimento temporale. Al contrario, gli eventi Service Health vengono mostrati con una data di inizio e lo sfondo del grafico viene modificato per la durata dell'evento. Questi eventi mostrano anche un'icona a forma di cuore.

Lo screenshot seguente mostra un grafico che indica diversi eventi identificati analizzando le voci di log e un evento Service Health:

Come mostrato nello screenshot precedente, la descrizione comando di un evento include informazioni come le seguenti:

• Nome dell'evento.
• Data e ora di inizio dell'evento.
• Per gli eventi relativi allo stato del servizio, chip che mostrano il numero di prodotti e località interessati. Per elencare i prodotti o le località interessati, posiziona il cursore sul chip corrispondente.
• Un pulsante Visualizza che, se selezionato, apre una pagina con ulteriori informazioni sull'evento. Ad esempio, potrebbe aprire Logs Explorer per consentirti di visualizzare le voci di log oppure la pagina dei dettagli di un evento di Service Health.

I filtri della dashboard, che limitano i dati mostrati da una dashboard, tipicamente filtrano sia i dati delle serie temporali sia gli eventi.

Prima di iniziare

• Per ottenere le autorizzazioni necessarie per visualizzare e mostrare gli eventi nelle dashboard e per creare criteri di avviso, chiedi all'amministratore di concederti i seguenti ruoli IAM nel progetto:

  • Visualizza e crea dashboard e criteri di avviso: Monitoring Editor (roles/monitoring.editor).
  • Visualizza e mostra gli eventi identificati dalle voci di log non di accesso ai dati create nel tuo progetto Google Cloud: Visualizzatore dei log (roles/logging.viewer).
  • Visualizza e mostra gli eventi identificati da qualsiasi voce di log creata nel tuo progetto Google Cloud: Private Logs Viewer (roles/logging.privateLogViewer).
  • Visualizza gli eventi relativi allo stato del servizio: Visualizzatore di Personalized Service Health (roles/servicehealth.viewer)

  Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.

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

• Se vuoi mostrare gli eventi di Service Health nella dashboard, abilita l'API Service Health:

  Enable the API

Mostra eventi

Questa sezione descrive come configurare una dashboard o una scheda Osservabilità per mostrare gli eventi.

Configurare le dashboard per mostrare gli eventi

Questa sezione descrive come configurare le dashboard elencate nella pagina Dashboard della console Google Cloud per mostrare gli eventi.

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

"annotations": {
  "defaultResourceNames": [],
  "eventAnnotations": [
    {
      "displayName": "",
      "enabled": true,
      "eventType": "GKE_CLUSTER_UPDATE",
      "filter": "resource.labels.cluster_name=my-cluster",
      "resourceNames": []
    }
  ]
}

Configura la scheda Osservabilità per mostrare gli eventi

Questa sezione descrive come configurare la scheda Osservabilità per mostrare gli eventi. Alcuni servizi, come Compute Engine e Google Kubernetes Engine, forniscono una scheda Osservabilità che mostra dati metrici e di log.

Visualizza i dettagli dell'evento

Quando visualizzi un grafico che mostra le annotazioni degli eventi, puoi utilizzare i link forniti nella descrizione comando per accedere a ulteriori informazioni.

Per accedere ai dettagli di un evento specifico, fai clic su Visualizza.

La pagina della console Google Cloud aperta dal pulsante Visualizza dipende dal tipo di evento. Ad esempio, per un evento di controllo di uptime, questo pulsante apre la dashboard per il controllo di uptime. Per un tipo di evento diverso, potrebbe aprirsi Esplora log.

Crea criteri di avviso

Quando gli eventi vengono identificati analizzando le voci di log che passano per gli sink di Cloud Logging nel progetto Google Cloud, puoi ricevere una notifica quando si verificano configurando un avviso basato su log. I criteri di avviso basati su log eseguono query sulle voci di log man mano che vengono ricevute. Quando la query restituisce un risultato non vuoto, viene creato un incidente e vengono inviate notifiche.

Nascondi eventi

Passaggi successivi

• Condividere una dashboard personalizzata
• Esplorare i dati dei grafici
• Accedere alle dashboard specifiche per le risorse
• Aggiungere filtri temporanei alle dashboard personalizzate
• Aggiungere filtri permanenti alle dashboard personalizzate