In diesem Dokument wird die Verwendung von Prometheus Query Language (PromQL) in Cloud Monitoring beschrieben. PromQL bietet eine Alternative zu den menübasierten Schnittstellen des Metrics Explorer und zu den MQL-Schnittstellen (Monitoring Query Language) zum Erstellen von Diagrammen und Dashboards.
Mit PromQL können Sie Cloud Monitoring-Daten aus den folgenden Quellen abfragen und in Diagrammen darstellen:
- Google Cloud-Dienste wie Google Kubernetes Engine oder Compute Engine, die Messwerte schreiben, die in der Liste der Cloud Monitoring-Systemmesswerte beschrieben sind.
- Benutzerdefinierte Messwerte wie logbasierte Messwerte und benutzerdefinierte Messwerte von Cloud Monitoring
- Google Cloud Managed Service for Prometheus, die vollständig verwaltete Multi-Cloud-Lösung für Prometheus von Google Cloud. Informationen zum verwalteten Dienst, einschließlich Support durch PromQL, finden Sie unter Google Cloud Managed Service for Prometheus.
Sie können auch Tools wie Grafana verwenden, um in Cloud Monitoring aufgenommene Messwertdaten grafisch darzustellen. Zu den verfügbaren Messwerten gehören Messwerte aus Managed Service for Prometheus und Cloud Monitoring-Messwerten, die in den Listen der Messwerte dokumentiert sind. Informationen zum Einrichten von Grafana und anderen Tools, die auf der Prometheus API basieren, finden Sie in der Dokumentation zu Managed Service for Prometheus zu Grafana.
Sie können auch Ihre Grafana-Dashboards in Cloud Monitoring importieren.
Namenskonventionen
Das Messwertmodell und die Namenskonventionen von Prometheus unterscheiden sich von denen, die von Cloud Monitoring verwendet werden. Wenn Sie PromQL zum Abfragen von Monitoring-Messwertdaten verwenden möchten, müssen Sie Cloud Monitoring-Namen in PromQL-kompatible Äquivalente umwandeln. Informationen zu den Namenskonventionen finden Sie unter Cloud Monitoring-Messwerte zu PromQL zuordnen.
Auf PromQL in Cloud Monitoring zugreifen
Sie können PromQL in der Google Cloud Console auf dem Tab Code auf den folgenden Seiten verwenden:
- Metrics Explorer
- Diagramm hinzufügen, wenn Sie benutzerdefinierte Dashboards erstellen
Informationen zum Aufrufen und Verwenden des Editors finden Sie unter PromQL-Editor verwenden.
Prometheus-Regeln und -Benachrichtigungen
Mit PromQL können Sie Aufnahme- und Benachrichtigungsregeln für jeden Messwert in Cloud Monitoring erstellen. Dazu verwenden Sie Benachrichtigungen im Prometheus-Stil in Managed Service for Prometheus. Weitere Informationen finden Sie unter Auswertung und Benachrichtigung von verwalteten Regeln oder Selbst bereitgestellte Regelauswertung und -benachrichtigung.
PromQL lernen
Grundlagen zur Verwendung von PromQL erhalten Sie in der Open-Source-Dokumentation. Die folgenden Ressourcen können Ihnen den Einstieg erleichtern:
Unterschiede bei PromQL
PromQL für Cloud Monitoring funktioniert möglicherweise etwas anders als die Upstream-PromQL. Eine Liste dieser Unterschiede finden Sie unter PromQL-Unterschiede.