Questo documento descrive come organizzare e assegnare la priorità ai tuoi incidenti assegnando etichette definite dall'utente. Queste etichette sono configurate sui criteri di avviso e sono elencate nei criteri e negli incidenti di avviso. A seconda della configurazione, le etichette sono elencate anche in alcune notifiche.
Informazioni sulle etichette
Le etichette, che sono coppie chiave-valore, vengono utilizzate per collegare informazioni a serie temporale, criterio di avviso, incidente o notifica. Ad esempio, le etichette su una serie temporale potrebbero identificare la specifica istanza di macchina virtuale (VM) da cui sono stati raccolti i dati. Le etichette possono essere definite dall'utente o predefinite.
Etichette definite dall'utente
Le etichette definite dall'utente contengono informazioni da te specificate. Queste etichette possono avere valori statici o dinamici:
Le etichette statiche definite dall'utente contengono valori che non possono essere modificati. Puoi creare etichette statiche definite dall'utente quando configuri un criterio di avviso utilizzando la console Google Cloud o l'API Cloud Monitoring. Per ulteriori informazioni, consulta i seguenti documenti:
Le etichette dinamiche definite dall'utente contengono valori che possono cambiare in base ai valori dei dati delle serie temporali. Puoi creare etichette dinamiche definite dall'utente quando configuri la condizione di un criterio di avviso con MQL. Per un esempio, consulta Esempio: aggiunta di etichette definite dall'utente con valori dinamici.
Le chiavi delle etichette devono iniziare con una lettera minuscola. Sia le chiavi che i valori delle etichette possono contenere solo lettere minuscole, numeri, trattini bassi e trattini.
Etichette predefinite
Le etichette predefinite sono incluse nei descrittori delle risorse; queste etichette devono essere compilate quando vengono scritti i dati delle serie temporali. Queste etichette mostrano informazioni sulla metrica raccolta o sulla risorsa su cui è scritta la metrica. Ad esempio, le etichette su una serie temporale potrebbero identificare una macchina virtuale (VM), una zona, un progetto Google Cloud e un tipo di dispositivo. Quando Monitoring crea un incidente basato su quella serie temporale, l'incidente eredita le etichette.
Come visualizzare le etichette
Puoi visualizzare le etichette di un criterio di avviso o di un incidente nella pagina dei dettagli di un incidente, nella pagina dei dettagli di un criterio di avviso e in alcune notifiche.
- Criteri di avviso: le etichette statiche definite dall'utente sono elencate nella sezione Etichette utente. Le etichette dinamiche definite dall'utente e le etichette predefinite non sono visibili.
- Incidenti: le etichette statiche definite dall'utente sono elencate nella sezione Etichette dei criteri, mentre le etichette dinamiche definite dall'utente sono elencate nella sezione Etichette delle metriche. Le etichette predefinite sono elencate nelle sezioni Etichette delle risorse monitorate ed Etichette delle metriche.
Notifiche: le etichette predefinite e quelle definite dall'utente sono elencate nei seguenti tipi di notifica:
- Google Chat
- PagerDuty
- Pub/Sub
- Webhook
Esempio: aggiungere etichette definite dall'utente con valori dinamici
Puoi utilizzare MQL per configurare un'etichetta in modo che il suo valore cambi dinamicamente in base ai dati delle serie temporali. Ad esempio, vuoi che gli incidenti abbiano un'etichetta criticality
il cui valore cambia a seconda del valore della metrica di utilizzo della CPU monitorata:
fetch gce_instance
| metric 'compute.googleapis.com/instance/cpu/utilization'
| group_by sliding(5m), [value_utilization_mean: mean(value.utilization)]
| map
add[
criticality:
if(val() >= 90 '%', 'CRITICAL',
if(val() >= 80 '%', 'WARNING',
if(val() >= 70 '%', 'INFO', 'GOOD')))
]
| condition val() >= 70 '%'
La figura seguente illustra in che modo i criteri di avviso che utilizzano le query MQL elaborano i dati delle serie temporali monitorati:
Il gestore dei criteri elabora i dati sull'utilizzo della CPU e restituisce una serie temporale che indica quando la condizione è soddisfatta. Nell'esempio precedente, la condizione è soddisfatta quando l'utilizzo della CPU è almeno del 70%. Per ogni serie temporale di input, il gestore dei criteri può generare una di quattro serie temporali:
Nome serie temporale di output | Condizione soddisfatta | Descrizione |
---|---|---|
"BUONO" | No | Questa serie temporale ha le stesse etichette della serie temporale di input. Non ha un'etichetta di gravità. |
"CRITICO" | Sì | L'utilizzo della CPU è almeno del 90%. La serie temporale di output ha le stesse etichette della serie temporale "BUONO" più un'etichetta di gravità con il valore "CRITICO". |
"AVVISO" | Sì | L'utilizzo della CPU è almeno dell'80% ma inferiore al 90%. La serie temporale di output ha le stesse etichette della serie temporale "BUONO" più un'etichetta di gravità con il valore "WARNING". |
"INFO" | Sì | L'utilizzo della CPU è almeno del 70% ma inferiore all'80%. La serie temporale di output ha le stesse etichette della serie temporale "BUONA" più un'etichetta di gravità con il valore "INFO". |
I dati delle serie temporali generati dal gestore dei criteri sono l'input del gestore degli incidenti, che determina quando vengono creati e chiusi gli incidenti.
Per determinare quando chiudere un incidente, il gestore degli incidenti utilizza i valori dei campi duration
, evaluationMissingData
e autoClose
.
Best practice
Per assicurarti che sia aperto al massimo un incidente alla volta quando crei etichette i cui valori sono impostati dinamicamente:
Nell'oggetto
MetricThreshold
, sostituisci i valori predefiniti per i seguenti campi:- Campo
duration
: impostato su un valore diverso da zero. - Campo
evaluationMissingData
: impostato in modo che gli incidenti vengano chiusi quando i dati non arrivano più. Quando utilizzi l'API Cloud Monitoring, imposta questo campo suEVALUATION_MISSING_DATA_INACTIVE
. Quando utilizzi la console Google Cloud, imposta il campo su "Punti dati mancanti trattati come valori che non violano la condizione del criterio".
- Campo
Nell'oggetto
AlertStrategy
, imposta il campoautoClose
sul valore minimo di 30 minuti. Quando utilizzi l'API Cloud Monitoring, imposta questo campo su30m
.
Per saperne di più, consulta Dati delle metriche parziali.
Flusso dell’incidente
Supponiamo che le misurazioni dell'utilizzo della CPU siano inferiori al 70% quando viene creato il criterio di avviso. La seguente sequenza illustra come vengono aperti e chiusi gli incidenti:
Poiché le misurazioni dell'utilizzo della CPU sono inferiori al 70%, il gestore dei criteri genera la serie temporale "BUONO" e non vengono aperti incidenti.
Supponiamo che l'utilizzo della CPU aumenti fino al 93%. Il gestore dei criteri interrompe la generazione dei dati delle serie temporali "BUONO" e inizia a generare dati per la serie temporale "CRITICAL".
Il gestore incidenti vede una nuova serie temporale "CRITICA" che soddisfa la condizione e apre un incidente. La notifica include l'etichetta di gravità con un valore
CRITICAL
.Supponiamo che l'utilizzo della CPU scenda al 75%. Il gestore dei criteri interrompe la generazione della serie temporale "CRITICAL" e inizia a generare la serie temporale "INFO".
Il gestore incidenti vede una nuova serie temporale "INFO" che soddisfa la condizione e apre un incidente. La notifica include l'etichetta di gravità con un valore
INFO
.Il gestore incidenti vede che non sono in arrivo dati per la serie temporale "CRITICA" e che per quella serie temporale è aperto un incidente. Poiché il criterio è configurato per chiudere gli incidenti quando i dati non arrivano, il gestore degli incidenti chiude l'incidente associato alla serie temporale "CRITICAL". Di conseguenza, rimane aperto solo l'incidente la cui etichetta di gravità ha un valore
INFO
.Infine, supponiamo che l'utilizzo della CPU scenda al 45%. Questo valore è inferiore a tutte le soglie, quindi il gestore dei criteri smette di generare la serie temporale "INFO" e inizia a generare la serie temporale "GOOD".
Il gestore incidenti vede che non sono in arrivo dati per la serie temporale "INFO" e che è aperto un incidente per quella serie temporale. Poiché il criterio utilizza le impostazioni consigliate, l'incidente viene chiuso.
Se non utilizzi il valore consigliato per il campo evaluationMissingData
, all'interruzione dei dati, gli incidenti aperti non vengono chiusi immediatamente.
Il risultato è che potresti vedere più incidenti aperti per la stessa serie temporale di input. Per saperne di più, consulta Dati delle metriche parziali.
Passaggi successivi
- Crea criteri di avviso utilizzando l'API Monitoring
- Criteri di avviso con MQL
- Gestione di dati parziali delle metriche