Questo documento descrive come utilizzare la console Google Cloud per creare avvisi basati su metriche criterio che invia notifiche quando i valori di una metrica sono superiori o inferiori alla soglia per una finestra di test specifica. Ad esempio, la condizione di un criterio di avviso potrebbe essere soddisfatto quando l'utilizzo della CPU è superiore all'80% per almeno cinque minuti.
Questo contenuto non si applica ai criteri di avviso basati su log. Per informazioni sui criteri di avviso basati su log, che ti informano quando viene un determinato messaggio viene visualizzato nei log, Monitoraggio dei log.
In questo documento non vengono descritte le seguenti informazioni:
- Come ricevere una notifica quando non arrivano più dati. Per ulteriori informazioni, consulta Creare criteri di avviso per l'assenza di metriche.
- Come ricevere notifiche in base al valore previsto di una metrica. Per maggiori informazioni le informazioni, vedi Crea criteri di avviso relativi al valore della metrica previsti.
Come creare un criterio di avviso utilizzando l'API Cloud Monitoring. Per maggiori informazioni le informazioni, vedi Crea criteri di avviso utilizzando l'API.
Come creare un criterio di avviso la cui condizione include un Query MQL (Monitoring Query Language). Questi criteri possono utilizzare un modello soglia. Per ulteriori informazioni, consulta i seguenti documenti:
Prima di iniziare
-
Per ottenere le autorizzazioni necessarie per creare e modificare i criteri di avviso utilizzando la console Google Cloud, chiedi all'amministratore di concederti Ruolo IAM Editor Monitoring (
roles/monitoring.editor
) per il progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.Potresti anche riuscire a ottenere le autorizzazioni richieste tramite la ruoli o altri ruoli predefiniti ruoli.
Per ulteriori informazioni sui ruoli di Cloud Monitoring, consulta Controllare l'accesso con Identity and Access Management.
Assicurati di acquisire familiarità con i concetti generali dei criteri di avviso. Per informazioni su questi argomenti, consulta Panoramica degli avvisi.
Configura i canali di notifica che vuoi utilizzare per ricevere notifiche. Per motivi di ridondanza, ti consigliamo di creare diversi tipi di canali di notifica. Per ulteriori informazioni, vedi Creare e gestire i canali di notifica.
Crea criterio di avviso
Per creare un criterio di avviso che metta a confronto il valore di quella metrica con un soglia, procedi nel seguente modo:
-
Nella console Google Cloud, vai alla notifications Pagina Avvisi:
Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoraggio.
- Seleziona Crea criterio.
Seleziona le serie temporali da monitorare:
Fai clic su Seleziona una metrica, spostati tra i menu per selezionare una metrica tipo di risorsa e tipo di metrica, poi fai clic su Applica.
Il menu Seleziona una metrica contiene funzionalità che ti aiutano a trovare i tipi di metriche disponibili:
- Per trovare un tipo di metrica specifico, utilizza la
filter_list Barra dei filtri.
Ad esempio, se inserisci
util
, limiti il menu a mostra le voci che includonoutil
. Le voci vengono mostrate una volta superate "contiene" senza distinzione tra maiuscole e minuscole test.
- Per visualizzare tutti i tipi di metriche, anche quelle senza dati, fai clic su Metrica non elencata nel menu. attivo. Per impostazione predefinita, i menu mostrano solo tipi di metriche con dati. Per ulteriori informazioni, vedi
Puoi monitorare qualsiasi metrica integrata o qualsiasi in un file di dati.
- Per trovare un tipo di metrica specifico, utilizza la
filter_list Barra dei filtri.
Ad esempio, se inserisci
(Facoltativo) Per monitorare un sottoinsieme delle serie temporali che corrisponde alla i tipi di metriche e risorse selezionati nel passaggio precedente, Fai clic su Aggiungi filtro. Nella finestra di dialogo del filtro, seleziona l'etichetta per da filtrare, un comparatore e il valore del filtro. Ad esempio, il filtro
zone =~ ^us.*.a$
utilizza un'espressione regolare per corrisponde a tutti i dati delle serie temporali il cui nome zona inizia conus
e termina cona
. Per ulteriori informazioni, vedi Filtra le serie temporali selezionate.(Facoltativo) Per modificare l'allineamento dei punti di una serie temporale: Nella sezione Trasforma dati, imposta la finestra temporale continua e Funzione finestra temporale continua.
Se stai monitorando una metrica basata su log, ti consigliamo di utilizzare Il menu Finestra temporale continua è impostato su almeno dieci minuti.
Questi campi specificano come vengono combinati. Ad esempio, supponiamo che la finestra sia di 15 minuti e funzione finestra è
max
. Il punto allineato è il valore massimo di tutte punti negli ultimi 15 minuti. Per ulteriori informazioni, vedi Allineamento: regolarizzazione all'interno della serie.Puoi anche monitorare la frequenza con cui cambia il valore di una metrica Utilizzando il campo Funzione finestra temporale continua per variare percentuale. Per ulteriori informazioni, consulta l'articolo Monitorare il tasso di variazione.
(Facoltativo) Combina le serie temporali quando vuoi ridurre il numero di di serie temporali monitorate da un criterio o una raccolta di serie temporali. Ad esempio, invece di monitorare CPU per ogni istanza VM, ti consigliamo di calcolare media dell'utilizzo della CPU per tutte le VM in una zona, quindi per monitorare la media. Per impostazione predefinita, le serie temporali non vengono combinate. Per informazioni generali, vedi Riduzione: combinazione di serie temporali.
Per combinare tutte le serie temporali:
- Nella sezione Tra serie temporali, fai clic su expand_more Espandi.
- Imposta il campo Aggregazione serie temporali su un valore diverso da
none
. Ad esempio, per visualizzare il valore medio serie temporale, selezionamean
. - Assicurati che il campo Raggruppa per serie temporali sia vuoto.
Per combinare o raggruppare le serie temporali in base ai valori delle etichette:
- Nella sezione Tra serie temporali, fai clic su expand_more Espandi.
- Imposta il campo Aggregazione serie temporali su un valore diverso da
none
. - Nel campo Raggruppa serie temporali per, seleziona le etichette. in base al quale raggruppare.
Ad esempio, se raggruppi i dati in base all'etichetta
zone
e poi imposti il valore campo di aggregazione sul valoremean
, il grafico mostra una serie temporale per ogni zona per la quale esistono dati. La serie temporali mostrata per un fuso specifico è la media di tutte le serie temporali con quella zona.Fai clic su Avanti.
Configura l'attivatore di condizione:
Lascia il campo Tipo di condizione sul valore predefinito di Soglia.
(Facoltativo) Aggiorna il menu Attivatore avviso, che ha i seguenti valori:
Qualsiasi violazione di serie temporali: impostazione predefinita. Qualsiasi serie temporale violazione della soglia per l'intera finestra di test del test fa sì che la condizione sia soddisfatta.
Percentuale di serie temporali in violazione: una percentuale di serie temporali. Deve violare la soglia per l'intera finestra di test del test prima che la condizione sia soddisfatta. Ad esempio: potresti ricevere una notifica se il 50% delle serie temporali monitorate viola la soglia per l'intera finestra di test.
Numero di serie temporali violate: un numero specifico di serie temporali. Deve violare la soglia per l'intera finestra di test del test prima che la condizione sia soddisfatta. Per Ad esempio, potresti ricevere una notifica quando 32 dei le serie temporali violano la soglia per l'intera finestra di ripetizione del test.
Violazione di tutte le serie temporali. Tutte le serie temporali devono violare le soglia per l'intera finestra del test prima che la condizione sia soddisfatta.
Per informazioni sugli intervalli per allineare e misurare i dati delle serie temporali, consulta Periodi di allineamento e test delle finestre di test.
Inserisci quando il valore di una metrica viola la soglia utilizzando la Campi Posizione soglia e Valore soglia. Ad esempio: Se imposti questi valori su Sopra la soglia e
0.3
, una misurazione superiore a0.3
viola la soglia.(Facoltativo) Per selezionare per quanto tempo le misurazioni devono violare la soglia prima che Monitoring invii una notifica, espandi Opzioni avanzate, quindi utilizza il menu Finestra di nuovo test.
Il valore predefinito è Nessun nuovo test. Con questa impostazione, una singola la misurazione può generare una notifica. Per ulteriori informazioni e vedi un esempio Impostazioni relative al periodo e alla durata di allineamento.
(Facoltativo) Per specificare in che modo Monitoring valuta i quando i dati non arrivano più, espandi Opzioni avanzate e utilizzare Dati mancanti nella valutazione. o dal menu Fogli Google.
Il menu Dati mancanti nella valutazione è disabilitato quando il valore dell'attributo La finestra di test è Nessun nuovo test.
Console Google Cloud
"Valutazione dei dati mancanti" campoRiepilogo Dettagli Dati mancanti vuoti Gli incidenti aperti rimangono aperti.
I nuovi incidenti non vengono aperti.Per le condizioni soddisfatte, la condizione continua a essere soddisfatti quando i dati non arrivano più. Se un incidente è aperto per questa condizione, l'incidente rimane aperto. Quando un incidente è aperto e non ci sono dati arriva, il timer di chiusura automatica si avvia dopo un ritardo di almeno 15 minuti. Se il timer scade, l'incidente viene chiuso.
Per le condizioni non soddisfatte, la condizione continua a non vengano soddisfatti quando i dati non arrivano più.
Punti dati mancanti trattati come valori che violano la condizione delle norme Gli incidenti aperti rimangono aperti.
È possibile aprire nuovi incidenti.Per le condizioni soddisfatte, la condizione continua a essere soddisfatti quando i dati non arrivano più. Se un incidente è aperto per questa condizione, l'incidente rimane aperto. Quando un incidente è aperto e non arrivano dati per la durata della chiusura automatica più 24 ore, l'incidente è chiuso.
In caso di condizioni non soddisfatte, questa impostazione determina soglia metrica affinché si comporti come una
metric-absence condition
. Se i dati non arrivano nel tempo specificato dalla finestra di ripetizione, la condizione viene valutata come soddisfatta. Per un criterio di avviso con una condizione, la condizione è soddisfatta comporta l'apertura di un incidente.Punti dati mancanti trattati come valori che non violano la condizione delle norme Gli incidenti aperti sono chiusi.
I nuovi incidenti non vengono aperti.Per condizioni soddisfatte, la condizione non viene più soddisfatta quando non arrivano più. Se un incidente è aperto per questa condizione, allora l'incidente è chiuso.
Per le condizioni non soddisfatte, la condizione continua a non vengano soddisfatti quando i dati non arrivano più.
Fai clic su Avanti.
(Facoltativo) Crea un criterio di avviso con più condizioni.
La maggior parte dei criteri monitora un singolo tipo di metrica. Ad esempio, un criterio potrebbe il numero di byte scritti su un'istanza VM. Quando vuoi per monitorare più tipi di metriche, crea un criterio con più condizioni. Ogni condizione monitora un tipo di metrica. Dopo aver creato le condizioni, devi specificare come vengono combinate le condizioni. Per informazioni, vedi Norme con più condizioni.
Per creare un criterio di avviso con più condizioni:
- Per ogni condizione aggiuntiva, fai clic su Aggiungi condizione di avviso e poi a configurare la condizione.
- Fai clic su Avanti e configura il modo in cui vengono combinate le condizioni.
- Fai clic su Avanti per passare alle notifiche e alla documentazione configurazione.
Configura le notifiche:
Espandi il menu Notifiche e nome e seleziona la notifica. i canali di notifica. Per motivi di ridondanza, ti consigliamo di aggiungere criterio di avviso più tipi di canali di notifica. Per saperne di più, vedi Gestire i canali di notifica.
(Facoltativo) Per ricevere una notifica alla chiusura di un incidente, seleziona Notifica di chiusura dell'incidente. Per impostazione predefinita, quando crei un criterio di avviso con Console Google Cloud, viene inviata una notifica solo quando si verifica un incidente è stato creato.
(Facoltativo) Per modificare il tempo di attesa prima di Monitoring per chiudere un incidente al termine dell'arrivo dei dati, seleziona un'opzione dalla Menu Durata chiusura automatica incidente. Per impostazione predefinita, quando i dati non arrivano più, Monitoring attende sette giorni prima di chiudere una segnalazione aperta.
Seleziona un'opzione dal menu Livello di gravità dei criteri. Incidenti e le notifiche mostrano il livello di gravità.
(Facoltativo) Per aggiungere etichette personalizzate al criterio di avviso, nella sezione Criteri per le etichette utente, segui questi passaggi:
- Fai clic su Aggiungi etichetta e nel campo Chiave inserisci un nome per la
dell'etichetta. I nomi delle etichette devono iniziare con una lettera minuscola
contenere lettere minuscole, numeri, trattini bassi e trattini.
Ad esempio, inserisci
severity
. - Fai clic su Valore e inserisci un valore per l'etichetta. I valori dell'etichetta possono
contenere lettere minuscole, numeri, trattini bassi e trattini.
Ad esempio, inserisci
critical
.
Per informazioni su come utilizzare le etichette delle norme per la gestione le notifiche, vedi Annota gli incidenti con le etichette.
- Fai clic su Aggiungi etichetta e nel campo Chiave inserisci un nome per la
dell'etichetta. I nomi delle etichette devono iniziare con una lettera minuscola
contenere lettere minuscole, numeri, trattini bassi e trattini.
Ad esempio, inserisci
(Facoltativo) Nella sezione Documentazione, inserisci i contenuti che vuoi incluso nella notifica.
Per formattare la documentazione, puoi usare testo normale, Markdown e variabili. Puoi anche includere link per aiutare gli utenti a eseguire il debug dell'incidente, ad esempio come link a playbook interni, dashboard di Google Cloud e pagine. Ad esempio, il seguente modello di documentazione descrive incidente di utilizzo per una risorsa
gce_instance
e include diverse variabili per fare riferimento al criterio di avviso e alla condizione REST Google Cloud. Il modello di documentazione poi indirizza i lettori a pagine esterne per aiutarli con il debug.Quando vengono create le notifiche, Monitoring sostituisce le variabili della documentazione con i relativi valori. I valori sostituiscono le variabili solo nelle notifiche. La riquadro di anteprima e da altre posizioni nella console Google Cloud mostra solo la formattazione Markdown.
Anteprima
## CPU utilization exceeded ### Summary The ${metric.display_name} of the ${resource.type} ${resource.label.instance_id} in the project ${resource.project} has exceeded 90% for over 15 minutes. ### Additional resource information Condition resource name: ${condition.name} Alerting policy resource name: ${policy.name} ### Troubleshooting and Debug References Repository with debug scripts: example.com Internal troubleshooting guide: example.com ${resource.type} dashboard: example.com
Formatta nella notifica
Per ulteriori informazioni, vedi Annota le notifiche con la documentazione definita dall'utente e Utilizzare i controlli del canale.
Fai clic su Nome avviso e inserisci un nome per il criterio di avviso.
Fai clic su Crea criterio.
Filtra le serie temporali selezionate
I filtri assicurano che solo le serie temporali che soddisfano una serie di criteri vengano monitorati. Quando applichi filtri, potresti ridurre il numero di linee nel grafico, per migliorare le prestazioni del grafico. Puoi anche ridurre di dati da monitorare applicando l'aggregazione. I filtri assicurano che vengano utilizzate solo le serie temporali che soddisfano una serie di criteri. Quando applichi i filtri, ci sono meno serie temporali da valutare, il che può a migliorare le prestazioni dell'avviso.
Un filtro è composto da un'etichetta, un comparatore e un valore. Ad esempio:
per trovare corrispondenze di tutte le serie temporali la cui etichetta zone
inizia con "us-central1"
,
potresti usare il filtro zone=~"us-central1.*"
, che utilizza un'espressione regolare
per eseguire il confronto.
Quando filtri in base all'ID progetto o al container di risorse,
devi utilizzare l'operatore uguale, (=)
. Quando filtri in base a
altre etichette, puoi utilizzare qualsiasi comparatore supportato.
In genere, puoi filtrare le metriche e le etichette delle risorse,
gruppo di risorse.
Quando fornisci più criteri di filtro, vengono monitorate solo le serie temporali che soddisfano tutti i criteri.
Per aggiungere un filtro, fai clic su Aggiungi filtro, completa la finestra di dialogo e fai clic su Fine. Nella finestra di dialogo, utilizzi il campo Filtro per selezionare i criterio in base al quale filtrare, selezionare l'operatore di confronto e poi seleziona il valore. Ogni riga nella tabella seguente elenca un operatore di confronto, il relativo significato e un esempio:
Operatore | Significato | Esempio |
---|---|---|
= |
Uguaglianza | resource.labels.zone = "us-central1-a" |
!= |
Disequazione | resource.labels.zone != "us-central1-a" |
=~ |
Uguaglianza espressione regolare2 | monitoring.regex.full_match("^us.*") |
!=~ |
Disuguaglianza dell'espressione regolare2 | monitoring.regex.full_match("^us.*") |
starts_with |
Il valore inizia con | resource.labels.zone = starts_with("us") |
ends_with |
Il valore termina con | resource.labels.zone = ends_with("b") |
has_substring |
Il valore contiene | resource.labels.zone = has_substring("east") |
one_of |
Una tra | resource.labels.zone = one_of("asia-east1-b", "europe-north1-a") |
!starts_with |
Il valore non inizia con | resource.labels.zone != starts_with("us") |
!ends_with |
Il valore non termina con | resource.labels.zone != ends_with("b") |
!has_substring |
Il valore non contiene | resource.labels.zone != has_substring("east") |
!one_of |
Il valore non rientra tra | resource.labels.zone != one_of("asia-east1-b", "europe-north1-a") |
Risoluzione dei problemi
Questa sezione contiene suggerimenti per la risoluzione dei problemi.
Metrica non elencata nel menu delle metriche disponibili
Per monitorare una metrica non elencata nel menu Seleziona una metrica, procedi nel seguente modo: uno dei seguenti:
Per creare un criterio di avviso che monitori una metrica Google Cloud, espandi il menu Seleziona una metrica e poi fai clic su
Attiva. Quando questa opzione è disattivata, il menu elenca tutte le metriche per servizi Google Cloud e tutte le metriche con dati.Per configurare una condizione per un tipo di metrica personalizzata prima di quella metrica genera dati, devi specificare il tipo di metrica utilizzando un Filtro di monitoraggio:
- Seleziona ? sull'intestazione della sezione Seleziona metrica e poi seleziona Modalità di filtro diretto nella descrizione comando.
Inserisci un filtro di monitoraggio o un selettore di serie temporali. Per informazioni sulla sintassi, consulta i seguenti documenti:
Monitorare un tasso di variazione
Per monitorare la variazione del valore di una metrica, imposta il valore Funzione finestra temporale continua su variazione percentuale. Quando la condizione viene valutata, Monitoring calcola tasso di variazione della metrica come percentuale e poi confronta in base alla soglia della condizione. Questa procedura di confronto prevede due passaggi:
- Se la serie temporale ha un tipo di metrica
DELTA
oCUMULATIVE
: la serie temporale viene convertita in una serie con tipo di metricaGAUGE
. Per informazioni sui conversione, consulta Tipi, tipi e conversioni. - Monitoring calcola la percentuale modificata confrontando il valore medio nell'ultima finestra scorrevole di 10 minuti valore medio della finestra scorrevole di 10 minuti prima dell'inizio il periodo di allineamento.
Non puoi modificare la finestra scorrevole di 10 minuti utilizzata per i confronti in un criterio di avviso relativo al tasso di variazione. Tuttavia, devi specificare il periodo di allineamento quando crei la condizione.
Passaggi successivi
- Per creare un criterio che metta a confronto il valore di una serie temporale con uno devi usare MQL. Per ulteriori informazioni, consulta Creare livelli di gravità dinamica utilizzando MQL.
Le istruzioni riportate in questa pagina si applicano a qualsiasi criterio di avviso. Le seguenti documenti forniscono indicazioni per configurazioni specifiche: