Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Création de règles d'enregistrement gérées par Grafana, Mimir ou Loki
Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana.
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. Travailler dans la version 10 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 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.
Prérequis
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 — Lorsque vous configurez une source de données pour qu'elle pointe vers Grafana Mimir, utilisez l'ancien préfixe et non.
/api/prom
/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 ajouter une règle d'enregistrement géré par Grafana, Mimir ou Loki
-
Depuis votre console Grafana, dans le menu Grafana, choisissez l'icône d'alerte (cloche) pour ouvrir la page d'alerte répertoriant les alertes existantes.
-
Choisissez Créer une règle d'alerte.
-
À l'étape 1, ajoutez le type de règle, le nom de la règle et l'emplacement de stockage, comme suit.
-
Sélectionnez l'option de règle d'enregistrement Mimir ou Loki.
-
Dans Nom de la règle, ajoutez un nom descriptif. Ce nom est affiché dans la liste des règles d'alerte. Il s'agit également de l'
alertname
étiquette de chaque instance d'alerte créée à partir de cette règle. -
Dans le menu déroulant Sélectionner une source de données, sélectionnez une source de données Prometheus ou Loki.
-
Dans le menu déroulant Namespace, sélectionnez un espace de noms de règles existant. Sinon, choisissez Ajouter nouveau et entrez un nom pour en créer un. Les espaces de noms peuvent contenir un ou plusieurs groupes de règles et n'ont qu'un objectif organisationnel. Pour plus d’informations, consultez Groupes de règles et espaces de noms Cortex ou Loki.
-
Dans le menu déroulant Groupe, sélectionnez un groupe existant dans l'espace de noms sélectionné. Sinon, choisissez Ajouter nouveau et entrez un nom pour en créer un. Les règles nouvellement créées sont ajoutées à la fin du groupe. Les règles d'un groupe s'exécutent séquentiellement à intervalles réguliers, avec le même temps d'évaluation.
-
-
À l'étape 2, ajoutez la requête à évaluer.
La valeur peut être une expression ProMQL ou LogQL. La règle déclenche une alerte si le résultat de l'évaluation comporte au moins une série dont la valeur est supérieure à 0. Une alerte est créée pour chaque série.
-
À l'étape 3, ajoutez des métadonnées supplémentaires associées à la règle.
-
Ajoutez une description et un résumé pour personnaliser les messages d'alerte. Utilisez les directives dansAnnotations et étiquettes pour les règles d'alerte.
-
Ajoutez l'URL, le panneau, le tableau de bord et les identifiants d'alerte de Runbook.
-
Ajoutez des étiquettes personnalisées.
-
-
Choisissez Enregistrer pour enregistrer la règle ou Enregistrer et quitter pour enregistrer la règle et revenir à la page d'alerte.