Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Creazione di regole di avviso gestite da Grafana
Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 9.x di Grafana.
Per le aree di lavoro Grafana che supportano la versione 10.x di Grafana, vedere. Funzionamento nella versione 10 di Grafana
Per le aree di lavoro Grafana che supportano la versione 8.x di Grafana, vedere. Funzionamento in Grafana versione 8
Grafana consente di creare regole di avviso che interrogano una o più fonti di dati, riducono o trasformano i risultati e li confrontano tra loro o con soglie fisse. Quando queste vengono eseguite, Grafana invia notifiche al punto di contatto.
Per aggiungere una regola gestita Grafana
-
Dalla console Grafana, nel menu Grafana, scegli l'icona Avvisi (campanella) per aprire la pagina Avvisi che elenca gli avvisi esistenti.
-
Scegli Nuova regola di avviso.
-
Nel passaggio 1, aggiungi il nome, il tipo e la posizione di archiviazione della regola, come segue:
-
In Nome regola, aggiungi un nome descrittivo. Questo nome viene visualizzato nell'elenco delle regole di avviso. È anche l'
alertnameetichetta per ogni istanza di avviso creata da questa regola. -
Dal menu a discesa Tipo di regola, seleziona Avviso gestito Grafana.
-
Dal menu a discesa Cartella, seleziona la cartella in cui desideri archiviare la regola. Se non si seleziona una cartella, la regola viene memorizzata nella
Generalcartella. Per creare una cartella, seleziona il menu a discesa e inserisci un nuovo nome per la cartella.
-
-
Nel passaggio 2, aggiungi le interrogazioni e le espressioni da valutare.
-
Mantieni il nome predefinito o passa il mouse sopra e scegli l'icona di modifica per modificare il nome.
-
Per le query, seleziona una fonte di dati dal menu a discesa.
-
Aggiungi una o più domande o espressioni.
-
Per ogni espressione, seleziona una condizione classica per creare una singola regola di avviso oppure scegli tra le opzioni Math, Reduce e Resample per generare avvisi separati per ogni serie. Per i dettagli su queste opzioni, consulta. Regole singole e multidimensionali
-
Scegli Esegui interrogazioni per verificare che l'interrogazione abbia esito positivo.
-
-
Nel passaggio 3, aggiungi le condizioni.
-
Dal menu a discesa Condizione, seleziona la query o l'espressione per avviare la regola di avviso.
-
Per Evaluate every, specificate la frequenza di valutazione. Deve essere un multiplo di 10 secondi. Ad esempio,
1m,30s. -
Per Evaluate for, specifica la durata per la quale la condizione deve essere vera prima che venga avviato un avviso.
Nota
Dopo che una condizione viene violata, l'avviso entra in
Pendingstato. Se la condizione rimane violata per la durata specificata, l'avviso passa allo stato.FiringSe non viene più soddisfatto, viene ripristinato lo stato.Normal -
In Configura nessun dato e gestione degli errori, configura il comportamento di avviso in assenza di dati. Utilizza le linee guida contenute in. Nessuna gestione di dati o casi di errore
-
Scegli Anteprima avvisi per verificare il risultato dell'esecuzione della query in questo momento. L'anteprima non esclude dati e condizioni di gestione degli errori.
-
-
Nel passaggio 4, aggiungi ulteriori metadati associati alla regola.
-
Aggiungi una descrizione e un riepilogo per personalizzare i messaggi di avviso. Utilizza le linee guida inEtichette e annotazioni.
-
Aggiungi l'URL del Runbook, il pannello, la dashboard e gli ID degli avvisi.
-
Aggiungi etichette personalizzate.
-
-
Scegli Salva per salvare la regola o Salva ed esci per salvare la regola e tornare alla pagina Avvisi.
Dopo aver creato la regola, puoi creare una notifica per la regola. Per ulteriori informazioni sulle notifiche, consultare Gestisci le notifiche di avviso.
Regole singole e multidimensionali
Per le regole di avviso gestite da Grafana, puoi creare una regola con una condizione classica oppure puoi creare una regola multidimensionale.
Regola monodimensionale (condizione classica)
Utilizza un'espressione di condizione classica per creare una regola che avvia un singolo avviso quando viene soddisfatta la relativa condizione. Per una query che restituisce più serie, Grafana non tiene traccia dello stato di avviso di ciascuna serie. Di conseguenza, Grafana invia un solo avviso anche quando le condizioni di allarme sono soddisfatte per più serie.
Per ulteriori informazioni su come formattare le espressioni, consulta Espressioni
Regola multidimensionale
Per generare un'istanza di avviso separata per ogni serie restituita nella query, create una regola multidimensionale.
Nota
Ogni istanza di avviso generata da una regola multidimensionale viene conteggiata ai fini della quota totale di avvisi. Le regole non vengono valutate quando si raggiunge la quota di avvisi. Per ulteriori informazioni sulle quote per le regole multidimensionali, vedere. Errori relativi alla quota raggiunta
Per creare più istanze da una singola regola MathReduce, usa o Resample espressioni per creare una regola multidimensionale. Ad esempio, puoi:
-
Aggiungi un'
Reduceespressione per ogni query per aggregare i valori nell'intervallo di tempo selezionato in un unico valore. (Non necessario per le regole che utilizzano dati numerici). -
Aggiungi un'
Mathespressione con la condizione per la regola. Ciò non è necessario nel caso in cui una query o un'espressione di riduzione restituisca già 0 se la regola non deve avviare un avviso o un numero positivo se deve avviare un avviso.Alcuni esempi:
-
$B > 70se deve avviare un avviso nel caso in cui il valore della query/espressione B sia superiore a 70. -
$B < $C * 100nel caso in cui debba avviare un avviso se il valore di B è inferiore al valore di C moltiplicato per 100. Se le query confrontate contengono più serie nei risultati, le serie di query diverse vengono abbinate se hanno le stesse etichette o una è un sottoinsieme dell'altra.
-
Nota
Grafana non supporta le interrogazioni di avviso con variabili modello. Ulteriori informazioni sono disponibili nella pagina della community Le variabili di modello non sono supportate nelle query di avviso durante la configurazione
Considerazioni sulle prestazioni per le regole multidimensionali
Ogni istanza di avviso viene conteggiata ai fini della quota di avvisi. Le regole multidimensionali che creano più istanze di quelle che possono essere inserite all'interno della quota di avvisi non vengono valutate e restituiscono un errore di quota. Per ulteriori informazioni, consulta Errori relativi alla quota raggiunta.
Gli avvisi multidimensionali possono avere un forte impatto sulle prestazioni del tuo spazio di lavoro Grafana, nonché sulle prestazioni delle tue fonti di dati, poiché Grafana le interroga per valutare le tue regole di avviso. Le seguenti considerazioni possono essere utili per ottimizzare le prestazioni del sistema di monitoraggio.
-
Frequenza di valutazione delle regole: la proprietà Evaluate Every di una regola di avviso controlla la frequenza di valutazione delle regole. Si consiglia di utilizzare la frequenza di valutazione più bassa accettabile.
-
Cardinalità del set di risultati: il numero di istanze di avviso create con una regola ne influisce sulle prestazioni. Supponiamo che stiate monitorando gli errori di risposta delle API per ogni percorso API, su ogni macchina virtuale del vostro parco macchine. Questo set ha una cardinalità del numero di percorsi moltiplicato per il numero di macchine virtuali. È possibile ridurre la cardinalità del set di risultati, ad esempio, monitorando gli errori totali per macchina virtuale anziché per percorso per macchina virtuale.
-
Complessità della query: le interrogazioni che le fonti di dati possono elaborare e a cui rispondere rapidamente consumano meno risorse. Sebbene questa considerazione sia meno importante delle altre considerazioni sopra elencate, se le hai ridotte il più possibile, l'analisi delle prestazioni delle singole query potrebbe fare la differenza. È inoltre necessario essere consapevoli dell'impatto sulle prestazioni che la valutazione di queste regole ha sulle fonti di dati. Le query di avviso sono spesso la maggior parte delle query gestite dai database di monitoraggio, quindi anche gli stessi fattori di carico che influiscono sull'istanza Grafana influiscono su di esse.
Errori relativi alla quota raggiunta
Esiste una quota per il numero di istanze di avviso che è possibile avere all'interno di un singolo spazio di lavoro. Quando raggiungi quel numero, non puoi più creare nuove regole di avviso in quell'area di lavoro. Con gli avvisi multidimensionali, il numero di istanze di avviso può variare nel tempo.
È importante ricordare quanto segue quando si lavora con le istanze di avviso.
-
Se si creano solo regole monodimensionali, ogni regola è una singola istanza di avviso. È possibile creare lo stesso numero di regole in un unico spazio di lavoro pari alla quota dell'istanza di avviso e non di più.
-
Le regole multidimensionali creano più istanze di avviso, tuttavia il numero non è noto finché non vengono valutate. Ad esempio, se crei una regola di avviso che tiene traccia dell'utilizzo della CPU delle tue istanze Amazon EC2, potrebbero esserci 50 istanze EC2 al momento della creazione (e quindi 50 istanze di avviso), ma se aggiungi altre 10 istanze EC2 una settimana dopo, la valutazione successiva ha 60 istanze di avviso.
Il numero di istanze di avviso viene valutato quando si crea un avviso multidimensionale e non è possibile crearne uno che superi immediatamente la quota di istanze di avviso. Poiché il numero di istanze di avviso può cambiare, la quota viene verificata ogni volta che vengono valutate le regole.
-
Al momento della valutazione della regola, se una regola comporta il superamento della quota prevista per le istanze di avviso, tale regola non viene valutata finché non viene effettuato un aggiornamento della regola di avviso che porta il numero totale di istanze di avviso al di sotto della quota di servizio. Quando ciò accade, si riceve una notifica di avviso che informa che la quota è stata raggiunta (la notifica utilizza la politica di notifica per la regola in fase di valutazione). La notifica include un'
Errorannotazione con il valore.QuotaReachedError -
Una regola che causa un
QuotaReachedErrorarresto nella valutazione. La valutazione viene ripresa solo quando viene effettuato un aggiornamento e la valutazione successiva all'aggiornamento non causa di per sé un.QuotaReachedErrorUna regola che non viene valutata mostra l'errore Quota raggiunta nella console Grafana. -
È possibile ridurre il numero di istanze di avviso rimuovendo le regole di avviso o modificando gli avvisi multidimensionali per avere meno istanze di avviso (ad esempio, inserendo un avviso sugli errori per macchina virtuale anziché un avviso di errore per API in una macchina virtuale).
-
Per riprendere le valutazioni, aggiorna l'avviso e salvalo. È possibile aggiornarlo per ridurre il numero di istanze di avviso oppure, se sono state apportate altre modifiche per ridurre il numero di istanze di avviso, è possibile salvarlo senza modifiche. Se può essere ripreso, lo è. Se ne causa un altro
QuotaReachedError, non puoi salvarlo. -
Quando un avviso viene salvato e riprende la valutazione senza superare la quota di avvisi, l'errore Quota raggiunta può continuare a essere visualizzato nella console Grafana per qualche tempo (fino all'intervallo di valutazione), tuttavia, la valutazione della regola di avviso inizia e gli avvisi vengono inviati se viene raggiunta la soglia della regola.
-
Per i dettagli sulla quota di avvisi e su altre quote, vedi. Quote del servizio Amazon Managed Grafana
Nessuna gestione di dati o casi di errore
Scegliete le opzioni su come gestire il comportamento di avviso in assenza di dati o in caso di errori.
Le opzioni per la gestione dell'assenza di dati sono elencate nella tabella seguente.
| Opzione No Data | Comportamento |
|---|---|
|
Nessun dato |
Crea un avviso |
|
Avviso |
Imposta lo stato della regola di avviso su. |
|
OK |
Imposta lo stato della regola di avviso su |
Le opzioni per la gestione dei casi di errore sono elencate nella tabella seguente.
| Opzione di errore o timeout | Comportamento |
|---|---|
|
Avviso |
Imposta lo stato della regola di avviso su |
|
OK |
Imposta lo stato della regola di avviso su |
|
Errore |
Crea un avviso |
