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 dont vous avez besoin 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 bien connaître 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 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 à partir de la console Google Cloud, procédez comme suit:

  1. Dans le panneau de navigation de la console Google Cloud, sélectionnez Monitoring, puis  Alertes :

    Accéder à l'interface des alertes

  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 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 :

    Graphique à partir d'une condition d'alerte PromQL après avoir spécifié l'alerte.

  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 avant que la règle d'alerte ne puisse être déclenchée. Vous avez le choix entre les 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 période de nouveau test. Ce champ définit la durée pendant laquelle la condition doit être remplie avant que la règle d'alerte soit déclenchée.

      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 durée 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 l'intervalle d'évaluation.

    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 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 règle.

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