Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# 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.
1. Im Seitenmenü sollten Sie unter dem Link **Dashboards** den Link **Datenquellen** finden.
1. Wählen Sie in der oberen Kopfzeile die Schaltfläche **\$1 Datenquelle hinzufügen**.
1. Wählen Sie in der Dropdownliste **Typ** die Option **Google Cloud Monitoring** aus.
1. 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 | Description |
| --- | --- |
| 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.
#### Aktivieren APIs
Folgendes APIs muss zuerst aktiviert werden:
+ [Überwachungs-API](https://console.cloud.google.com/apis/library/monitoring.googleapis.com)
+ [Cloud Resource Manager-API](https://console.cloud.google.com/apis/library/cloudresourcemanager.googleapis.com)
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 APIs den Anmeldeinformationen für Dienste](https://console.cloud.google.com/apis/credentials).
1. Wählen Sie die Option „**Anmeldeinformationen erstellen**“ dropdown/button und anschließend die Option „**Dienstkontoschlüssel**“.
\$1\$1< docs-imagebox img=“/img/docs/v71/cloudmonitoring\$1create\$1service\$1account\$1button.png "class="docs-image—no-shadow“ caption="Schaltfläche „Dienstkonto erstellen“ >\$1\$1
1. **Wählen Sie auf der Seite** Dienstkontoschlüssel `JSON` erstellen den Schlüsseltyp aus. Wählen Sie dann in der Dropdownliste **Dienstkonto** die Option **Neues Dienstkonto** aus.
\$1\$1< docs-imagebox img=“/img/docs/v71/cloudmonitoring\$1create\$1service\$1account\$1key.png "class="docs-image—no-shadow“ caption="Dienstkontoschlüssel erstellen“ >\$1\$1
1. Einige neue Felder werden erscheinen. Geben Sie im Feld Dienstkontoname einen **Namen für das Dienstkonto** ein und wählen Sie dann die Rolle **Monitoring Viewer** aus der Dropdownliste **Rolle** aus.
\$1\$1< docs-imagebox img=“/img/docs/v71/cloudmonitoring\$1service\$1account\$1choose\$1role.png "class="docs-image—no-shadow“ caption="Rolle wählen“ >\$1\$1
1. 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.
1. 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.
\$1\$1< docs-imagebox img=“/img/docs/v71/cloudmonitoring\$1grafana\$1upload\$1key.png "class="docs-image—no-shadow“ caption="Dienstschlüsseldatei nach Grafana hochladen“ >\$1\$1
1. Der Dateiinhalt wird verschlüsselt und in der Grafana-Datenbank gespeichert. Vergessen Sie nicht, nach dem Hochladen der Datei zu speichern\$1
\$1\$1< docs-imagebox img=“/img/docs/v71/cloudmonitoring\$1grafana\$1key\$1uploaded.png "class="docs-image—no-shadow“ caption="Die Dienstschlüsseldatei wurde nach Grafana hochgeladen“ >\$1\$1
## Verwenden des Abfrage-Editors
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 group/aggregate nach Bezeichnungen und nach Zeit auswählen 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.
1. Wählen Sie ein Projekt aus der Dropdownliste **Projekt** aus.
1. Wählen Sie einen Google Cloud Platform-Dienst aus der Dropdownliste **Dienst** aus.
1. Wählen Sie eine Metrik aus der Dropdownliste **Metrik** aus.
1. 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, ist `=` `!=` es möglich, dem Filterwertfeld Platzhalterzeichen hinzuzufügen. `us-*`Erfasst beispielsweise alle Werte, die mit „us-“ beginnen, und `*central-a` erfasst alle Werte, die mit „central-a“ enden. `*-central-*`erfasst alle Werte mit der Teilzeichenfolge von. `central-` Einfache Platzhalterzeichen sind kostengünstiger als reguläre Ausdrücke.
##### Reguläre Ausdrücke
Wenn der Operator auf oder gesetzt `=~` `!=~` ist, können dem Filterwertfeld reguläre Ausdrücke hinzugefügt werden. 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](https://cloud.google.com/monitoring/charts/metrics-selector#aggregation-options).
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](https://cloud.google.com/monitoring/charts/metrics-selector#alignment).
##### 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](variables-types.md#add-an-interval-variable).
Es ist auch möglich, feste Zeitintervalle für die Gruppierung auszuwählen, z. B. `1h` oder`1d`.
#### 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\$1name, 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 „Metrisch“
| Alias-Muster | Description | Beispielergebnis |
| --- | --- | --- |
| \$1\$1metric.type\$1\$1 | Gibt den vollständigen metrischen Typ zurück. | compute.googleapis.com/instance/cpu/utilization |
| \$1\$1metric.name\$1\$1 | Gibt den Teil des Metriknamens zurück. | instance/cpu/utilization |
| \$1\$1metric.service\$1\$1 | 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 | Description | Beispiel für ein Alias-Muster | Beispielergebnis |
| --- | --- | --- | --- |
| \$1\$1metric.label.xxx\$1\$1 | Gibt den Wert der Metrikbezeichnung zurück. | \$1\$1metric.label.instance\$1name\$1\$1 | grafana-1-prod |
| \$1\$1resource.label.xxx\$1\$1 | Gibt den Wert der Ressourcenbeschriftung zurück. | \$1\$1resource.label.zone\$1\$1 | us-east1-b |
| \$1\$1metadata.system\$1labels.xxx\$1\$1 | Gibt den Labelwert des Metadatensystems zurück. | \$1\$1metadata.system\$1labels.name\$1\$1 | grafana |
| \$1\$1metadata.user\$1labels.xxx\$1\$1 | Gibt den Wert der Benutzerbeschriftung für Metadaten zurück. | \$1\$1metadata.user\$1labels.tag\$1\$1 | 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 | Description | Beispielergebnis |
| --- | --- | --- |
| \$1\$1resource.type\$1\$1 | Gibt den Namen des überwachten Ressourcentyps zurück. | gce\$1instance |
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\$1 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](https://cloud.google.com/monitoring/service-monitoring) 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.
1. Wählen Sie ein Projekt aus der Dropdownliste **Projekt** aus.
1. Wählen Sie einen [SLO-Service](https://cloud.google.com/monitoring/api/ref_v3/rest/v3/services) aus der Dropdownliste **Service** aus.
1. Wählen Sie einen [SLO](https://cloud.google.com/monitoring/api/ref_v3/rest/v3/services.serviceLevelObjectives) aus der **SLO-Dropdown-Liste** aus.
1. Wählen Sie einen [Zeitreihen-Selektor](https://cloud.google.com/monitoring/service-monitoring/timeseries-selectors#ts-selector-list) 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\$1slo\$1health |
| SLO-Konformität | select\$1slo\$1compliance |
| SLO-Fehler: Verbleibendes Budget | select\$1slo\$1budget\$1fraction |
#### 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 | Description | Beispielergebnis |
| --- | --- | --- |
| \$1\$1project\$1\$1 | Gibt den GCP-Projektnamen zurück. | myProject |
| \$1\$1service\$1\$1 | Gibt den Dienstnamen zurück. | myService |
| \$1\$1slo\$1\$1 | Gibt den SLO zurück. | latency-slo |
| \$1\$1selector\$1\$1 | Gibt den Selektor zurück. | select\$1slo\$1health |
#### 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](#google-metric-queries).
## 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](templates-and-variables.md)
### 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 Folgendes`Query Types`.
| Name | Description |
| --- | --- |
| 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:
+ `$` 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 Labels 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. Die Anzeige von Anmerkungen und Ereignissen in Google Cloud Monitoring wird noch nicht unterstützt, funktioniert aber gut mit [benutzerdefinierten Messwerten](https://cloud.google.com/monitoring/custom-metrics/) in Google Cloud Monitoring.
Weitere Informationen zu Anmerkungen finden Sie unter. [Anmerkungen](dashboard-annotations.md)
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 | Description | Beispiel für ein Alias-Muster | Beispielergebnis |
| --- | --- | --- | --- |
| \$1\$1metric.value\$1\$1 | Wert der Metrik/des Punkts. | \$1\$1metric.value\$1\$1 | 555 |
| \$1\$1metric.type\$1\$1 | Gibt den vollständigen metrischen Typ zurück. | \$1\$1metric.type\$1\$1 | compute.googleapis.com/instance/cpu/utilization |
| \$1\$1metric.name\$1\$1 | Gibt den Teil des Metriknamens zurück. | \$1\$1metric.name\$1\$1 | instance/cpu/utilization |
| \$1\$1metric.service\$1\$1 | Gibt den Serviceteil zurück. | \$1\$1metric.service\$1\$1 | compute |
| \$1\$1metric.label.xxx\$1\$1 | Gibt den Wert der Metrikbezeichnung zurück. | \$1\$1metric.label.instance\$1name\$1\$1 | grafana-1-prod |
| \$1\$1resource.label.xxx\$1\$1 | Gibt den Wert der Ressourcenbeschriftung zurück. | \$1\$1resource.label.zone\$1\$1 | 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.