Configurare le regole di registrazione

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

È possibile creare e gestire regole di registrazione per un'istanza Grafana Mimir o Loki esterna. Le regole di registrazione calcolano in anticipo le espressioni più richieste o quelle più dispendiose dal punto di vista computazionale e salvano il risultato come una nuova serie temporale. L'interrogazione di questa nuova serie temporale è più veloce, soprattutto per le dashboard, poiché interrogano la stessa espressione ogni volta che le dashboard si aggiornano.

Nota

Le regole di registrazione vengono eseguite come regole di istanza e vengono eseguite ogni 10 secondi.

Prerequisiti

• Verifica di disporre delle autorizzazioni di scrittura per l'origine dati Prometheus o Loki. Creerai o aggiornerai le regole di avviso nella tua fonte di dati.

• Per le sorgenti dati Grafana Mimir e Loki, abilita l'API ruler configurando i rispettivi servizi.

  • Loki — Il tipo di archiviazione delle local regole, predefinito per l'origine dati Loki, supporta solo la visualizzazione delle regole. Per modificare le regole, configura uno degli altri tipi di archiviazione.

  • Grafana Mimir — Usa il prefisso. /prometheus L'origine dati Prometheus supporta sia Grafana Mimir che Prometheus e Grafana prevede che sia l'API Query che l'API Ruler si trovino nello stesso URL. Non è possibile fornire un URL separato per l'API Ruler.

Nota

Se non desideri gestire le regole di avviso per una particolare origine dati Loki o Prometheus, vai alle relative impostazioni e deseleziona la casella di controllo Gestisci avvisi tramite interfaccia utente di avviso.

Per creare regole di registrazione

1. Dalla console Grafana, nel menu Grafana, scegli Avvisi e IRM, Avvisi, Regole di avviso.

2. Scegli Nuova regola di registrazione.

3. Imposta il nome della regola.

   Il nome della regola di registrazione deve essere un nome metrico di Prometheus e non contenere spazi bianchi.

4. Definisci l'interrogazione

   • Seleziona la tua fonte di dati Loki o Prometheus.

   • Inserisci una query.

5. Aggiungi namespace e gruppo.

   • Dal menu a discesa Namespace, seleziona uno spazio dei nomi di regole esistente o aggiungine uno nuovo. I namespace possono contenere uno o più gruppi di regole e avere solo uno scopo organizzativo.

   • Dal menu a discesa Gruppo, seleziona un gruppo esistente all'interno del namespace selezionato o aggiungine uno nuovo. Le regole appena create vengono aggiunte alla fine del gruppo. Le regole all'interno di un gruppo vengono eseguite in sequenza a intervalli regolari, con lo stesso tempo di valutazione.

6. Aggiungi etichette.

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

7. Scegli Salva regola per salvare la regola o Salva regola ed esci per salvare la regola e tornare alla pagina Avvisi.