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.
Configuration des règles d'alerte gérées par les sources de données
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
Créez des règles d'alerte pour une instance externe de Grafana Mimir ou Loki sur laquelle la règle est API activée ; ces règles sont appelées règles d'alerte gérées par source de données.
Note
Les règles d'alerte pour une instance externe de Grafana Mimir ou Loki peuvent être modifiées ou supprimées par les utilisateurs ayant des rôles d'éditeur ou d'administrateur.
Si vous supprimez une ressource d'alerte créée dans l'interface utilisateur, vous ne pouvez plus la récupérer. Pour effectuer une sauvegarde de votre configuration et pouvoir restaurer les ressources d'alerte supprimées, créez vos ressources d'alerte à l'aide de Terraform, ou de l'Alerting. API
Prérequis
-
Vérifiez que vous disposez d'une autorisation d'écriture sur la source de données Prometheus ou Loki. Sinon, vous ne pourrez pas créer ou mettre à jour les règles d'alerte gérées par Grafana Mimir.
-
Pour les sources de données Grafana Mimir et Loki, activez le Ruler API 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 de règles. -
Grafana Mimir - utilise le préfixe.
/prometheus
La source de données Prometheus prend en charge Grafana Mimir et Prometheus, et Grafana s'attend à ce que la requête et la règle soient identiques. API APIURL Vous ne pouvez pas fournir un titre distinct URL pour le RulerAPI.
-
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.
Dans les procédures suivantes, nous vous guiderons tout au long du processus de création de vos règles d'alerte gérées par les sources de données.
Pour créer une règle d'alerte gérée par une source de données, utilisez le flux de création d'alertes intégré à l'espace de travail et suivez ces étapes pour vous aider.
Pour définir le nom de la règle d'alerte
-
Choisissez Alerte -> Règles d'alerte -> + Nouvelle règle d'alerte.
-
Entrez un nom pour identifier votre règle d'alerte.
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.
Définissez une requête pour obtenir les données que vous souhaitez mesurer et une condition qui doit être remplie avant qu'une règle d'alerte ne soit déclenchée.
Pour définir la requête et la condition
-
Toutes les règles d'alerte sont gérées par Grafana par défaut. Pour passer à une règle d'alerte gérée par source de données, choisissez Basculer vers une règle d'alerte gérée par source de données.
-
Sélectionnez une source de données dans la liste déroulante.
Vous pouvez également choisir Ouvrir le sélecteur de source de données avancé pour voir d'autres options, notamment l'ajout d'une source de données (administrateurs uniquement).
-
Entrez une requête ProMQL ou LogQL.
-
Choisissez Aperçu des alertes.
Utilisez l'évaluation des règles d'alerte pour déterminer à quelle fréquence une règle d'alerte doit être évaluée et à quelle vitesse elle doit changer d'état.
Pour définir le comportement d'évaluation des alertes
-
Sélectionnez un espace de noms ou choisissez + Nouvel espace de noms.
-
Sélectionnez un groupe d'évaluation ou choisissez + Nouveau groupe d'évaluation.
Si vous créez un nouveau groupe d'évaluation, spécifiez l'intervalle pour le groupe.
Toutes les règles d'un même groupe sont évaluées séquentiellement sur le même intervalle de temps.
-
Entrez une période d'attente.
La période d'attente est la période pendant laquelle une règle d'alerte peut enfreindre la condition jusqu'à ce qu'elle se déclenche.
Une fois qu'une condition est remplie, l'alerte passe à l'
Pending
état. Si la condition reste active pendant la durée spécifiée, l'alerte passe à l'Firing
état, sinon elle revient à l'Normal
état.
Ajoutez des libellés à vos règles d'alerte pour définir la politique de notification qui doit gérer vos instances d'alerte de déclenchement.
Toutes les règles et instances d'alerte, quel que soit leur libellé, correspondent à la politique de notification par défaut. S'il n'existe aucune politique imbriquée ou si aucune politique imbriquée ne correspond aux libellés de la règle d'alerte ou de l'instance d'alerte, la stratégie de notification par défaut est la stratégie correspondante.
Configurer des notifications
-
Ajoutez des libellés si vous souhaitez modifier le mode d'acheminement de vos notifications.
Ajoutez des étiquettes personnalisées en sélectionnant des paires clé-valeur existantes dans le menu déroulant, ou ajoutez de nouvelles étiquettes en saisissant la nouvelle clé ou valeur.
Ajoutez des annotations pour fournir plus de contexte sur l'alerte dans vos notifications d'alerte.
Les annotations ajoutent des métadonnées pour fournir plus d'informations sur l'alerte dans vos notifications d'alerte. Par exemple, ajoutez une Summary
annotation pour vous indiquer quelle valeur a provoqué le déclenchement de l'alerte ou sur quel serveur elle s'est produite.
Pour ajouter des annotations
-
[Facultatif] Ajoutez un résumé.
Bref résumé de ce qui s'est passé et pourquoi.
-
[Facultatif] Ajoutez une description.
Description de l'action de la règle d'alerte.
-
[Facultatif] Ajoutez un RunbookURL.
Page Web où vous conservez votre runbook pour l'alerte
-
[Facultatif] Ajouter une annotation personnalisée
-
[Facultatif] Ajoutez un tableau de bord et un lien vers un panneau.
Lie les alertes aux panneaux d'un tableau de bord.
-
Choisissez Enregistrer la règle.