Créer des règles d'alerte basées sur PromQL (console)

Cette page explique comment créer des règles d'alerte basées 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 basées 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 :

  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 fait référence à des métriques, celles-ci doivent déjà exister dans Monitoring lorsque vous créez la règle d'alerte.

Créer des règles d'alerte PromQL

Pour créer une règle d'alerte 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 :

    Graphique d'une condition d'alerte PromQL après la spécification de l'alerte.

  6. Cliquez sur Suivant, puis procédez comme suit:

    1. Sélectionnez une fenêtre de nouveau 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.

    2. Pour sélectionner la fréquence à laquelle l'alerte évalue la requête PromQL, choisissez une valeur pour l'intervalle d'évaluation.

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

  7. Cliquez sur Suivant, puis procédez comme suit:

    1. Ajoutez des canaux de notification.

    2. Choisissez un niveau de gravité pour les incidents.

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

    4. Saisissez le nom de la règle d'alerte.

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

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