In diesem Dokument wird die Verwendung der Prometheus Query Language (PromQL) in Cloud Monitoring beschrieben. PromQL ist eine Alternative zur menügesteuerten Benutzeroberfläche des Metrics Explorer und zur Monitoring Query Language (MQL) zum Erstellen von Diagrammen und Dashboards.
Mit PromQL können Sie Cloud Monitoring-Daten aus den folgenden Quellen abfragen und grafisch darstellen:
- Google Cloud-Dienste wie Google Kubernetes Engine oder Compute Engine, die Messwerte schreiben, die in den Listen der Systemmesswerte von Cloud Monitoring beschrieben sind.
- Benutzerdefinierte Messwerte, z. B. logbasierte Messwerte und benutzerdefinierte Messwerte in 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 Unterstützung durch PromQL, finden Sie unter Google Cloud Managed Service for Prometheus.
Sie können auch Tools wie Grafana verwenden, um Messwertdaten, die in Cloud Monitoring aufgenommen wurden, in Diagrammen darzustellen. Zu den verfügbaren Messwerten gehören Messwerte aus Managed Service for Prometheus und Cloud Monitoring, 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 Managed Service for Prometheus-Dokumentation unter Grafana.
Sie können auch Ihre Grafana-Dashboards in Cloud Monitoring importieren.
Namenskonventionen
Das Prometheus-Messwertmodell und die Benennungskonventionen unterscheiden sich von denen, die in Cloud Monitoring verwendet werden. Wenn Sie Cloud Monitoring-Messwertdaten mit PromQL abfragen möchten, müssen Sie Cloud Monitoring-Namen in PromQL-kompatible Äquivalente umwandeln. Informationen zu den Benennungskonventionen finden Sie unter Cloud Monitoring-Messwerte PromQL zuordnen.
Zugriff auf PromQL in Cloud Monitoring
Sie können PromQL auf den folgenden Seiten in der Google Cloud Console auf dem Tab Code verwenden:
- Metrics Explorer
- Diagramm hinzufügen, wenn Sie benutzerdefinierte Dashboards erstellen
Informationen zum Zugriff auf den Editor und zur Verwendung finden Sie unter PromQL-Editor verwenden.
Prometheus-Regeln und -Benachrichtigungen
Sie können mit PromQL Aufnahme- und Benachrichtigungsregeln für jeden Messwert in Cloud Monitoring erstellen, indem Sie Benachrichtigungen im Prometheus-Stil im Managed Service for Prometheus verwenden. Weitere Informationen finden Sie unter Verwaltete Regelauswertung und Benachrichtigungen 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 Upstream-PromQL. Eine Liste dieser Unterschiede finden Sie unter PromQL-Unterschiede.