Règles d'alerte avec PromQL

Cette page explique 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 vos règles 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 en dehors de Google Cloud ou si vous utilisez des alertes 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. Vous pouvez ainsi 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 la gcloud CLI ou de la construction AlertPolicy dans l'API Monitoring.

  • Migrez vos règles d'alerte et canaux de notification Prometheus 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 vos règles d'alerte PromQL peuvent faire référence à n'importe quelle métrique de 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 des métriques Monitoring à PromQL.

Restrictions

Une règle d'alerte avec une condition basée sur PromQL peut avoir une période de réessai de 24 heures maximum et une période d'alignement de 24 heures maximum. La somme de la période de réévaluation et de la période d'alignement 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.

Tarifs

En général, les métriques système Cloud Monitoring sont gratuites, contrairement aux métriques provenant 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 la tarification de Cloud Monitoring, consultez les documents suivants:

Étape suivante

Pour savoir comment utiliser 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 section Créer des règles d'alerte avec une condition basée sur PromQL (API).

Pour savoir comment migrer des règles d'alerte PromQL vers des règles d'alerte avec une requête PromQL, consultez la page Migrer des règles d'alerte et des récepteurs 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.