Règles d'alerte avec PromQL

Cette page décrit les différentes méthodes permettant de créer des règles d'alerte avec une requête PromQL dans leur condition.

Les règles d'alerte avec une condition basée sur PromQL constituent une alternative Open Source à l'utilisation de requêtes MQL (Monitoring Query Language) pour configurer les conditions de votre règle d'alerte. Vous pouvez utiliser des requêtes PromQL pour créer des conditions complexes avec des fonctionnalités telles que des ratios, des seuils dynamiques et des métriques combinées.

Si vous utilisez Prometheus dans des environnements extérieurs à Google Cloud ou dans Managed Service pour Prometheus, vous pouvez migrer vos règles d'alerte Prometheus vers des règles d'alerte avec une condition basée sur PromQL. De cette façon, vous pouvez gérer toutes vos règles d'alerte dans Cloud Monitoring.

Vous pouvez également importer des tableaux de bord Grafana dans Cloud Monitoring.

Présentation

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

  • Créez une règle d'alerte dans la console Google Cloud et définissez une requête PromQL dans l'éditeur de code.

  • Créez une règle d'alerte avec une condition basée sur PromQL à l'aide de gcloud CLI ou de la construction AlertPolicy dans l'API Monitoring.

  • Migrez vos règles d'alerte Prometheus et vos canaux de notification vers Cloud Monitoring à l'aide de la Google Cloud CLI.

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

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

Restrictions

Une règle d'alerte avec une condition basée sur PromQL peut avoir une durée maximale de 24 heures et une période d'analyse de 24 heures au maximum. La somme de la durée et de la période d'analyse ne doit pas dépasser 25 heures.

Si votre règle d'alerte Prometheus fait référence à une métrique personnalisée, vous devez d'abord disposer d'un descripteur de la métrique personnalisée équivalent dans Cloud Monitoring.

Tarification

En général, les métriques système de Cloud Monitoring sont gratuites, contrairement aux métriques de systèmes, d'agents ou d'applications externes. Les métriques facturables sont facturées en fonction du nombre d'octets ou du nombre d'échantillons ingérés.

Pour en savoir plus sur les tarifs de Cloud Monitoring, consultez les documents suivants:

Étapes suivantes

Pour en savoir plus sur l'utilisation de la console Google Cloud pour créer des règles d'alerte avec une requête PromQL dans la condition, consultez la section Créer des règles d'alerte avec une condition basée sur PromQL (console).

Pour savoir comment créer des règles d'alerte avec PromQL directement à l'aide de l'API Cloud Monitoring, consultez la page Créer des règles d'alerte avec une condition basée sur PromQL (API).

Pour en savoir plus sur la migration des règles d'alerte PromQL vers les règles d'alerte avec une requête PromQL, consultez Migrer les règles d'alerte et les destinataires depuis Prometheus.

Pour en savoir plus sur l'importation de tableaux de bord Grafana, consultez la page Importer des tableaux de bord Grafana dans Cloud Monitoring.