Configura le regole di avviso gestite da Grafana - Grafana gestito da Amazon

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à.

Configura le regole di avviso gestite da Grafana

Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.

Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. Lavorare nella versione 9 di Grafana

Per le aree di lavoro Grafana che supportano la versione 8.x di Grafana, vedere. Funzionamento in Grafana versione 8

Le regole gestite da Grafana sono il tipo di regola di avviso più flessibile. Ti consentono di creare avvisi che possono agire sui dati provenienti da qualsiasi delle nostre fonti di dati supportate. Oltre a supportare più fonti di dati, puoi anche aggiungere espressioni per trasformare i dati e impostare condizioni di avviso. È supportato anche l'utilizzo di immagini nelle notifiche di avviso. Questo è l'unico tipo di regola che consente di inviare avvisi da più fonti di dati in un'unica definizione di regola.

È possibile creare più istanze di avviso come risultato di un'unica regola di avviso (nota anche come avviso multidimensionale).

Le regole di avviso gestite da Grafana possono essere modificate o eliminate solo dagli utenti con autorizzazioni di modifica per la cartella in cui sono archiviate le regole.

Se elimini una risorsa di avviso creata nell'interfaccia utente, non puoi più recuperarla. Per eseguire un backup della configurazione e poter ripristinare le risorse di avviso eliminate, crea le risorse di avviso utilizzando Terraform o Alerting. API

Nelle seguenti procedure, esamineremo il processo di creazione delle regole di avviso gestite da Grafana.

Per creare una regola di avviso gestita da Grafana, utilizza il flusso di creazione degli avvisi in-workspace e segui questi passaggi per aiutarti.

Imposta il nome della regola di avviso

  1. Scegli Avvisi -> Regole di avviso -> + Nuova regola di avviso.

  2. Inserisci un nome per identificare la tua regola di avviso.

    Questo nome viene visualizzato nell'elenco delle regole di avviso. È anche l'alertnameetichetta per ogni istanza di avviso creata da questa regola.

Quindi, definisci una query per ottenere i dati che desideri misurare e una condizione da soddisfare prima che venga attivata una regola di avviso.

Per definire l'interrogazione e la condizione

  1. Seleziona una fonte di dati.

  2. Dal menu a discesa Opzioni, specifica un intervallo di tempo.

    Nota

    Grafana Alerting supporta solo intervalli di tempo relativi fissi, ad esempio. now-24hr: now

    Non supporta intervalli di tempo assoluti: 2021-12-02 00:00:00 to 2021-12-05 23:59:592 o intervalli di tempo semi-relativi:. now/d to: now

  3. Aggiungi una query.

    Per aggiungere più interrogazioni, scegli Aggiungi interrogazione.

    Tutte le regole di avviso sono gestite da Grafana per impostazione predefinita. Se desideri passare a una regola di avviso gestita dall'origine dati, fai clic su Passa a una regola di avviso gestita dall'origine dati.

  4. Aggiungi una o più espressioni.

    1. 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 un avviso separato per ogni serie.

      Nota

      Quando si utilizza Prometheus, è possibile utilizzare un vettore istantaneo e funzioni integrate, quindi non è necessario aggiungere espressioni aggiuntive.

    2. Scegliete Anteprima per verificare che l'espressione abbia esito positivo.

  5. [Facoltativo] Per aggiungere una soglia di ripristino, attiva l'opzione Soglia di ripristino personalizzata e inserisci un valore per indicare quando la regola di avviso deve smettere di funzionare.

    È possibile aggiungere solo una soglia di ripristino in una query e deve essere la condizione di avviso.

  6. Scegli Imposta come condizione di avviso sulla query o sull'espressione che desideri impostare come condizione di avviso.

Utilizza la valutazione delle regole di avviso per determinare la frequenza con cui una regola di avviso deve essere valutata e la velocità con cui deve cambiare il suo stato.

A tale scopo, è necessario assicurarsi che la regola di avviso rientri nel gruppo di valutazione corretto e impostare un periodo di attesa più adatto al caso d'uso.

Per impostare il comportamento di valutazione degli avvisi

  1. Seleziona una cartella o scegli + Nuova cartella.

  2. Seleziona un gruppo di valutazione o fai clic su + Nuovo gruppo di valutazione.

    Se state creando un nuovo gruppo di valutazione, specificate l'intervallo per il gruppo.

    Tutte le regole all'interno dello stesso gruppo vengono valutate contemporaneamente nello stesso intervallo di tempo.

  3. Inserisci un periodo in sospeso.

    Il periodo in sospeso è il periodo in cui una regola di avviso può violare la condizione finché non viene attivata.

    Una volta soddisfatta una condizione, l'avviso passa allo stato In sospeso. Se la condizione rimane attiva per la durata specificata, l'avviso passa allo stato Attivo, altrimenti torna allo stato Normale.

  4. Attiva le notifiche di avviso di pausa, se necessario.

    Nota

    Metti in pausa la valutazione delle regole di avviso per evitare allarmi rumorosi durante l'ottimizzazione degli avvisi. La pausa interrompe la valutazione delle regole di avviso e non crea alcuna istanza di avviso. Ciò è diverso dagli orari di silenziamento, che impediscono la consegna delle notifiche, ma consentono comunque la valutazione delle regole di avviso e la creazione di istanze di avviso.

    È possibile sospendere la valutazione delle regole di avviso per evitare allarmi rumorosi durante l'ottimizzazione degli avvisi. La pausa interrompe la valutazione delle regole di avviso e non crea alcuna istanza di avviso. Ciò è diverso dagli orari di silenziamento, che impediscono la consegna delle notifiche, ma consentono comunque la valutazione delle regole di avviso e la creazione di istanze di avviso.

  5. In Configure no data and error handling, configura il comportamento di avviso in assenza di dati.

    Utilizza le linee guida riportate più avanti in questa sezione.

Aggiungi etichette alle regole di avviso per impostare quale politica di notifica deve gestire le istanze di allarme di licenziamento.

Tutte le regole e le istanze di avviso, indipendentemente dalle relative etichette, corrispondono alla politica di notifica predefinita. Se non ci sono politiche nidificate o nessuna politica nidificata corrisponde alle etichette nella regola di avviso o nell'istanza di avviso, la politica di notifica predefinita è la politica corrispondente.

Per configurare le notifiche

  1. Aggiungi etichette se desideri modificare il modo in cui vengono instradate le notifiche.

    Aggiungi etichette personalizzate selezionando le coppie chiave-valore esistenti dal menu a discesa oppure aggiungi nuove etichette inserendo la nuova chiave o il nuovo valore.

  2. Visualizza l'anteprima della configurazione del routing delle istanze di avviso.

    In base alle etichette aggiunte, le istanze di avviso vengono indirizzate alle politiche di notifica visualizzate.

    Espandi ogni politica di notifica per visualizzare ulteriori dettagli.

  3. Scegli Visualizza dettagli per visualizzare i dettagli sul routing degli avvisi e un'anteprima.

Aggiungi annotazioni per fornire più contesto sull'avviso nel tuo messaggio di notifica di avviso.

Le annotazioni aggiungono metadati per fornire ulteriori informazioni sull'avviso nel messaggio di notifica di avviso. Ad esempio, aggiungi un'annotazione di riepilogo per indicare quale valore ha causato l'attivazione dell'avviso o su quale server è avvenuto.

Per aggiungere annotazioni

  1. [Facoltativo] Aggiungi un riepilogo.

    Breve riassunto di quello che è successo e perché.

  2. [Facoltativo] Aggiungi una descrizione.

    Descrizione del funzionamento della regola di avviso.

  3. [Facoltativo] Aggiungi un RunbookURL.

    Pagina web in cui conservare il runbook per l'avviso

  4. [Opzionale] Aggiungi un'annotazione personalizzata

  5. [Facoltativo] Aggiungi un link alla dashboard e al pannello.

    Collega gli avvisi ai pannelli di una dashboard.

  6. Scegli Salva regola.

Regola singola e multidimensionale

Per gli avvisi gestiti da Grafana, puoi creare una regola con una condizione classica oppure puoi creare una regola multidimensionale.

  • Regola con condizione classica

    Usa l'espressione di condizione classica per creare una regola che attiva 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.

  • Regola multidimensionale

    Per generare un avviso separato per ogni serie, crea una regola multidimensionale. Usa MathReduce, o Resample espressioni per creare una regola multidimensionale. Per esempio:

    • 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. Non necessario nel caso in cui una query o un'espressione di riduzione restituisca già 0 se la regola non deve attivarsi o un numero positivo se deve attivarsi. Alcuni esempi: $B > 70 se dovesse attivarsi nel caso in cui il valore della query/espressione B sia superiore a 70. $B < $C * 100nel caso in cui dovesse attivarsi se il valore di B è inferiore al valore di C moltiplicato per 100. Se le query confrontate hanno 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 all'indirizzo https://comtemplate-variables-are-notmunity.grafana.com/t/ - - /2514. supported-in-alert-queries while-setting-up-alert

Nessuna configurazione per la gestione dei dati e degli errori

Configura il comportamento di avviso quando la valutazione della regola di avviso non restituisce dati o restituisce errori.

Nota

Le regole di avviso configurate per essere attivate quando una valutazione non restituisce dati o errori vengono attivate solo al termine dell'intera durata del periodo di valutazione. Ciò significa che anziché essere attivata immediatamente quando viene violata la condizione della regola di avviso, la regola di avviso attende il termine del periodo impostato come campo For e quindi viene attivata, riducendo il rumore di avviso e consentendo problemi temporanei di disponibilità dei dati.

Se la valutazione della regola di avviso non restituisce dati, è possibile impostare lo stato della regola di avviso in modo che appaia come segue:

Nessun dato Descrizione
Nessun dato Crea un nuovo avviso DatasourceNoData con il nome e UID della regola di avviso e UID dell'origine dati che non ha restituito dati come etichette.
Avviso Imposta lo stato della regola di avviso su. Alerting La regola di avviso attende il termine del tempo impostato nel campo For prima di essere attivata.
Ok Imposta lo stato della regola di avviso suNormal.

Se la valutazione restituisce un errore, puoi impostare lo stato della regola di avviso in modo che appaia come segue:

Errore Descrizione
Errore Crea un'istanza di avviso DatasourceError con il nome e la regola UID di avviso e UID l'origine dati che non ha restituito dati come etichette.
Avviso Imposta lo stato della regola di avviso su. Alerting La regola di avviso attende il termine del tempo impostato nel campo For prima di essere attivata.
Ok Imposta lo stato della regola di avviso suNormal.

Risolve le istanze di avviso obsolete

Un'istanza di avviso è considerata obsoleta se la sua dimensione o serie è scomparsa completamente dai risultati della query per due intervalli di valutazione.

Le istanze di avviso non aggiornate che si trovano negli Error statiAlerting/NoData/vengono contrassegnate automaticamente come Resolved e l'grafana_state_reasonannotazione viene aggiunta all'istanza di avviso con il motivo. MissingSeries

Crea avvisi dai pannelli

Crea avvisi da qualsiasi tipo di pannello. Ciò significa che puoi riutilizzare le interrogazioni nel pannello e creare avvisi basati su di esse.

  1. Accedi a una dashboard nella sezione Dashboard.

  2. Nell'angolo in alto a destra del pannello, scegli i tre punti (ellissi).

  3. Dal menu a discesa, seleziona Altro..., quindi scegli Nuova regola di avviso.

Si aprirà il modulo delle regole di avviso, che ti consentirà di configurare e creare l'avviso in base alla query del pannello corrente.