Configuration des règles d'enregistrement

Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana.

Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. Travailler dans la version 9 de Grafana

Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. Travailler dans la version 8 de Grafana

Vous pouvez créer et gérer des règles d'enregistrement pour une instance externe de Grafana Mimir ou Loki. Les règles d'enregistrement calculent à l'avance les expressions fréquemment nécessaires ou les expressions coûteuses en termes de calcul et enregistrent le résultat sous la forme d'un nouvel ensemble de séries chronologiques. L'interrogation de cette nouvelle série chronologique est plus rapide, en particulier pour les tableaux de bord, car ils demandent la même expression à chaque actualisation des tableaux de bord.

Note

Les règles d'enregistrement sont exécutées en tant que règles d'instance et exécutées toutes les 10 secondes.

Prérequis

• Vérifiez que vous disposez des autorisations d'écriture sur la source de données Prometheus ou Loki. Vous allez créer ou mettre à jour des règles d'alerte dans votre source de données.

• Pour les sources de données Grafana Mimir et Loki, activez l'API Ruler en configurant leurs services respectifs.

  • Loki — Le type de stockage des local règles, par défaut pour la source de données Loki, prend uniquement en charge l'affichage des règles. Pour modifier les règles, configurez l'un des autres types de stockage.

  • Grafana Mimir — Utilisez le préfixe. /prometheus La source de données Prometheus prend en charge Grafana Mimir et Prometheus, et Grafana s'attend à ce que l'API Query et l'API Ruler se trouvent sous la même URL. Vous ne pouvez pas fournir d'URL distincte pour l'API Ruler.

Note

Si vous ne souhaitez pas gérer les règles d'alerte pour une source de données Loki ou Prometheus en particulier, accédez à ses paramètres et décochez la case Gérer les alertes via l'interface utilisateur d'alerte.

Pour créer des règles d'enregistrement

1. Depuis votre console Grafana, dans le menu Grafana, choisissez Alerts & IRM, Alerting, Alert rules.

2. Choisissez Nouvelle règle d'enregistrement.

3. Définissez le nom de la règle.

   Le nom de la règle d'enregistrement doit être un nom de métrique Prometheus et ne contenir aucun espace.

4. Définir la requête

   • Sélectionnez votre source de données Loki ou Prometheus.

   • Saisissez une requête.

5. Ajoutez un espace de noms et un groupe.

   • Dans le menu déroulant Namespace, sélectionnez un espace de noms de règles existant ou ajoutez-en un nouveau. Les espaces de noms peuvent contenir un ou plusieurs groupes de règles et n'ont qu'un objectif organisationnel.

   • Dans le menu déroulant Groupe, sélectionnez un groupe existant dans l'espace de noms sélectionné ou ajoutez-en un nouveau. Les règles nouvellement créées sont ajoutées à la fin du groupe. Les règles d'un groupe sont exécutées séquentiellement à intervalles réguliers, avec le même temps d'évaluation.

6. Ajoutez des étiquettes.

   • Ajoutez des étiquettes personnalisées en sélectionnant les paires clé-valeur existantes dans la liste déroulante, ou ajoutez de nouvelles étiquettes en saisissant la nouvelle clé ou valeur.

7. Choisissez Enregistrer la règle pour enregistrer la règle, ou Enregistrer la règle et quitter pour enregistrer la règle et revenir à la page d'alerte.