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 accorder le rôle IAM Éditeur Monitoring (roles/monitoring.editor) sur votre projet. Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.

   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 Contrôler les accès avec Identity and Access Management.

2. Assurez-vous de bien 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 :

   • Présentation des alertes
   • PromQL dans Cloud Monitoring

3. Configurez les canaux de notification que vous souhaitez utiliser pour recevoir des alertes. À des fins de redondance, nous vous recommandons de créer plusieurs types de canaux de notification. Pour en savoir plus, consultez la page 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, la métrique 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 à partir de 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 Monitoring.

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ésume le débit des données de journalisation de facturation ingérées sur un intervalle de 60 secondes et détermine si le débit résumé dépasse 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, puis configurez le déclencheur d'alerte.

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

      • Une 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 de test. Ce champ définit la durée pendant laquelle la condition doit être remplie avant que la règle d'alerte ne soit déclenchée.

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

   3. Pour sélectionner la fréquence à laquelle l'alerte évalue la requête PromQL, choisissez une valeur pour l'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 un délai défini après la dernière fois que la condition a été remplie. Cette durée correspond à la valeur la plus élevée entre 270 secondes et deux fois l'intervalle d'évaluation de la condition.

   4. Saisissez un nom pour la condition, puis cliquez sur Suivant.

7. Ajoutez des canaux de notification.

8. Facultatif: Ajoutez des libellés de règles d'alerte et de la documentation.

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

10. Cliquez sur Créer une règle.

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