Créer et gérer des modèles de règles d'alerte Prometheus - Managed Service for Prometheus

Informations générales

Si vous disposez de plusieurs instances Prometheus inter-régionales, la création de règles d'alerte pour chaque instance Prometheus individuellement est fastidieuse et rend difficile la gestion synchronisée des règles pour chaque instance Prometheus. Pour résoudre ce problème, Managed Service for Prometheus propose la fonctionnalité de modèle de règle d'alerte. Cette fonctionnalité vous aide à créer rapidement des règles d'alerte pour plusieurs instances Prometheus et à les gérer de manière unifiée, ce qui réduit le coût de gestion des règles d'alerte sur plusieurs instances Prometheus.

Créer un modèle de règle d'alerte Prometheus

Connectez-vous à la console ARMS.
Dans le volet de navigation de gauche, sélectionnez Managed Service for Prometheus > Prometheus Alert Rule Template.
Connectez-vous à la console Managed Service for Prometheus.
Dans le volet de navigation de gauche, cliquez sur Alert Rule Template.
Dans le coin supérieur droit de la page, cliquez sur Create Prometheus Alert Rule Template.

Sur la page Create Prometheus Alert Rule, configurez les paramètres suivants.

Vous pouvez créer un modèle de règle d'alerte Prometheus en utilisant un seuil statique ou une requête PromQL personnalisée.

Le type de vérification par seuil statique fournit des métriques d'alerte prédéfinies. Vous pouvez sélectionner une métrique prédéfinie pour créer rapidement une règle d'alerte.
Pour surveiller des métriques non prédéfinies, utilisez le type de vérification PromQL personnalisé afin de créer une règle d'alerte.

Tableau 1. Types de vérification par seuil statique

Paramètre	Description	Exemple
Nom du modèle de règle d'alerte	Nom du modèle de règle d'alerte.	Cluster de production - Alerte d'utilisation du CPU du conteneur
Description du modèle de règle d'alerte	Facultatif. Décrivez le modèle. Vous pouvez inclure son objectif, les scénarios applicables ou d'autres notes.	Aucun
Type de vérification	Sélectionnez Seuil statique.	Seuil statique
Groupe d'alertes	Sélectionnez un groupe d'alertes.	Charges de travail Kubernetes
Métrique d'alerte	Sélectionnez la métrique pour laquelle vous souhaitez configurer une alerte. Chaque groupe d'alertes possède des métriques différentes.	Utilisation du CPU du conteneur
Condition d'alerte	Définissez les conditions de déclenchement d'un événement d'alerte en fonction du contenu prédéfini de la métrique d'alerte.	La condition d'alerte est remplie lorsque l'utilisation du CPU du conteneur est `supérieure à` `80`%.
Condition de filtrage	En fonction de la métrique d'alerte, définissez la portée de la règle d'alerte. Un événement d'alerte est déclenché pour toute ressource qui satisfait à la fois aux conditions de filtrage et à la condition d'alerte. Les conditions de filtrage disponibles sont : Traverse : La règle d'alerte s'applique à toutes les ressources de l'instance Prometheus actuelle. Par défaut, la condition de filtrage est définie sur Parcours. Equal To : Après avoir sélectionné cette condition, saisissez un nom de ressource spécifique. La règle d'alerte s'appliquera uniquement à cette ressource. Vous ne pouvez pas saisir plusieurs ressources. Is not equal : Après avoir sélectionné cette condition, saisissez un nom de ressource spécifique. La règle d'alerte s'appliquera à toutes les ressources sauf celle-ci. Vous ne pouvez pas saisir plusieurs ressources. Match Regular Expression : Après avoir sélectionné cette condition, saisissez une expression régulière pour faire correspondre les noms de ressources. La règle d'alerte s'appliquera à toutes les ressources correspondant à l'expression. Do Not Match Regular Expression : Après avoir sélectionné cette condition, saisissez une expression régulière pour faire correspondre les noms de ressources. La règle d'alerte exclura toutes les ressources correspondant à l'expression.	IP de l'instance : Parcourir
Durée	Déclencher un événement d'alerte dès que la condition d'alerte est remplie : Un événement d'alerte est déclenché si n'importe quel point de données atteint le seuil. Déclencher un événement d'alerte uniquement lorsque la condition d'alerte persiste pendant N minutes : Un événement d'alerte est déclenché uniquement si le seuil est atteint pendant N minutes ou plus.	1
Gravité de l'alerte	Gravité de l'alerte. La gravité par défaut est Default. Les niveaux de gravité, du plus faible au plus élevé, sont Par défaut, P4, P3, P2 et P1.	Par défaut
Contenu de l'alerte	Informations d'alerte reçues par les utilisateurs. Vous pouvez utiliser la syntaxe de modèle Go pour personnaliser les variables de paramètres d'alerte dans le contenu de l'alerte.	`Namespace: {{$labels.namespace}} / Pod: {{$labels.pod_name}} / Container: {{$labels.container}} CPU utilization {{$labels.metrics_params_opt_label_value}} {{$labels.metrics_params_value}}%, current value {{ printf "%.2f" $value }}%`
Paramètres avancés
Libellés	Définissez les libellés d'alerte. Les libellés peuvent être utilisés comme options pour la correspondance des règles dans les politiques de notification.	Aucun
Annotations	Définissez les annotations pour l'alerte.	Aucun

Tableau 2. Types de vérification PromQL personnalisés

Paramètre	Description	Exemple
Nom du modèle de règle d'alerte	Nom du modèle de règle d'alerte.	L'utilisation du CPU du pod est supérieure à 80 %
Description du modèle de règle d'alerte	Facultatif. Décrivez le modèle. Vous pouvez inclure son objectif, les scénarios applicables ou d'autres notes.	Aucun
Type de vérification	Définissez sur PromQL personnalisé.	PromQL personnalisé
Instruction PromQL personnalisée	Utilisez une instruction PromQL pour définir l'expression de la règle d'alerte.	`max(container_fs_usage_bytes{pod!="", namespace!="arms-prom",namespace!="monitoring"}) by (pod_name, namespace, device)/max(container_fs_limit_bytes{pod!=""}) by (pod_name,namespace, device) * 100 > 90`
Durée	Déclencher un événement d'alerte dès que la condition d'alerte est remplie : Un événement d'alerte est déclenché si n'importe quel point de données atteint le seuil. Déclencher un événement d'alerte uniquement lorsque la condition d'alerte persiste pendant N minutes : Un événement d'alerte est déclenché uniquement si le seuil est atteint pendant N minutes ou plus.	1
Gravité de l'alerte	Gravité de l'alerte. La gravité par défaut est Default. Les niveaux de gravité, du plus faible au plus élevé, sont Par défaut, P4, P3, P2 et P1.	Par défaut
Contenu de l'alerte	Informations d'alerte reçues par les utilisateurs. Vous pouvez utiliser la syntaxe de modèle Go pour personnaliser les variables de paramètres d'alerte dans le contenu de l'alerte.	`Namespace: {{$labels.namespace}}/Pod: {{$labels.pod_name}}/Disk device: {{$labels.device}} utilization exceeds 90 %, current value {{ printf "%.2f" $value }}%`
Paramètres avancés
Libellés	Définissez les libellés d'alerte. Les libellés peuvent être utilisés comme options pour la correspondance des règles dans les politiques de notification.	Aucun
Annotations	Définissez les annotations pour l'alerte.	Aucun

Appliquer le modèle

Après avoir créé un modèle d'alerte Prometheus, vous pouvez l'appliquer pour créer des règles d'alerte pour une instance Prometheus. Vous pouvez également utiliser le modèle pour mettre à jour les règles d'alerte existantes d'une instance Prometheus.

Sur la page Prometheus Alert Rule Template, cliquez sur Apply Template pour le modèle que vous souhaitez appliquer.
Sur la page Apply Template, dans l'onglet Prometheus Instance Selection Mode, sélectionnez une instance Prometheus et cliquez sur OK.

Remarque
Vous pouvez filtrer les instances Prometheus associées à ce modèle d'alerte par nom d'instance Prometheus, région et type d'instance Prometheus.
Dans la boîte de dialogue qui s'affiche, indiquez si vous souhaitez mettre à jour les règles d'alerte existantes, puis cliquez sur OK.
ARMS utilise le modèle de règle d'alerte actuel pour créer des règles d'alerte dans les instances Prometheus sélectionnées.
- Si vous ne sélectionnez pas Update Existing Alert Rules : Si l'instance Prometheus sélectionnée contient déjà des règles d'alerte créées à partir du modèle d'alerte actuel, le message Alert Rules Have Already Been Created By Using This Template And Will Not Be Updated s'affiche. Les règles d'alerte existantes ne sont pas mises à jour.
- Update Existing Alert Rules : Si l'instance Prometheus sélectionnée contient déjà des règles d'alerte créées à partir du modèle d'alerte actuel, les règles d'alerte Prometheus sont mises à jour pour correspondre au contenu le plus récent du modèle d'alerte.
  
  Important
  Si une règle d'alerte a été modifiée individuellement mais que son mappage avec le modèle a été conservé, les modifications individuelles sont écrasées et perdues.

Supprimer le modèle

Si un modèle d'alerte Prometheus n'est plus nécessaire, vous pouvez supprimer le modèle d'alerte Prometheus. Lors de la suppression d'un modèle, vous pouvez spécifier si vous souhaitez conserver les règles d'alerte qui en ont été créées.

Sur la page Prometheus Alert Rule Template, cliquez sur Delete à droite du modèle de règle d'alerte cible.
Dans la boîte de dialogue qui s'affiche, indiquez si vous souhaitez également supprimer les règles d'alerte créées à partir du modèle, puis cliquez sur Confirm.
- Sélectionnez Delete Alert Rules Created from Template : Les règles d'alerte Prometheus associées au modèle sont supprimées. Si une règle d'alerte Prometheus créée à partir du modèle a été modifiée manuellement et que vous avez sélectionné Do Not Retain The Mapping Between The Template And The Rule lors de l'enregistrement, la règle n'est pas supprimée.
- Si vous ne sélectionnez pas Delete Alert Rules Created from Template, les règles d'alerte Prometheus créées à partir du modèle sont conservées.

Afficher les règles d'alerte créées à partir d'un modèle

Vous pouvez afficher et gérer par lots les règles d'alerte créées à partir d'un modèle.

Sur la page Prometheus Alert Rule Template, cliquez sur View Rules Created From Template à droite du modèle de règle d'alerte cible.
Vous pouvez gérer les règles d'alerte par lots sur la page Alert Rules Created from Template.
- Pour activer les alertes par lots : Sélectionnez les règles d'alerte souhaitées et cliquez sur Enable Alert Rules.
- Pour désactiver les alertes par lots : Sélectionnez les règles d'alerte souhaitées et cliquez sur Disable Alert Rules.
- Pour supprimer les alertes par lots : Sélectionnez les règles d'alerte souhaitées et cliquez sur Delete Alert Rules.

Remarques

Lorsque vous modifiez et enregistrez une règle d'alerte Prometheus créée à partir d'un modèle de règle d'alerte Prometheus, vous devez choisir si vous souhaitez conserver le mappage entre le modèle et la règle.

Retain the mapping between this alert rule and the alert rule template : Si vous conservez ce mappage, vos modifications actuelles risquent d'être écrasées si vous appliquez le modèle de règle d'alerte correspondant à l'instance Prometheus pour cette règle et sélectionnez l'option de mise à jour forcée.
Remove the mapping between this alert rule and the alert rule template : Une fois le mappage désactivé, cette règle d'alerte est traitée comme une règle indépendante. Nous vous recommandons de modifier le nom de la règle d'alerte. Sinon, si vous appliquez à nouveau le modèle de règle d'alerte correspondant à l'instance Prometheus, la création échouera en raison d'un nom de règle d'alerte dupliqué.