Utiliser PromQL pour créer des règles d'alerte

Les requêtes PromQL (Prometheus Query Language) dans Cloud Monitoring vous permettent de créer des règles d'alerte avec des conditions complexes telles que des ratios de métriques, des seuils dynamiques basés sur une autre métrique et des métriques combinées. Ces règles peuvent évaluer jusqu'à deux ans de données de métriques.

Si vous utilisez Prometheus dans des environnements en dehors de Google Cloud ou si vous utilisez des alertes dans Google Cloud Managed Service pour Prometheus, vous pouvez migrer vos règles d'alerte Prometheus vers des règles d'alerte basées sur PromQL. La migration de vos règles vous permet de gérer toutes vos règles d'alerte dans Monitoring. Vous pouvez également importer des tableaux de bord Grafana dans Cloud Monitoring. Pour obtenir des informations générales sur l'utilisation de PromQL et sur la façon dont les règles d'alerte évaluent les données, consultez PromQL dans Cloud Monitoring et Comportement des règles d'alerte basées sur les métriques.

Utiliser PromQL dans les règles d'alerte Cloud Monitoring

Vous pouvez créer des règles d'alerte basées sur PromQL de différentes manières :

Les alertes créées par une règle d'alerte basée sur PromQL s'affichent dans la console Google Cloud avec vos autres alertes. Vous pouvez interagir avec ces alertes dans la console Google Cloud .

Les conditions de votre règle d'alerte basée sur PromQL peuvent référencer n'importe quelle métrique dans Cloud Monitoring, y compris les métriques système Google Cloud , les métriques personnalisées et les métriques basées sur les journaux, ainsi que les métriques Prometheus. Vous devez traduire les noms des métriques non Prometheus dans la syntaxe des métriques PromQL. Pour en savoir plus, consultez Mapper des métriques Monitoring à PromQL.

Interroger plus de deux ans de données de métriques

Contrairement aux autres types de règles d'alerte, qui ne permettent d'interroger que 25 heures de données de métriques, vous pouvez utiliser PromQL pour générer des alertes sur un maximum de deux ans de données de métriques. Cela permet de répondre à des cas d'utilisation tels que :

  • Détecter les anomalies en comparant les cinq dernières minutes à la même période de cinq minutes il y a une semaine.
  • Exécuter une règle d'alerte de consommation lente sur 7 jours.
  • Obtenir la valeur moyenne du mois dernier et envoyer une alerte si l'heure de données la plus récente s'écarte de plus de trois écarts types de cette moyenne.
  • Utiliser la fonction predict_linear sur les données de la semaine dernière pour voir si vous allez dépasser un seuil le jour suivant.

Les règles d'alerte PromQL qui s'appliquent aux données des 25 dernières heures, telles que définies par la somme de la période d'alignement et de tout décalage temporel causé par l'utilisation du modificateur offset, peuvent être évaluées toutes les 30 secondes. Les règles qui s'appliquent à des données plus anciennes sont évaluées moins fréquemment, la période minimale étant déterminée par l'ancienneté des données examinées par votre règle d'alerte :

Plage d'analyse de la requête Intervalle d'évaluation minimal (par défaut)
Jusqu'à 25 heures1 30 seconds
Entre 25 heures et 8 jours 5 minutes
Entre 8 et 16 jours 1 heure
Entre 16 et 32 jours 2 heures
32 à 93 jours 6 heures
93 jours à 2 ans 12 heures

1 Certaines métriques des services Google Cloud ne sont compatibles qu'avec des intervalles d'évaluation de 30 secondes pendant une durée maximale de 23 heures et 30 minutes.

Assurez-vous que les durées rate sont au moins égales à votre intervalle d'évaluation afin que votre règle d'alerte ne manque aucune donnée. Par exemple, si votre intervalle d'évaluation est d'une heure, votre requête doit se présenter comme suit : rate(metric[1h]).

Les conditions qui s'appliquent à plus de 25 heures de données ont un délai de requête de deux minutes, ce qui correspond au délai de l'Explorateur de métriques. Si votre requête PromQL n'expire pas dans l'explorateur de métriques, elle n'expirera pas dans votre alerte.

Les règles d'alerte PromQL sont beaucoup plus fiables lorsqu'elles s'exécutent sur les données des 25 dernières heures. Pour une fiabilité maximale, assurez-vous que la somme de votre fenêtre de nouveau test, de votre période d'alignement et de tout décalage temporel causé par l'utilisation du modificateur offset ne dépasse pas 25 heures.

Les fenêtres de nouveau test sont désactivées pour les requêtes d'alerte PromQL qui accèdent à des données datant de plus de 25 heures.

Vous ne pouvez recevoir des alertes que sur les 25 dernières heures de données pour les métriques personnalisées (préfixe custom.googleapis.com) et les métriques basées sur les journaux définies par l'utilisateur (préfixe logging.googleapis.com/user/).

Restrictions

N'ajoutez pas de filtres utilisant des libellés de métadonnées système à vos règles d'alerte basées sur PromQL.

Une règle d'alerte basée sur PromQL peut avoir une fenêtre de nouveau test de 24 heures au maximum. Si vous utilisez une fenêtre de nouveau test, la somme de votre fenêtre de nouveau test, de la période d'alignement et de tout décalage temporel causé par l'utilisation du modificateur offset doit être d'au plus 25 heures.

Si votre règle d'alerte Prometheus fait référence à une métrique, vous devez d'abord disposer d'un descripteur de la métrique équivalent dans Cloud Monitoring avant de créer votre règle d'alerte basée sur PromQL. Toutefois, vous pouvez ignorer cette validation en configurant votre règle d'alerte basée sur PromQL avec l'API Cloud Monitoring. Pour en savoir plus, consultez Désactiver la vérification de l'existence de métriques.

Si votre règle d'alerte surveille un ratio de métriques, définissez la durée sur au moins deux fois son intervalle d'évaluation. Des durées plus courtes peuvent entraîner de fausses alertes. Pour en savoir plus, consultez Fausses alertes dues à des anomalies de calcul du ratio.