Stellen Sie eine Connect zu einer Google Cloud Monitoring-Datenquelle her

Anmerkung

In früheren Versionen von Grafana wurde diese Datenquelle Google Stackdriver genannt.

Fügen Sie die Google Cloud Monitoring-Datenquelle hinzu, um Dashboards für Ihre Google Cloud Monitoring-Metriken erstellen zu können.

Die Datenquelle hinzufügen

1. Öffnen Sie das Seitenmenü, indem Sie das Grafana-Symbol in der oberen Kopfzeile auswählen.

2. Im Seitenmenü sollten Sie unter dem Link Dashboards den Link Datenquellen finden.

3. Wählen Sie in der oberen Kopfzeile die Schaltfläche + Datenquelle hinzufügen.

4. Wählen Sie in der Dropdownliste Typ die Option Google Cloud Monitoring aus.

5. Laden Sie die Schlüsseldatei für das Dienstkonto hoch oder fügen Sie sie ein. Schritte zum Erstellen einer Service Account-Schlüsseldatei finden Sie weiter unten in diesem Dokument.

Anmerkung

Wenn Sie den Link Datenquellen nicht in Ihrem Seitenmenü sehen, hat Ihr aktueller Benutzer die Admin Rolle nicht.

Name	Beschreibung
Name	Der Name der Datenquelle. So beziehen Sie sich in Bedienfeldern und Abfragen auf die Datenquelle.
Default	Die Standarddatenquelle bedeutet, dass sie für neue Panels vorausgewählt wird.
Service Account Key	Schlüsseldatei für ein Dienstkonto für ein GCP-Projekt. Anweisungen zur Erstellung finden Sie weiter unten in diesem Dokument.

Authentifizierung

Es gibt zwei Möglichkeiten, das Google Cloud Monitoring-Plugin zu authentifizieren

• Laden Sie eine Google JWT-Datei hoch

• Automatisches Abrufen von Anmeldeinformationen vom Google-Metadatenserver

Die letztere Option ist nur verfügbar, wenn Grafana auf einer virtuellen GCE-Maschine ausgeführt wird.

Verwenden einer Schlüsseldatei für ein Google-Dienstkonto

Um sich mit der Google Cloud Monitoring API zu authentifizieren, müssen Sie ein Google Cloud Platform (GCP) -Dienstkonto für das Projekt erstellen, für das Sie Daten anzeigen möchten. Eine Grafana-Datenquelle ist in ein GCP-Projekt integriert. Um Daten aus mehreren GCP-Projekten zu visualisieren, müssen Sie eine Datenquelle pro GCP-Projekt erstellen.

APIs aktivieren

Die folgenden APIs müssen zuerst aktiviert werden:

• Überwachungs-API

• Cloud Resource Manager-API

Wählen Sie die aufgelisteten Links aus und klicken Sie dann auf die Schaltfläche Aktivieren.

Ein GCP-Dienstkonto für ein Projekt erstellen

1. Navigieren Sie zur Seite mit den Anmeldeinformationen für APIs und Dienste.

2. Wählen Sie die Dropdown-/Schaltfläche Anmeldeinformationen erstellen und wählen Sie die Option Dienstkontoschlüssel aus.

   {{< docs-imagebox img=“ /img/docs/v71/cloudmonitoring_create_service_account_button.png "class="docs-image—no-shadow“ caption="Schaltfläche „Dienstkonto erstellen“ >}}

3. Wählen Sie auf der Seite JSON Dienstkontoschlüssel erstellen den Schlüsseltyp aus. Wählen Sie dann in der Dropdownliste Dienstkonto die Option Neues Dienstkonto aus.

   {{< docs-imagebox img=“ /img/docs/v71/cloudmonitoring_create_service_account_key.png "class="docs-image—no-shadow“ caption="Dienstkontoschlüssel erstellen“ >}}

4. Es werden einige neue Felder erscheinen. Geben Sie einen Namen für das Dienstkonto in das Feld Dienstkontoname ein und wählen Sie dann die Rolle Monitoring Viewer aus der Dropdownliste Rolle aus.

   {{< docs-imagebox img=“ /img/docs/v71/cloudmonitoring_service_account_choose_role.png "class="docs-image—no-shadow“ caption="Rolle wählen“ >}}

5. Wählen Sie die Schaltfläche Erstellen aus. Eine JSON-Schlüsseldatei wird erstellt und auf Ihren Computer heruntergeladen. Speichern Sie diese Datei an einem sicheren Ort, da sie den Zugriff auf Ihre Google Cloud Monitoring-Daten ermöglicht.

6. Laden Sie es auf der Konfigurationsseite der Datenquelle in Grafana hoch. Sie können die Datei entweder hochladen oder den Inhalt der Datei einfügen.

   {{< docs-imagebox img=“ /img/docs/v71/cloudmonitoring_grafana_upload_key.png "class="docs-image—no-shadow“ caption="Dienstschlüsseldatei nach Grafana hochladen“ >}}

7. Der Dateiinhalt wird verschlüsselt und in der Grafana-Datenbank gespeichert. Vergessen Sie nicht, nach dem Hochladen der Datei zu speichern!

   {{< docs-imagebox img=“ /img/docs/v71/cloudmonitoring_grafana_key_uploaded.png "class="docs-image—no-shadow“ caption="Die Service-Schlüsseldatei wurde nach Grafana hochgeladen“ >}}

Arbeiten mit dem Abfrage-Editor

Mit dem Google Cloud Monitoring-Abfrage-Editor können Sie zwei Arten von Abfragen erstellen: Metric und Service Level Objective (SLO). Beide Typen geben Zeitreihendaten zurück.

Metrische Abfragen

Mit dem Metrik-Abfrage-Editor können Sie Metriken auswählen, nach Labels und nach Zeit gruppieren/aggregieren und mithilfe von Filtern angeben, welche Zeitreihen in den Ergebnissen enthalten sein sollen.

Gehen Sie folgendermaßen vor, um eine Metrikabfrage zu erstellen:

1. Wählen Sie in der Dropdownliste Abfragetyp die Option Metriken aus.

2. Wählen Sie ein Projekt aus der Dropdownliste Projekt aus.

3. Wählen Sie einen Google Cloud Platform-Dienst aus der Dropdownliste Dienst aus.

4. Wählen Sie eine Metrik aus der Dropdownliste Metrik aus.

5. Um Filter hinzuzufügen oder zu entfernen oder nach Klauseln zu gruppieren, verwenden Sie die Plus- und Minus-Symbole in den Abschnitten Filter und Gruppieren nach. Dieser Schritt ist optional.

Google Cloud Monitoring-Metriken können unterschiedlicher Art sein (GAUGE, DELTA, CUMULATIVE), und diese Typen unterstützen verschiedene Aggregationsoptionen (Reducers und Aligner). Der Grafana-Abfrage-Editor zeigt die Liste der verfügbaren Aggregationsmethoden für eine ausgewählte Metrik an und legt bei der Auswahl der Metrik einen Standard-Reducer und -Aligner fest. Einheiten für die Y-Achse werden ebenfalls automatisch vom Abfrage-Editor ausgewählt.

Filter

Um einen Filter hinzuzufügen, klicken Sie auf das Plussymbol, wählen Sie ein Feld aus, nach dem gefiltert werden soll, und geben Sie einen Filterwert ein. Geben Sie z. B. ei instance_name = grafana-1. Sie können den Filter entfernen, indem Sie den Filternamen auswählen und dann auswählen--remove filter--.

Einfache Platzhalterzeichen

Wenn der Operator auf oder gesetzt = != ist, können dem Filterwertfeld Platzhalterzeichen hinzugefügt werden. us-*Erfasst beispielsweise alle Werte, die mit „us-“ beginnen, und *central-a erfasst alle Werte, die mit „central-a“ enden. *-central-*erfasst alle Werte, die die Teilzeichenfolge von haben. central- Einfache Platzhalterzeichen sind kostengünstiger als reguläre Ausdrücke.

Reguläre Ausdrücke

Wenn der Operator auf oder gesetzt ist, ist =~ !=~ es möglich, dem Filterwertfeld reguläre Ausdrücke hinzuzufügen. Entspricht beispielsweise us-central[1-3]-[af] allen Werten, die mit „us-central“ beginnen, gefolgt von einer Zahl im Bereich von 1 bis 3, einem Gedankenstrich und dann entweder einem „a“ oder einem „f“. Führende und nachgestellte Schrägstriche sind bei der Erstellung regulärer Ausdrücke nicht erforderlich.

Aggregation

Mit dem Aggregationsfeld können Sie Zeitreihen kombinieren, die auf gemeinsamen Statistiken basieren. Weitere Informationen zur Aggregation finden Sie unter Aggregationsoptionen.

In Aligner diesem Feld können Sie mehrere Zeitreihen nach derselben Gruppe nach Zeitintervallen ausrichten. Weitere Informationen zum Aligner finden Sie unter Alignment Metric Selector.

Ausrichtungszeitraum und Gruppierung nach Zeit

Sie Alignment Period gruppiert eine Metrik nach Zeit, wenn eine Aggregation ausgewählt wird. Standardmäßig werden die Standardgruppierungen von GCP Google Cloud Monitoring verwendet (mit denen Sie Diagramme in Grafana mit Diagrammen in der Google Cloud Monitoring-Benutzeroberfläche vergleichen können). Die Option wird aufgerufen cloud monitoring auto und die Standardeinstellungen sind:

• 1 m für Zeitbereiche < 23 Stunden

• 1 m für Zeitbereiche = 23 Stunden und < 6 Tage

• 5 m für Zeitbereiche >= 23 Stunden und= 6 Tage

Die andere automatische Option ist. grafana auto Dadurch wird die Gruppierung automatisch nach Zeit festgelegt, abhängig vom ausgewählten Zeitraum und der Breite des Grafikfensters. Weitere Informationen finden Sie unter Eine Intervallvariable hinzufügen.

Es ist auch möglich, feste Zeitintervalle auszuwählen, nach denen gruppiert werden soll, z. B. 1h oder1d.

Gruppieren nach

Gruppieren Sie nach Ressourcen- oder Metrikbezeichnungen, um die Anzahl der Zeitreihen zu reduzieren und die Ergebnisse nach einer Gruppe nach zu aggregieren. Gruppieren Sie beispielsweise nach instance_name, um eine aggregierte Metrik für eine Compute-Instance anzuzeigen.

Beschriftungen für Metadaten

Labels für Ressourcenmetadaten enthalten Informationen zur eindeutigen Identifizierung einer Ressource in Google Cloud. Metadaten-Labels werden in der Zeitreihenantwort nur zurückgegeben, wenn sie Teil des Segments Gruppieren nach in der Zeitreihenanforderung sind. Es gibt keine API zum Abrufen von Metadaten-Labels, daher ist es nicht möglich, die Dropdownliste „Gruppe nach“ mit den Metadaten-Labels zu füllen, die für den ausgewählten Service und die ausgewählte Metrik verfügbar sind. Die Dropdownliste „Gruppieren nach Feld“ enthält jedoch eine vordefinierte Liste gängiger Systembezeichnungen.

Benutzerbezeichnungen können nicht vordefiniert werden, aber es ist möglich, sie manuell in das Feld Gruppieren nach einzugeben. Wenn ein Metadatenlabel, Benutzerlabel oder Systemlabel im Segment Gruppieren nach enthalten ist, können Sie darauf basierende Filter erstellen und den Wert im Feld Alias erweitern.

Alias-Muster

Mit dem Feld Alias nach können Sie das Format der Legendenschlüssel steuern. Standardmäßig werden der Name und die Beschriftungen der Metrik angezeigt. Dies kann lang und schwer lesbar sein. Mithilfe der folgenden Muster im Aliasfeld können Sie den Legendenschlüssel nach Ihren Wünschen formatieren.

Muster vom Typ Metrik

Alias-Muster	Beschreibung	Beispiel für ein Ergebnis
{{metric.type}}	Gibt den vollständigen metrischen Typ zurück.	compute.googleapis.com/instance/cpu/utilization
{{metric.name}}	Gibt den Teil des Metriknamens zurück.	instance/cpu/utilization
{{metric.service}}	Gibt den Serviceteil zurück.	compute

Muster beschriften

In der Dropdownliste Gruppieren nach finden Sie eine Liste mit Metrik- und Ressourcenbezeichnungen für eine Metrik. Diese können mithilfe von Aliasmustern in den Legendenschlüssel aufgenommen werden.

Alias-Musterformat	Beschreibung	Beispiel für ein Alias-Muster	Beispiel für ein Ergebnis
{{metric.label.xxx}}	Gibt den Kennzeichnungswert der Metrik zurück.	{{metric.label.instance_name}}	grafana-1-prod
{{resource.label.xxx}}	Gibt den Wert der Ressourcenbeschriftung zurück.	{{resource.label.zone}}	us-east1-b
{{metadata.system_labels.xxx}}	Gibt den Labelwert des Metadatensystems zurück.	{{metadata.system_labels.name}}	grafana
{{metadata.user_labels.xxx}}	Gibt den Wert der Benutzerbeschriftung für Metadaten zurück.	{{metadata.user_labels.tag}}	production

Beispiel für einen Alias von: {{metric.type}} - {{metric.label.instance_name}}

Beispiel für ein Ergebnis: compute.googleapis.com/instance/cpu/usage_time - server1-prod

Es ist auch möglich, den Namen des überwachten Ressourcentyps aufzulösen.

Alias-Musterformat	Beschreibung	Beispiel für ein Ergebnis
{{resource.type}}	Gibt den Namen des überwachten Ressourcentyps zurück.	gce_instance

Beispiel für einen Alias von: {{resource.type}} - {{metric.type}}

Beispiel für ein Ergebnis: gce_instance - compute.googleapis.com/instance/cpu/usage_time

SLO-Abfragen

Anmerkung

SLO-Abfragen sind nur in Grafana v7.0+ verfügbar

Mit dem SLO-Abfragegenerator in der Google Cloud Monitoring-Datenquelle können Sie SLO-Daten im Zeitreihenformat anzeigen. Informationen zu den grundlegenden Konzepten der Dienstüberwachung finden Sie in der offiziellen Dokumentation von Google Cloud Monitoring.

Eine SLO-Abfrage erstellen

Gehen Sie folgendermaßen vor, um eine SLO-Abfrage zu erstellen:

1. Wählen Sie in der Dropdownliste Abfragetyp die Option Service Level Objectives (SLO) aus.

2. Wählen Sie ein Projekt aus der Dropdownliste Projekt aus.

3. Wählen Sie einen SLO-Service aus der Dropdownliste Service aus.

4. Wählen Sie einen SLO aus der SLO-Dropdown-Liste aus.

5. Wählen Sie einen Zeitreihen-Selektor aus der Auswahl-Dropdown-Liste aus.

Die benutzerfreundlichen Namen für die Zeitreihenselektoren werden in Grafana angezeigt. Die folgende Tabelle zeigt die Zuordnung zwischen dem Anzeigenamen und dem Systemnamen, der in der Service Monitoring-Dokumentation verwendet wird.

Wert in der Dropdownliste Selector	Entsprechender Zeitreihen-Selektor wurde verwendet
SLI-Wert	select_slo_health
SLO-Konformität	select_slo_compliance
SLO-Fehler: Verbleibendes Budget	select_slo_budget_fraction

Alias-Muster für SLO-Abfragen

Sie können das Feld Alias By verwenden, um das Format der Legendenschlüssel für SLO-Abfragen zu steuern.

Alias-Muster	Beschreibung	Beispiel für ein Ergebnis
{{project}}	Gibt den GCP-Projektnamen zurück.	myProject
{{service}}	Gibt den Dienstnamen zurück.	myService
{{slo}}	Gibt den SLO zurück.	latency-slo
{{selector}}	Gibt den Selektor zurück.	select_slo_health

Ausrichtungszeitraum und Gruppierung nach Zeit für SLO-Abfragen

SLO-Abfragen verwenden dieselbe Funktionalität für den Ausrichtungszeitraum wie metrische Abfragen. Weitere Informationen finden Sie unter Metrische Abfragen.

Erstellung von Vorlagen

Anstatt Dinge wie Server-, Anwendungs- und Sensornamen in Ihren metrischen Abfragen fest zu codieren, können Sie stattdessen Variablen verwenden. Variablen werden als Drop-down-Auswahlfelder oben im Dashboard angezeigt. Sie können diese Dropdown-Felder verwenden, um die in Ihrem Dashboard angezeigten Daten zu ändern.

Weitere Informationen zu Vorlagen und Vorlagenvariablen finden Sie unter. Vorlagen und Variablen

Variable abfragen

Mit der Variablen vom Typ Query können Sie Google Cloud Monitoring nach verschiedenen Datentypen abfragen. Das Google Cloud Monitoring-Datenquellen-Plugin bietet FolgendesQuery Types.

Name	Beschreibung
Metric Types	Gibt eine Liste von Metriktypnamen zurück, die für den angegebenen Dienst verfügbar sind.
Labels Keys	Gibt eine Liste von Schlüsseln für metric label und resource label in der angegebenen Metrik zurück.
Labels Values	Gibt eine Liste von Werten für das Label in der angegebenen Metrik zurück.
Resource Types	Gibt eine Liste von Ressourcentypen für die angegebene Metrik zurück.
Aggregations	Gibt eine Liste von Aggregationen (reihenübergreifende Reduzierungen) für die angegebene Metrik zurück.
Aligners	Gibt eine Liste von Alignern (pro Aligner-Reihe) für die angegebene Metrik zurück.
Alignment periods	Gibt eine Liste aller Ausrichtungsperioden zurück, die im Google Cloud Monitoring-Abfrageeditor in Grafana verfügbar sind.
Selectors	Gibt eine Liste von Selektoren zurück, die in SLO-Abfragen (Service Level Objectives) verwendet werden können.
SLO Services	Gibt eine Liste von Service Monitoring-Diensten zurück, die in SLO-Abfragen verwendet werden können.
Service Level Objectives (SLO)	Gibt eine Liste von SLOs für den angegebenen SLO-Dienst zurück.

Verwenden von Variablen in Abfragen

Es gibt zwei Syntaxen:

• $<varname> Beispiel: metric.label.$metric_label

• [[varname]] Beispiel: metric.label.[[metric_label]]

Warum zwei Möglichkeiten? Die erste Syntax ist einfacher zu lesen und zu schreiben, erlaubt es Ihnen jedoch nicht, eine Variable in der Mitte eines Wortes zu verwenden. Wenn die Optionen Mehrwert oder Alle Werte einbeziehen aktiviert sind, konvertiert Grafana die Beschriftungen von Klartext in eine Regex-kompatible Zeichenfolge, was bedeutet, dass Sie sie anstelle von verwenden müssen. =~ =

Anmerkungen

Sie können Anmerkungen verwenden, um umfangreiche Ereignisinformationen über Grafiken zu legen. Sie fügen Annotationsabfragen über das Dashboard-Menü /die Ansicht Anmerkungen hinzu. Das Rendern von Anmerkungen ist teuer, daher ist es wichtig, die Anzahl der zurückgegebenen Zeilen zu begrenzen. Es gibt noch keine Unterstützung für die Anzeige von Anmerkungen und Ereignissen in Google Cloud Monitoring, aber es funktioniert gut mit benutzerdefinierten Messwerten in Google Cloud Monitoring.

Weitere Informationen zu Anmerkungen finden Sie unter. Anmerkungen

Mit dem Abfrage-Editor für Anmerkungen können Sie eine Metrik und Filter auswählen. Die Felder Titel und Text unterstützen die Erstellung von Vorlagen und können Daten verwenden, die aus der Abfrage zurückgegeben wurden. Das Titelfeld könnte beispielsweise den folgenden Text enthalten:

{{metric.type}} has value: {{metric.value}}

Beispiel für ein Ergebnis: monitoring.googleapis.com/uptime_check/http_status has this value: 502

Muster für den Annotationsabfrage-Editor

Alias-Musterformat	Beschreibung	Beispiel für ein Alias-Muster	Beispiel für ein Ergebnis
{{metric.value}}	Wert der Metrik/des Punkts.	{{metric.value}}	555
{{metric.type}}	Gibt den vollständigen metrischen Typ zurück.	{{metric.type}}	compute.googleapis.com/instance/cpu/utilization
{{metric.name}}	Gibt den Teil des Metriknamens zurück.	{{metric.name}}	instance/cpu/utilization
{{metric.service}}	Gibt den Serviceteil zurück.	{{metric.service}}	compute
{{metric.label.xxx}}	Gibt den Wert der Metrikbezeichnung zurück.	{{metric.label.instance_name}}	grafana-1-prod
{{resource.label.xxx}}	Gibt den Wert der Ressourcenbeschriftung zurück.	{{resource.label.zone}}	us-east1-b

Deep-Linking von Grafana-Panels zum Metrics Explorer in der Google Cloud Console

Anmerkung

Diese Funktion ist nur für metrische Abfragen verfügbar.

Wählen Sie im Panel eine Zeitreihe aus, um ein Kontextmenü mit einem Link zur Ansicht im Metrics Explorer in der Google Cloud Console zu sehen. Wenn Sie diesen Link auswählen, wird der Metrics Explorer in der Google Cloud Console geöffnet und die Abfrage wird dort über das Grafana-Panel ausgeführt. Der Link führt den Nutzer zuerst zur Google-Kontoauswahl. Nach erfolgreicher Auswahl eines Kontos wird der Nutzer zum Metrics Explorer weitergeleitet. Der angegebene Link ist für jedes Konto gültig, aber er zeigt die Abfrage nur an, wenn Ihr Konto Zugriff auf das in der Abfrage angegebene GCP-Projekt hat.