Ce document décrit l'utilisation du langage de requête Prometheus (PromQL) dans Cloud Monitoring. PromQL offre une alternative Interfaces MQL (Monitoring Query Language) et interfaces pilotées par un menu de l'Explorateur de métriques des graphiques et des tableaux de bord.
Vous pouvez utiliser PromQL pour interroger et représenter des graphiques Données Cloud Monitoring provenant des sources suivantes:
- Les services Google Cloud, tels que Google Kubernetes Engine ou Compute Engine, qui écrivent décrites dans les listes des API Cloud Monitoring les métriques système.
- Les métriques définies par l'utilisateur, comme 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 le service géré, y compris sur l'assistance, de PromQL, consultez la page 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 les métriques Les métriques Managed Service pour Prometheus et Cloud Monitoring décrites 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 Documentation de 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 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 à partir de l'onglet Code sur les pages suivantes dans 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 de Managed Service pour Prometheus. Pour en savoir plus, consultez Évaluation des règles et alertes gérées ou Auto-déployé l'évaluation des règles et les alertes.
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 par rapport à PromQL en amont. Pour obtenir la liste de ces différences, consultez la page Différences PromQL.