Ce document décrit l'utilisation du langage de requête Prometheus (PromQL) dans Cloud Monitoring. PromQL offre une alternative à l'interface de MQL ou à celle de l'Explorateur de métriques, qui est basée sur des menus, pour créer des graphiques et des tableaux de bord.
Vous pouvez utiliser PromQL pour interroger des données Cloud Monitoring et les représenter 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, le service multicloud pour Prometheus Google Cloud. Pour en savoir plus sur ce service géré, y compris la compatibilité de PromQL, consultez Google Cloud Managed Service pour Prometheus.
Vous pouvez également utiliser des outils tels que Grafana pour représenter les données de métriques ingérées sous forme de graphique Cloud Monitoring. Les métriques disponibles incluent celles de Managed Service pour Prometheus et celles de Cloud Monitoring indiqué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 sur Managed Service pour Prometheus sur Grafana.
Vous pouvez également importer vos tableaux de bord Grafana dans Cloud Monitoring.
Conventions d'attribution de noms
Le modèle de métrique Prometheus et les conventions de dénomination diffèrent de ceux utilisés par Cloud Monitoring. Utiliser PromQL pour effectuer des requêtes Cloud Monitoring, vous devez convertir en équivalents compatibles avec PromQL. Pour en savoir plus sur la d'attribution de noms, consultez la section Mapper les métriques Cloud Monitoring PromQL :
Accéder à PromQL dans Cloud Monitoring
Vous pouvez utiliser PromQL depuis 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 style Prometheus dans Managed Service pour Prometheus. Pour en savoir plus, consultez les sections Évaluation et alerte des règles gérées ou Évaluation et alerte des 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 celui de PromQL en amont. Pour obtenir la liste de ces différences, consultez la page Différences PromQL.