Ce document décrit l'utilisation du langage de requête Prometheus (PromQL) dans Cloud Monitoring. PromQL offre une alternative aux interfaces MQL (Monitoring Query Language) et de menus de l'Explorateur de métriques pour créer des graphiques et des tableaux de bord.
Vous pouvez utiliser PromQL pour interroger et représenter des données Cloud Monitoring dans des graphiques à partir des sources suivantes:
- Les services Google Cloud, tels que Google Kubernetes Engine ou Compute Engine, qui écrivent les métriques décrites dans les listes des métriques système de Cloud Monitoring
- Les métriques définies par l'utilisateur, telles que les métriques basées sur les journaux et les métriques définies par l'utilisateur de Cloud Monitoring
- Google Cloud Managed Service pour Prometheus, la solution multicloud entièrement gérée de Google Cloud pour Prometheus. Pour en savoir plus sur le service géré, y compris la compatibilité de PromQL, consultez la page Google Cloud Managed Service pour Prometheus.
Vous pouvez également utiliser des outils tels que Grafana pour représenter des données de métriques ingérées sous forme de graphique dans Cloud Monitoring. Les métriques disponibles incluent celles de Managed Service pour Prometheus et celles de Cloud Monitoring documentées dans les listes de métriques. Pour en savoir plus sur la configuration de Grafana et d'autres outils basés sur l'API Prometheus, consultez la documentation de Managed Service pour Prometheus sur Grafana.
Vous pouvez également importer vos tableaux de bord Grafana dans Cloud Monitoring.
Conventions de nommage
Le modèle de métrique Prometheus et les conventions de dénomination diffèrent de ceux utilisés par Cloud Monitoring. Pour interroger les données de métriques Monitoring à l'aide de PromQL, vous devez convertir les noms Cloud Monitoring en équivalents compatibles avec PromQL. Pour en savoir plus sur les conventions de dénomination, consultez la section Mapper les métriques Cloud Monitoring sur PromQL.
Accéder à PromQL dans Cloud Monitoring
Vous pouvez utiliser PromQL à partir de l'onglet Code des pages suivantes de la console Google Cloud:
- Explorateur de métriques
- Ajouter un graphique lors de la création de tableaux de bord personnalisés
Pour en savoir plus sur l'accès à l'éditeur et son utilisation, consultez Utiliser l'éditeur PromQL.
Règles et alertes Prometheus
Vous pouvez utiliser PromQL pour créer des règles d'enregistrement et d'alerte sur n'importe quelle métrique dans Cloud Monitoring à l'aide d'alertes de type Prometheus dans Managed Service pour Prometheus. Pour en savoir plus, consultez Évaluation et alertes relatives aux règles gérées ou Évaluation et alertes sur les règles auto-déployées.
Formation PromQL
Pour découvrir les principes de base de l'utilisation de PromQL, nous vous recommandons de consulter la documentation Open Source. Les ressources suivantes peuvent vous aider à démarrer:
Différences PromQL
PromQL pour Cloud Monitoring peut fonctionner légèrement différemment de PromQL en amont. Pour obtenir la liste de ces différences, consultez la page Différences PromQL.