Créer des règles d'alerte avec une condition basée sur PromQL (console)

Cette page explique comment créer une règle d'alerte avec une condition basée sur PromQL à l'aide de la console Google Cloud.

Avant de commencer

1. Pour obtenir les autorisations nécessaires pour créer des règles d'alerte avec une condition basée sur PromQL dans la console Google Cloud, demandez à votre administrateur de vous attribuer le rôle IAM Éditeur Monitoring (roles/monitoring.editor) sur votre projet. Pour en savoir plus sur l'attribution de rôles, consultez la section Gérer les accès.

   Vous pouvez également obtenir les autorisations requises via des rôles personnalisés ou d'autres rôles prédéfinis.

   Pour en savoir plus sur les rôles Cloud Monitoring, consultez la page Contrôler les accès avec Identity and Access Management.

2. Assurez-vous de maîtriser les concepts généraux des règles d'alerte et de PromQL dans Cloud Monitoring. Pour plus d'informations, consultez les articles suivants :

   • Vue d'ensemble des alertes
   • PromQL dans Cloud Monitoring

3. Configurez les canaux de notification que vous souhaitez utiliser pour recevoir les alertes. À des fins de redondance, nous vous recommandons de créer plusieurs types de canaux de notification. Pour en savoir plus, consultez Créer et gérer des canaux de notification.

4. Si la requête PromQL de votre règle d'alerte utilise une métrique personnalisée, celle-ci doit déjà exister.

Créer des règles d'alerte PromQL

Pour créer une règle d'alerte avec une condition basée sur PromQL dans la console Google Cloud, procédez comme suit:

1. Dans la console Google Cloud, accédez à la page  Alertes:

   Accéder à l'interface des alertes

   Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Surveillance.

2. Sur la page Alertes, cliquez sur Créer une règle.

3. Sous Mode de configuration des règles, sélectionnez Éditeur de code (MQL ou PromQL).

4. Vérifiez que PromQL est sélectionné dans le bouton d'activation Langage. Le bouton de langage se trouve dans la barre d'outils qui vous permet de mettre en forme votre requête.

5. Saisissez la requête PromQL qui sélectionne les données que vous souhaitez surveiller. Si l'option Exécution automatique n'est pas activée, cliquez sur Exécuter la requête.

   Par exemple, la requête suivante récapitule le taux de données de journalisation de la facturation ingérées sur un intervalle de 60 secondes et détermine si le taux résumé est supérieur à 300 octets:

   sum(rate(logging_googleapis_com:billing_bytes_ingested{monitored_resource="global"}[60s]))>300
   

   Une fois la requête exécutée, un graphique s'affiche. Pour un projet, la requête ci-dessus a généré le résultat suivant :

   

6. Cliquez sur Suivant et configurez le déclencheur d'alerte.

   1. Sélectionnez une valeur pour le Déclencheur d'alerte. Cette valeur spécifie le nombre de séries temporelles renvoyées par la requête qui doivent satisfaire à l'opération d'alerte pour que la règle d'alerte puisse être déclenchée. Vous pouvez sélectionner l'un des critères suivants:

      • N'importe quelle série temporelle.
      • Un pourcentage de la série temporelle,
      • Un nombre spécifique de séries temporelles,
      • Toutes les séries temporelles.

   2. Sélectionnez une fenêtre Tester de nouveau. Ce champ définit la durée pendant laquelle la condition doit être remplie avant le déclenchement de la règle d'alerte.

      La valeur par défaut est 0 sec. Avec ce paramètre, une seule mesure peut entraîner une notification. Pour en savoir plus et obtenir un exemple, consultez la section Paramètres de période et de durée de l'alignement.

   3. Pour sélectionner la fréquence à laquelle les alertes évaluent la requête PromQL, choisissez une valeur pour le champ EvaluationInterval (Intervalle d'évaluation).

      Remarque :Les incidents créés par une règle d'alerte avec une condition basée sur PromQL ne suivent pas la durée de fermeture automatique de la règle d'alerte. Au lieu de cela, l'incident est automatiquement fermé lorsqu'il atteint une durée définie après la dernière fois que la condition a été remplie. Cette durée correspond au plus élevé de 270 secondes et au double de l'intervalle d'évaluation de la condition.

   4. Attribuez un nom à la condition, puis cliquez sur Suivant.

7. ajouter des canaux de notification ;

8. Facultatif: ajoutez des étiquettes de règles d'alerte et une documentation.

9. Cliquez sur Nom de l'alerte et saisissez un nom pour la règle d'alerte.

10. Cliquez sur Créer une stratégie.

Pour connaître la procédure détaillée, consultez Gérer les règles d'alerte.