Mostrare gli eventi in una dashboard

Questo documento descrive come configurare un dashboard per mostrare le annotazioni degli eventi. Un evento è un'attività, ad esempio 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 di diverse origini durante la risoluzione di un problema.

Questa funzionalità è supportata solo per i progetti Google Cloud . Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione della cartella app.

Informazioni sulle annotazioni degli eventi

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

A meno che tu non utilizzi l'API Cloud Monitoring o intraprenda un'azione per salvare le selezioni del tipo di evento, le selezioni si applicano solo alla sessione corrente. Quando utilizzi la console Google Cloud , il blocco delle selezioni le salva.

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

Tipi di eventi consigliati

Potresti visualizzare i seguenti tipi di eventi attivati in una dashboard o in una scheda Osservabilità, anche se non hai selezionato alcun tipo di evento:

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

Quando un tipo di evento viene aggiunto automaticamente, è un tipo di evento consigliato. Puoi lasciare questi tipi di eventi nello stato consigliato, salvarli nel file JSON della dashboard o ignorarli, il che rimuove il consiglio. Per determinare quali tipi di eventi vengono salvati, espandi il menu Annotazioni e poi visualizza la sezione Fissate.

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 sono identificati da Monitoring. Gli eventi di avviso forniscono informazioni su quando sono stati aperti gli incidenti.

• Gli eventi Personalized Service Health vengono identificati dalle query che Monitoring invia 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 attraverso i sink di Cloud Logging nel tuo progetto Google Cloud . Queste voci di log includono quelle generate dal tuo progetto e quelle indirizzate al tuo 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 eventi.

Come vengono visualizzati gli eventi

Per tutti gli eventi, man mano che si verificano, i grafici nella dashboard vengono annotati. Gli eventi identificati analizzando le voci di log vengono visualizzati con un unico riferimento temporale. Al contrario, gli eventi di Service Health vengono visualizzati con un orario di inizio e poi 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 riporta 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 Service Health, chip che mostrano il numero di prodotti e località interessati. Per visualizzare l'elenco dei prodotti o delle località interessate, posiziona il puntatore sul chip corrispondente.
• Un pulsante Visualizza, che, se selezionato, apre una pagina con maggiori informazioni sull'evento. Ad esempio, potrebbe aprire Logs Explorer, in modo da poter visualizzare le voci di log, oppure potrebbe aprire la pagina dei dettagli per un evento di Service Health.

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

Prima di iniziare

Completa i seguenti passaggi per il progetto Google Cloud in cui vuoi visualizzare gli eventi nelle dashboard:

• Per ottenere le autorizzazioni necessarie per visualizzare e mostrare gli eventi nelle dashboard e per creare policy 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 di accesso non ai dati create nel tuo progetto Google Cloud : Logs Viewer (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 di Service Health: Visualizzatore di Personalized Service Health (roles/servicehealth.viewer)

  Per ulteriori informazioni sulla concessione dei ruoli, consulta Gestisci 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 tua dashboard, abilita l'API Service Health:

  Enable the API

Mostra eventi

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

Configurare le dashboard per mostrare gli eventi

Questa sezione descrive come configurare i dashboard elencati 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 Esplora log o con le policy di avviso basate 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": []
    }
  ]
}

Configurare 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 i dati di log e delle metriche.

Visualizzare 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 è determinata dal tipo di evento. Ad esempio, per un evento di controllo di uptime, questo pulsante apre la dashboard del 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 attraverso i sink di Cloud Logging nel tuo progetto Google Cloud , puoi ricevere una notifica quando si verificano questi eventi 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