Abfrage mit Cloud Monitoring

Nachdem Sie Google Cloud Managed Service for Prometheus bereitgestellt haben, können Sie die an den verwalteten Dienst gesendeten Daten abfragen und die Ergebnisse in Diagrammen und Dashboards darstellen.

In diesem Dokument werden Messwertbereiche beschrieben, mit denen die abfragbaren Daten bestimmt werden, und die Verwendung von Cloud Monitoring zum Abrufen und Verwenden der erhobenen Daten.

Alle Abfrageschnittstellen für Managed Service for Prometheus sind so konfiguriert, dass Daten mit der Cloud Monitoring API aus Monarch abgerufen werden. Durch die Abfrage von Monarch anstelle der Abfrage von lokalen Prometheus-Servern erhalten Sie umfassendes globales Monitoring.

Vorbereitung

Wenn Sie den verwalteten Dienst noch nicht bereitgestellt haben, richten Sie die verwaltete Erfassung oder die selbst bereitgestellte Erfassung ein. Sie können diesen Schritt überspringen, wenn Sie nur Cloud Monitoring-Messwerte mit PromQL abfragen möchten.

Abfragen und Messwertbereiche

Die Daten, die Sie abfragen können, werden durch den Messwertbereich von Cloud Monitoring-Konstrukten festgelegt, unabhängig von der Methode, die Sie zum Abfragen der Daten verwenden.

Ein Monitoring-Messwertbereich ist ein schreibgeschütztes Konstrukt, mit dem Sie Messwertdaten abfragen können, die zu mehreren Google Cloud-Projekten gehören. Jeder Messwertbereich wird von einem festgelegten Google Cloud-Projekt gehostet, dem sogenannten Scoping-Projekt.

Standardmäßig ist ein Projekt das den Bereich festlegende Projekt für den eigenen Messwertbereich und der Messwertbereich enthält die Messwerte und die Konfiguration für dieses Projekt. Ein den Bereich festlegendes Projekt kann mehrere überwachte Projekte in seinem Messwertbereich enthalten und die Messwerte und Konfigurationen aus allen überwachten Projekten im Messwertbereich sind für das den Bereich festlegende Projekt sichtbar. Ein überwachtes Projekt kann auch zu mehreren Messwertbereichen gehören.

Wenn Sie die Messwerte in einem den Bereich festlegenden Projekt abfragen und dieses Projekt einen Messwertbereich für mehrere Projekte hostet, können Sie Daten aus mehreren Projekten abrufen. Wenn der Messwertbereich alle Ihre Projekte enthält, werden Ihre Abfragen und Regeln global ausgewertet.

Weitere Informationen zu den Bereich festlegenden Projekten und Messwertbereichen finden Sie unter Messwertbereiche. Informationen zum Konfigurieren eines Messwertbereichs für mehrere Projekte finden Sie unter Messwerte für mehrere Projekte ansehen.

Managed Service for Prometheus-Daten in Cloud Monitoring

Managed Service for Prometheus nutzt das Datenspeicher-Backend Monarch für Cloud Monitoring. Sie können alle von Cloud Monitoring bereitgestellten Tools mit den von Managed Service for Prometheus erhobenen Daten verwenden. Sie können beispielsweise Metrics Explorer verwenden, wie in Google Cloud Console für Monitoring beschrieben, und Sie können Benachrichtigungen basierend auf diesen Messwerten festlegen. Sie können auch Ihre Grafana-Dashboards in Cloud Monitoring importieren.

Wenn Sie mit Messwertdaten arbeiten, einschließlich Daten aus dem verwalteten Dienst für Prometheus, können Sie in Cloud Monitoring die von Cloud Monitoring bereitgestellten Abfrageparameter verwenden:

Mit PromQL in Cloud Monitoring abfragen

Die einfachste Möglichkeit zum Abfragen Ihrer Prometheus-Daten ist die Verwendung der Cloud Monitoring-Seite "Metrics Explorer" in der Google Cloud Console. So prüfen Sie, ob Ihre Prometheus-Daten korrekt erfasst werden:

Wählen Sie im Navigationsbereich der Google Cloud Console Monitoring und anschließend Metrics Explorer aus:
Zum Metrics Explorer
Klicken Sie in der Symbolleiste des Bereichs "Query Builder" auf die Schaltfläche MQL oder PromQL.
Prüfen Sie, ob PromQL in der Ein-/Aus-Schaltfläche Sprache ausgewählt ist. Die Sprachschaltfläche befindet sich in derselben Symbolleiste, mit der Sie Ihre Abfrage formatieren können.
Geben Sie im Editor folgende Abfrage ein und klicken Sie dann auf Abfrage ausführen:
```
up
```

Wenn Ihre Daten aufgenommen werden, sehen Sie ein Diagramm wie das folgende:

Metrics Explorer-Diagramm für den Messwert „Managed Service for Prometheus“.

Informationen zum Abfragen von Cloud Monitoring-Systemmesswerten mit PromQL finden Sie unter PromQL für Cloud Monitoring-Messwerte.

Weitere Informationen zur Verwendung von PromQL in Metrics Explorer- und Cloud Monitoring-Diagrammen finden Sie unter PromQL in Cloud Monitoring.

Weitere Abfrageoptionen in Cloud Monitoring

Wenn Sie Ihre Prometheus-Daten als Cloud Monitoring-Zeitachse aufrufen und Diagramme und Dashboards erstellen möchten, können Sie auch die menübasierten Schnittstellen oder MQL verwenden. Im Folgenden sehen Sie eine einfache Abfrage im Metrics Explorer:

Wählen Sie im Navigationsbereich der Google Cloud Console Monitoring und anschließend Metrics Explorer aus:
Zum Metrics Explorer
Geben Sie die Daten an, die im Diagramm angezeigt werden sollen. Zusätzlich zur zuvor beschriebenen Schaltfläche PromQL können Sie auch die menügesteuerte Benutzeroberfläche verwenden. So erstellen Sie eine Abfrage:
1. Klicken Sie im Bereich "Query Builder" auf "Messwert auswählen".
2. Geben Sie im Suchfeld "up/" ein, um die Liste zu filtern, und wählen Sie Prometheus-Ziel aus. Dann wählen Sie Hoch und anschließend Prometheus/Up/Gauge aus.
3. Klicken Sie auf "Anwenden".

Das aus dieser Abfrage resultierende Diagramm zeigt dieselben Daten wie das Diagramm im PromQL-Beispiel.

Abfragen, die mithilfe der menübasierten Oberfläche erstellt werden, können durch Klicken auf die Schaltfläche PromQL in PromQL konvertiert werden. Bei dieser Übersetzung werden Histogrammfunktionen oder andere ungewöhnliche Operatoren möglicherweise nicht richtig konvertiert.

`prometheus_target`-Ressource

In Cloud Monitoring werden Zeitachsendaten für einen Typ von überwachter Ressource geschrieben. Bei Prometheus-Messwerten lautet der Typ der überwachten Ressource prometheus_target. Monitoring-Abfragen für Prometheus-Messwerte, die nicht in PromQL geschrieben sind, müssen diesen Ressourcentyp angeben.

Die Ressource prometheus_target hat die folgenden Labels, die Sie zum Filtern und Bearbeiten von abgefragten Daten verwenden können:

project_id: Die Kennung des Google Cloud-Projekts, das dieser Ressource zugeordnet ist.
location: Der physische Standort (Google Cloud-Region), an dem die Daten gespeichert werden. Dieser Wert ist in der Regel die Region Ihres GKE-Clusters oder Ihrer Compute Engine-Instanz. Wenn Daten aus einer AWS- oder lokalen Bereitstellung erhoben werden, ist der Wert möglicherweise die nächstgelegene Cloud-Projektregion.
cluster: Der GKE-Cluster oder das zugehörige Konzept. Kann leer sein.
namespace: Der GKE-Namespace oder das zugehörige Konzept. Kann leer sein.
job: Das Joblabel des Prometheus-Ziels, sofern bekannt. Kann für Ergebnisse der Regelauswertung leer sein.
instance: Das Instanzlabel des Prometheus-Ziels, sofern bekannt. Kann für Ergebnisse der Regelauswertung leer sein.

Die Werte für diese Labels werden während der Erfassung festgelegt.