Questo documento descrive diversi tipi di criteri di avviso basati sulle metriche e fornisce esempi JSON per questi criteri. I criteri di avviso definiscono le condizioni che monitorano tre elementi: alcune metriche che agiscono in qualche modo per un determinato periodo di tempo. Ad esempio, un criterio di avviso potrebbe attivarsi quando il valore di una metrica supera una soglia o quando il valore cambia troppo rapidamente.
Questi contenuti non si applicano ai criteri di avviso basati su log. Per informazioni sui criteri di avviso basati sui log, che ti informano quando un messaggio specifico viene visualizzato nei log, consulta Monitoraggio dei log.
Per informazioni sulla creazione dei criteri di avviso, consulta i seguenti documenti:
- Criteri di avviso con Monitoring Query Language (MQL)
- Criteri di avviso nell'API Cloud Monitoring
- Creare criteri di avviso basati su metriche con la console Google Cloud
Condizione di assenza di metriche
Una condizione di assenza di metriche viene attivata quando una serie temporale monitorata non contiene dati per una determinata finestra di durata.
Le condizioni di assenza di metriche richiedono almeno una misurazione riuscita, una che recupera i dati, entro la finestra della durata massima dopo l'installazione o la modifica del criterio. La durata massima configurabile è di 24 ore se utilizzi la console Google Cloud e di 24,5 ore se utilizzi l'API Cloud Monitoring.
Ad esempio, supponi di impostare una finestra di durata in un criterio di assenza metrica su 30 minuti. La condizione non si attiva quando il sottosistema che scrive i dati di metrica non ha mai scritto un punto dati. Il sottosistema deve produrre almeno un punto dati e poi non può generare altri punti dati per 30 minuti.
Condizione di soglia metrica
Una condizione di soglia metrica viene attivata quando i valori di una metrica sono superiori o inferiori alla soglia di una finestra di durata specifica. Ad esempio, una condizione di soglia metrica potrebbe attivarsi quando l'utilizzo della CPU è superiore all'80% per almeno 5 minuti.
Nella categoria delle condizioni di soglia metrica, esistono schemi che rientrano nelle sottocategorie generali:
Le condizioni del tasso di variazione si attivano quando i valori di una serie temporale aumentano o diminuiscono di una determinata percentuale o più durante un periodo di tempo.
Quando crei questo tipo di condizione, viene applicato un calcolo della percentuale di variazione alla serie temporale prima del confronto con la soglia.
La condizione calcola la media dei valori della metrica degli ultimi 10 minuti, quindi confronta il risultato con la media di 10 minuti misurata appena prima della finestra della durata. La finestra temporale di 10 minuti utilizzata da una frequenza di modifica della condizione è un valore fisso, non puoi modificarla. Tuttavia, devi specificare la finestra della durata quando crei una condizione.
Le condizioni di aggregazione di gruppi vengono attivate quando una metrica misurata in un gruppo di risorse supera una soglia per una finestra di durata.
Le condizioni di controllo di uptime si attivano quando un controllo di uptime non riesce a rispondere correttamente a una richiesta inviata da almeno due località geografiche.
Le condizioni di integrità del processo si attivano quando il numero di processi in esecuzione su un'istanza VM è superiore o inferiore a una soglia. Puoi anche configurare queste condizioni per monitorare un gruppo di istanze che corrispondono a una convenzione di denominazione.
Questo tipo di condizione richiede l'esecuzione dell'agente operativo o dell'agente Monitoring sulle risorse monitorate. Per ulteriori informazioni sugli agenti, vedi Agenti della suite operativa di Google Cloud.
Le condizioni delle metriche vengono attivate quando il rapporto di due metriche supera una soglia per una finestra di durata. Queste condizioni calcolano il rapporto di due metriche, ad esempio il rapporto tra le risposte HTTP di errore e tutte le risposte HTTP.
Per ulteriori informazioni sui criteri basati su rapporti, consulta Condizioni per gli avvisi relativi ai rapporti.
Condizione di previsione
Una condizione di previsione si attiva quando genera una previsione che la soglia verrà violata nella finestra di previsione futura. Una previsione prevede se una serie temporale violerà o meno una soglia all'interno di una finestra di previsione, ovvero un periodo di tempo futuro. La finestra di previsione può variare da 1 ora (3600 secondi) a 7 giorni (604.800 secondi).
Puoi utilizzare la previsione quando monitori la maggior parte delle metriche. Tuttavia, quando monitori una risorsa con restrizioni, ad esempio quota, spazio su disco o utilizzo della memoria, una condizione di previsione può avvisarti prima che la soglia venga violata. Questa funzionalità ti dà più tempo per rispondere a come viene consumata la risorsa vincolata prima che la soglia venga violata.
Per ogni serie temporale monitorata da una condizione di previsione, la condizione determina un algoritmo decisionale. Dopo l'addestramento, l'algoritmo genera una previsione ogni volta che viene valutata la condizione. Ogni previsione è una previsione che la relativa serie temporale violerà o non violerà la soglia nella finestra di previsione. Se una serie temporale monitorata ha una periodicità regolare, l'algoritmo decisionale per quella serie temporale incorpora il comportamento periodico nelle sue previsioni.
Una condizione di previsione può attivarsi quando si verifica una o entrambe le seguenti condizioni:
- Tutti i valori di una serie temporale durante una finestra di durata specifica violano la soglia.
- Tutte le previsioni per una serie temporale specifica e effettuate in una finestra temporale prevedono che la serie violerà la soglia al suo interno.
Il tempo di addestramento iniziale per un algoritmo decisionale è pari al doppio della finestra di previsione. Ad esempio, se la finestra di previsione è di un'ora, sono necessarie due ore di addestramento. L'algoritmo decisionale per ogni serie temporale viene addestrato in modo indipendente. Durante l'addestramento di un algoritmo decisionale, la sua serie temporale può attivare la condizione solo quando i valori della serie temporale violano la soglia per la finestra di durata specificata.
Una volta completato l'addestramento iniziale, ogni algoritmo decisionale viene addestrato continuamente utilizzando dati che si estendono fino a sei volte la durata della finestra di previsione. Ad esempio, quando la finestra di previsione è di un'ora, vengono utilizzate le ultime sei ore di dati durante l'addestramento continuo.
Quando configuri una condizione di previsione e i dati non vengono più inviati per più di 10 minuti, la previsione viene disattivata e la condizione funziona come una condizione di soglia metrica.
Il modo in cui vengono creati e gestiti gli incidenti per gli avvisi di previsione è lo stesso utilizzato per le condizioni delle metriche e delle intervalli di assenza. Gli incidenti vengono chiusi automaticamente quando la previsione prevede che la serie temporale non violerà la soglia nella finestra di previsione.
Limitazioni
- Devi configurare la condizione utilizzando i filtri di Monitoring. Se utilizzi l'interfaccia basata su menu della console Google Cloud, le tue selezioni vengono convertite in un filtro di Monitoring.
- Devi configurare un criterio di avviso utilizzando l'API Cloud Monitoring quando vuoi monitorare un rapporto di metriche. Per ulteriori informazioni, consulta Criteri di avviso nell'API Cloud Monitoring e Rapporto delle metriche.
- Non puoi configurare la condizione utilizzando Monitoring Query Language o PromQL.
- Sono supportate tutte le metriche con un tipo di valore doppio o int64, ad eccezione di quelle delle istanze VM Amazon.
Esempi
Sono disponibili esempi di ciascuno di questi tipi di norme:
| Tipo di condizione | Esempio JSON | console Google Cloud |
|---|---|---|
| Soglia delle metriche | View (Visualizzazione) | Istruzioni |
| Frequenza di modifica | View (Visualizzazione) | Istruzioni |
| Aggrega gruppo | View (Visualizzazione) | Istruzioni |
| Controllo di uptime | View (Visualizzazione) | Istruzioni |
| Integrità dei processi | View (Visualizzazione) | Istruzioni |
| Rapporto metrica | View (Visualizzazione) | Istruzioni |
| Previsione | View (Visualizzazione) | Istruzioni |
Passaggi successivi
- Per comprendere le variabili che incidono sugli avvisi, consulta Comportamento dei criteri di avviso basati su metriche.
- Per una serie di criteri di avviso, consulta i criteri di esempio.