Incidenti per i criteri di avviso basati su metriche

Un incidente è un record di quando vengono soddisfatte le condizioni di un criterio di avviso. Se un criterio di avviso contiene più condizioni, il criterio di avviso specifica se il soddisfacimento di una condizione è sufficiente per causare la creazione di un incidente. In genere, quando le condizioni sono soddisfatte, Cloud Monitoring apre un incidente e invia una notifica. Tuttavia, gli incidenti non vengono creati nelle seguenti circostanze:

Per ogni incidente, Monitoring crea una pagina Dettagli incidente che ti consente di gestire l'incidente e che riporta le informazioni sull'incidente che possono aiutarti a risolvere il problema. Ad esempio, la pagina Dettagli incidente mostra la cronologia dell'incidente e un grafico che mostra i dati delle metriche monitorate. Puoi anche trovare link a incidenti ed voci di log correlati.

Questo documento descrive come trovare gli incident. Descrive inoltre come utilizzare la pagina Dettagli incidente per gestire gli incidenti per le policy di avviso basate su metriche, che valutano i dati delle serie temporali archiviati da Cloud Monitoring.

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.

Prima di iniziare

Per ottenere le autorizzazioni necessarie per visualizzare e gestire gli incidenti utilizzando la console Google Cloud , chiedi all'amministratore di concederti i seguenti ruoli IAM sul progetto:

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.

Per saperne di più sui ruoli Cloud Monitoring, consulta Controllare l'accesso con Identity and Access Management.

Trovare incidenti

Per visualizzare un elenco di incidenti nel tuo progetto Google Cloud :

  1. Nella Google Cloud console, vai alla pagina  Avvisi:

    Vai ad Avvisi

    Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.

  2. Nella barra degli strumenti della console Google Cloud , seleziona il tuo progetto Google Cloud . Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione della cartella app.

    La pagina Avvisi mostra informazioni su policy di avviso, posticipi e incidenti:

    • Il riquadro Riepilogo elenca il numero di incidenti aperti.
    • Il riquadro Incidenti mostra gli incidenti aperti più recenti. Per elencare gli incidenti più recenti nella tabella, inclusi quelli chiusi, fai clic su Mostra incidenti chiusi.

  3. Per visualizzare i dettagli di un incidente specifico, selezionalo nell'elenco.

    Viene visualizzata la pagina Dettagli incidente. Per saperne di più sulla pagina Dettagli dell'incidente, consulta la sezione Esaminare un incidente di questa pagina.

Trovare incidenti meno recenti

Il riquadro Incidenti nella pagina Avvisi mostra gli incidenti aperti più recenti. Per trovare gli incidenti meno recenti, esegui una delle seguenti operazioni:

  • Per scorrere le voci nella tabella Incidenti, fai clic su  Più recenti o  Meno recenti.

  • Per accedere alla pagina Incidenti, fai clic su Visualizza tutti gli incidenti. Nella pagina Incidenti puoi eseguire tutte le seguenti operazioni:

    • Mostra incidenti chiusi: per elencare tutti gli incidenti nella tabella, fai clic su Mostra incidenti chiusi.
    • Filtra incidenti: per informazioni sull'aggiunta di filtri, consulta Filtra incidenti.
    • Conferma o chiudi un incidente oppure posticipa il criterio di avviso. Per accedere a queste opzioni, fai clic su  Altre opzioni nella riga dell'incidente e seleziona un'opzione dal menu. Per saperne di più, consulta Gestire gli incidenti.

Filtra incidenti

Quando inserisci un valore nella barra dei filtri, nella tabella Incidenti vengono elencati solo gli incidenti che corrispondono al filtro. Se aggiungi più filtri, un incidente viene visualizzato solo se soddisfa tutti i filtri.

Per aggiungere un filtro alla tabella degli incidenti:

  1. Nella pagina Incidenti, fai clic su  Filtra tabella e poi seleziona una proprietà filtro. Le proprietà di filtro includono tutte le seguenti:

    • Stato dell'incidente
    • Nome del criterio di avviso
    • Quando è stato aperto o chiuso l'incidente
    • Tipo di metrica
    • Tipo di risorsa

  2. Seleziona un valore dal menu secondario o inseriscine uno nella barra dei filtri.

    Ad esempio, se selezioni Tipo di metrica e inserisci usage_time, potresti visualizzare solo le seguenti opzioni nel menu secondario:

    agent.googleapis.com/cpu/usage_time
compute.googleapis.com/guest/container/cpu/usage_time
container.googleapis.com/container/cpu/usage_time

Indagare su un incidente

La pagina Dettagli incidente contiene informazioni che possono aiutarti a identificare la causa di un incidente.

Esplora i dati delle metriche

Per analizzare lo stato della metrica prima e dopo l'incidente, utilizza il grafico Metriche di avviso. Questo grafico mostra una cronologia e le serie temporali che hanno soddisfatto la condizione della tuacriterio di avvisoo.

Puoi regolare l'intervallo della sequenza temporale per cercare tendenze e pattern nei dati delle metriche relativi all'incidente:

  • Per alternare la visualizzazione delle sole serie temporali che hanno soddisfatto la condizione e la visualizzazione di tutte le serie temporali valutate dalla condizione, fai clic su Mostra tutte le serie temporali.

  • Per modificare l'intervallo di tempo visualizzato dal grafico, puoi utilizzare il selettore dell'intervallo di tempo nella barra degli strumenti o evidenziare gli intervalli di tempo sul grafico con il puntatore.

Puoi anche analizzare i dati delle metriche in modo più dettagliato visualizzandoli in Esplora metriche. Per farlo, vai al grafico Metriche di avviso e fai clic su Esplora dati. Per impostazione predefinita, Metrics Explorer aggrega e filtra i dati delle metriche in modo che il grafico delle metriche sia allineato alla serie temporale mostrata nella cronologia di Metriche avviso.

Esplora le voci di log

Il riquadro Log nella pagina Dettagli dell'incidente mostra le voci di log che corrispondono al tipo di risorsa e alle etichette della risorsa monitorata per la metrica. Puoi analizzare queste voci di log per trovare ulteriori informazioni che potrebbero aiutarti a risolvere il tuo incidente.

  • Per visualizzare le voci di log in Esplora log, fai clic su Visualizza in Esplora log, quindi seleziona un progetto di definizione dell'ambito. Esplora log fornisce strumenti aggiuntivi per analizzare i dati voce di log, come una cronologia della creazione delle voci di log correlate.
  • Per visualizzare e modificare la query utilizzata per filtrare le voci di log in Metrics Explorer, fai clic su Esplora dati.

Visualizzare le informazioni dell'applicazione

Per le policy di avviso associate a un'applicazione App Hub, vai alla sezione Associata all'applicazione. Una voce in questa sezione elenca l'ID applicazione e i link a una dashboard che mostra informazioni sull'applicazione. La seconda voce elenca un workload o un servizio e rimanda a una dashboard.

Visualizza informazioni supplementari

La sezione Etichette mostra le etichette e i valori per la risorsa monitorata e la metrica della serie temporale che ha causato l'incidente, nonché le etichette utente definite nel criterio di avviso. Queste informazioni potrebbero aiutarti a identificare la risorsa monitorata specifica che ha causato l'incidente. Per saperne di più, consulta Annotare gli incident con etichette.

La sezione Documentazione mostra il modello di documentazione per le notifiche che hai fornito durante la creazione della criterio di avviso. Queste informazioni potrebbero includere una descrizione di ciò che monitora la norma di avviso e suggerimenti per la mitigazione. Per saperne di più, consulta la sezione Annotare le notifiche con la documentazione definita dall'utente.

Se non hai configurato la documentazione per la tua criterio di avviso, il riquadro Documentazione mostra il messaggio "Nessuna documentazione configurata".

Per aiutarti a scoprire i problemi sottostanti nella tua applicazione, puoi esplorare gli incidenti correlati ad altre condizionicriterio di avvisoo.

La sezione Incidenti correlati mostra un elenco di incidenti che corrispondono a uno dei seguenti criteri:

  • L'incidente è stato creato quando è stata soddisfatta una condizione dello stesso criterio di avviso.
  • L'incidente condivide un'etichetta con l'incidente mostrato nella pagina Dettagli incidente.

Gestire gli incidenti

Gli incidenti si trovano in uno dei seguenti stati:

  •  Aperto: Il set di condizioni del criterio di avviso è soddisfatto o non sono presenti dati che indicano che la condizione non è più soddisfatta. Se un criterio di avviso contiene più condizioni, gli incidenti vengono aperti a seconda di come vengono combinate queste condizioni. Per ulteriori informazioni, consulta Policy con più condizioni.

  •  Confermato: L'incidente è aperto ed è stato contrassegnato manualmente come confermato. In genere, questo stato indica che l'incidente è in fase di indagine.

  •  Chiuso: Il sistema ha rilevato che la condizione non è più soddisfatta, hai chiuso l'incidente o sono trascorsi 7 giorni senza che sia stato rilevato che la condizione continua a essere soddisfatta.

Quando configuri un criterio di avviso, assicurati che lo stato stazionario fornisca un segnale quando tutto va bene. Ciò è necessario per garantire che lo stato senza errori possa essere identificato e, se un incidente è aperto, per la chiusura dell'incidente. Se non è presente alcun segnale che indichi che una condizione di errore è terminata, dopo l'apertura di un incidente, questo rimane aperto per 7 giorni dopo l'attivazione della criterio di avviso.

Ad esempio, se crei un criterio di avviso che ti invia una notifica quando il conteggio degli errori è maggiore di 0, assicurati che produca un conteggio di 0 errori quando non ce ne sono. Se la criterio di avviso restituisce null o un valore vuoto nello stato senza errori, non è presente alcun segnale che indichi quando gli errori sono terminati. In alcune situazioni, Monitoring Query Language (MQL) supporta la possibilità di specificare un valore predefinito da utilizzare quando non è disponibile alcun valore misurato. Per un esempio, vedi Rapporto di utilizzo.

Confermare gli incidenti

Ti consigliamo di contrassegnare un incidente come riconosciuto quando inizi a indagare sulla causa dell'incidente.

Per contrassegnare un incidente come riconosciuto:

  1. Nel riquadro Incidenti della pagina Avvisi, fai clic su Visualizza tutti gli incidenti.

  2. Nella pagina Incidenti, individua l'incidente che vuoi confermare e poi esegui una delle seguenti operazioni:

    • Fai clic su  Altre opzioni e poi seleziona Conferma.
    • Apri la pagina dei dettagli dell'incidente e fai clic su Conferma incidente.

Se la tua criterio di avviso è configurata per inviare notifiche ripetute, il riconoscimento di un incidente non interrompe le notifiche. Per interromperli, procedi in uno dei seguenti modi:

  • Crea una sospensione per il criterio di avviso.
  • Disattiva il criterio di avviso.

Posticipare un criterio di avviso

Per impedire a Monitoring di creare incidenti e inviare notifiche durante un periodo di tempo specifico, posticipa il criterio di avviso correlato. Quando posticipi un criterio di avviso, Monitoring chiude anche tutti gli incidenti correlati al criterio di avviso.

Per creare una sospensione per un incidente che stai visualizzando:

  1. Nella pagina Dettagli incidente, fai clic su Posticipa policy.

  2. Seleziona la durata del posticipo. Dopo aver selezionato la durata del posticipo, questo inizia immediatamente.

Puoi anche posticipare una criterio di avviso dalla pagina Incidenti individuando l'incidente che vuoi posticipare, facendo clic su  Altre opzioni e selezionando Posticipa. Puoi posticipare le policy di avviso durante le interruzioni per evitare ulteriori notifiche durante la procedura di risoluzione dei problemi.

Chiudi incidenti

Puoi lasciare che Monitoring chiuda un incidente per te oppure puoi chiuderlo dopo che le osservazioni smettono di arrivare. Se chiudi un incidente e poi arrivano dati che indicano che la condizione è soddisfatta, viene creato un nuovo incidente. Quando chiudi un incidente, questa azione non chiude altri incidenti aperti per la stessa condizione. Se posticipi un criterio di avviso, gli incidenti aperti vengono chiusi all'inizio del posticipo.

Il monitoraggio chiude automaticamente un incidente quando si verifica uno dei seguenti eventi:

  • Condizioni di soglia metrica:

    • Arriva un'osservazione che indica che la soglia non è stata superata.

    • Non arrivano osservazioni, la condizione è configurata per chiudere gli incident quando le osservazioni smettono di arrivare e lo stato della risorsa sottostante è sconosciuto o non è disattivato.

    • Non arrivano osservazioni per la durata di chiusura automatica della policy di avviso e la condizione non è configurata per chiudere automaticamente gli incident quando le osservazioni smettono di arrivare. Per configurare la durata di chiusura automatica, puoi utilizzare la console Google Cloud o l'API Cloud Monitoring. Per impostazione predefinita, la durata della chiusura automatica è di sette giorni. La durata minima di chiusura automatica è di 30 minuti.

  • Condizioni di assenza metrica:

    • Si verifica un'osservazione.
    • Non vengono ricevute osservazioni per 24 ore dopo la scadenza della durata di chiusura automatica del criterio di avviso. Per configurare la durata della chiusura automatica, puoi utilizzare la console Google Cloud o l'API Cloud Monitoring. Per impostazione predefinita, la durata della chiusura automatica è di sette giorni.

  • Condizioni di previsione:

    • Viene prodotta una previsione che indica che la serie temporale non supererà la soglia entro la finestra di previsione.

    • Non arrivano osservazioni per 10 minuti, la condizione è configurata per chiudere gli incidenti quando le osservazioni smettono di arrivare e lo stato della risorsa sottostante è sconosciuto o non è disattivato.

    • Non arrivano osservazioni per la durata di chiusura automatica della policy di avviso e la condizione non è configurata per chiudere automaticamente gli incident quando le osservazioni smettono di arrivare.

Ad esempio, un criterio di avviso ha generato un incidente perché la latenza della risposta HTTP è stata superiore a 2 secondi per 10 minuti consecutivi. Se la misurazione successiva della latenza della risposta HTTP è inferiore o uguale a due secondi, l'incidente viene chiuso. Allo stesso modo, se non vengono ricevuti dati per sette giorni, l'incidente viene chiuso.

Per chiudere un incidente:

  1. Nel riquadro Incidenti della pagina Avvisi, fai clic su Visualizza tutti gli incidenti.

  2. Nella pagina Incidenti, individua l'incidente che vuoi chiudere, quindi esegui una delle seguenti operazioni:

    • Fai clic su  Visualizza altro e poi seleziona Chiudi incidente.
    • Apri la pagina Dettagli incidente per l'incidente e poi fai clic su Chiudi incidente.

Se visualizzi il messaggio Unable to close incident with active conditions, l'incidente non può essere chiuso perché sono stati ricevuti dati entro il periodo di avviso più recente.

Se visualizzi il messaggio Unable to close incident. Please try again in a few minutes., la richiesta non è stata chiusa a causa di un errore interno.

Conservazione e limiti dei dati

Per informazioni sui limiti e sul periodo di conservazione degli incidenti, vedi Limiti per gli avvisi.

Passaggi successivi