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 règle d'alerte 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 É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 :

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

3. Configurez les canaux de notification que vous souhaitez utiliser pour recevoir 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, 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 et configurez le déclencheur d'alerte.

   1. Sélectionnez une valeur pour le Déclencheur d'alerte. Cette valeur indique le nombre de séries temporelles renvoyées par la requête à l'opération d'alerte avant que la règle ne 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 Tester de nouveau. Ce champ définit la durée pendant laquelle 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 la mesure peut entraîner l'envoi d'une notification. Pour en savoir plus et Pour obtenir un exemple, consultez Paramètres de période d'alignement et de durée.

   3. Pour sélectionner la fréquence à laquelle les alertes évaluent la requête PromQL, sélectionnez 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. À la place, l'incident est automatiquement fermé lorsqu'une durée définie est écoulée la dernière fois que la condition a été remplie. Cette durée est la plus grande de 270 secondes et deux fois l'intervalle d'évaluation de la condition.

   4. Attribuez un nom à 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 détaillée, consultez Gérer les règles d'alerte.