Diese Seite wurde von der Cloud Translation API übersetzt.

Grafana-Dashboards in Cloud Monitoring importieren

In diesem Dokument wird beschrieben, wie Sie Dashboard-Dateien im JSON-Format von Grafana in Cloud Monitoring importieren. Sie haben folgende Möglichkeiten, Grafana-Dashboards zu importieren:

Google Cloud Console verwenden
Mit dem Importer-Tool.

Beim Import werden Dashboard-Dateien im JSON-Format, das von Grafana verwendet wird, in das von Cloud Monitoring verwendete JSON-Format konvertiert. Ein konvertiertes Dashboard kann sich vom ursprünglichen Grafana-Dashboard unterscheiden. Wenn zum Beispiel ein Grafana- Features, die in Cloud Monitoring-Dashboards nicht verfügbar sind, werden diese Aspekte des Grafana-Dashboards nicht konvertiert. Diese Unterschiede in den Ergebnissen des Imports aufgeführt.

Sie können nur Dashboards importieren, die PromQL-Ausdrücke und Prometheus verwenden Datenquellen. Dashboards, die andere Formen von Abfragen oder Datenquellen verwenden, konnte nicht importiert werden.

Informationen zum Importieren von Prometheus-Benachrichtigungen in Cloud Monitoring finden Sie unter Benachrichtigungsregeln und Empfänger von Prometheus migrieren

Allgemeine Informationen zum Verwalten importierter Dashboards finden Sie unter Benutzerdefinierte Dashboards erstellen und verwalten

Hinweise

Ob Sie die Google Cloud Console oder das Importer-Tool für den Import verwenden Dashboards müssen Sie über eine ausreichende Autorisierung verfügen und Sie benötigen Dashboards für den Import. Bei Verwendung des Importers Tool gibt es zusätzliche Voraussetzungen.

Autorisierung

Um die Berechtigungen zu erhalten, die Sie zum Erstellen und Ändern von benutzerdefinierten Dashboards benötigen, bitten Sie Ihren Administrator, Ihnen IAM-Rolle Monitoring-Bearbeiter (roles/monitoring.editor) für Ihr Projekt. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Weitere Informationen zu Rollen finden Sie unter Zugriff mit Identity and Access Management steuern

Zu importierende Grafana-Dashboards erfassen

Um Grafana-Dashboards zu importieren, müssen sie lokal gespeichert sein unter -Dateien im JSON-Format. Sie können ein spezielles Verzeichnis für diese Dashboarddateien erstellen.

Dashboards mithilfe der Google Cloud Console importieren

Sie können Grafana-Dashboards aus dem an folgenden Stellen in der Google Cloud Console:

Auf der Seite Monitoring-Dashboards auf dem Tab Dashboard-Liste
Im Dashboard-Abschnitt der Onboarding-Checkliste auf der Monitoring-Seite Übersicht.

Grafana-Dashboards importieren

So importieren Sie ein oder mehrere Grafana-Dashboards:

Rufen Sie entweder die Seite Dashboards oder Übersicht in Monitoring:
- Rufen Sie in der Google Cloud Console die Seite Dashboards auf.
  Dashboards aufrufen
  
  Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Monitoring ist.
- Rufen Sie in der Google Cloud Console die Monitoring-Seite Übersicht auf:
  Gehen Sie zur Übersicht.
  
  Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Monitoring ist.
Klicken Sie auf Grafana-Dashboards importieren.
Klicken Sie auf Durchsuchen, um zu dem Verzeichnis zu navigieren, in dem Sie Ihre Grafana-Dashboards im JSON-Format und wählen Sie die Dashboards aus, zu importieren.

Jede JSON-Datei wird nach ihrer Auswahl bereitgestellt. Bereitgestellte Dateien wird angezeigt, ob es Probleme bei der Konvertierung gibt.
- Klicken Sie auf Konvertiertes JSON ansehen, um die Ergebnisse der Konvertierung zu sehen.
- Klicken Sie auf Datei entfernen, um ein Dashboard aus dem Importvorgang zu entfernen.
Klicken Sie auf Importieren. Im Bereich Ergebnisse importieren wird angezeigt, nicht jedes Dashboard erfolgreich importiert wurde.
Wenn Sie ein importiertes Dashboard aufrufen möchten, klicken Sie auf Anzeigen.

Importierte Dashboards aufrufen

So rufen Sie die importierten Dashboards auf:

Rufen Sie in der Google Cloud Console die Seite Dashboards auf.
Dashboards aufrufen

Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Monitoring ist.
Suchen Sie in der Liste das Dashboard, das Sie anzeigen möchten. So filtern Sie die Liste der Dashboards:
- Wählen Sie die Kategorie Benutzerdefiniert aus, um nur benutzerdefinierte Dashboards zu sehen.
- Wählen Sie das Label cloud-monitoring-dashboard-importer aus, um nur Grafana zu sehen Dashboards, die mit der Google Cloud Console importiert wurden.
- Verwenden Sie die Filterleiste, um nach dem Namen zu suchen.

Dashboards mit dem Importtool importieren

Mit dem Importer-Tool können Sie Grafana-Dashboards konvertieren und hochladen. in Cloud Monitoring als einzelnen Vorgang ausführen. Alternativ können Sie Conversion- und Upload-Schritte getrennt. Möglicherweise wählen Sie diesen Ansatz, wenn Sie die konvertierten Dashboards bearbeiten möchten, bevor Sie sie hochladen.

Zusätzliche Voraussetzungen

Bevor Sie den Dashboard-Importer installieren und ausführen können, müssen Sie Folgendes tun:

Verwenden Sie eine Umgebung, die Bash-Shell-Scripts unterstützt.
Sie müssen Git installieren oder verfügen bereits darüber.
Sie müssen Node.js Version 20.4.1 oder höher installieren oder verfügen bereits darüber.
Sie müssen die Google Cloud CLI installieren oder verfügen bereits darüber. Wenn bei Ihnen die gcloud CLI bereits installiert ist, vergewissern Sie sich, dass Sie die neueste Version haben. Führen Sie dazu den Befehl gcloud components update aus.

Dashboard-Importprogramm abrufen

Der Dashboard-Importer ist im GitHub-Repository monitoring-dashboard-samples gespeichert. So rufen Sie den Importer ab:

Klonen Sie das Repository:

git clone https://github.com/GoogleCloudPlatform/monitoring-dashboard-samples

Wechseln Sie in das Verzeichnis für das Dashboard-Importprogramm:
```
cd monitoring-dashboard-samples/scripts/dashboard-importer
```

Der Dashboard-Importer enthält die folgenden Scripts:

import.sh zum Konvertieren von Dashboards und lädt optional die konvertierten Dashboards in Cloud Monitoring hoch.
upload.sh, wodurch die konvertierten Elemente hochgeladen werden oder anderen Monitoring-Dashboards Cloud Monitoring Das Script import.sh ruft dieses Script auf, um den Upload durchzuführen.

Wenn Sie das Script import.sh verwenden, müssen Sie den Speicherort der Grafana-Dashboards angeben, die konvertiert werden sollen. Der Importer erstellt ein Verzeichnis, das die konvertierten Dashboards und andere Informationen enthält. In den folgenden Abschnitten werden diese Verzeichnisse beschrieben.

Grafana-Dashboards, die konvertiert werden sollen

Mit dem Dashboard-Importer können Sie ein oder mehrere Dashboards unter indem Sie einen Pfad zu den Dashboards-Dateien angeben.

Sie können den Pfad zu einem Verzeichnis angeben, das Dashboards enthält. Nur Dateien im Verzeichnis mit der Erweiterung .json werden verarbeitet.
Sie können den Pfad zu einer einzelnen JSON-Datei angeben. Der Dateiname muss die Erweiterung .json haben.

Konvertierte Dashboards und andere Informationen

Wenn der Importer zum ersten Mal ausgeführt wird, wird ein Unterverzeichnis reports erstellt. Jedes Mal, wenn Sie den Importer ausführen, erhalten Sie ein neues Ausgabeverzeichnis unter der Das Verzeichnis reports, das nach Datum und Uhrzeit benannt ist. Der Name der Ausgabe hat die folgende Struktur:
reports/YYYY-M-D/HH:MM:SS

Für jeden Aufruf des Importers enthält das Ausgabeverzeichnis Folgendes:

Eine oder mehrere Dateien mit denselben Namen wie die ursprünglichen Grafana-Dashboards, jetzt jedoch im Cloud Monitoring-JSON-Format.
Eine report.json-Datei, die die folgenden Informationen enthält für jedes konvertierte Dashboard:
- Der Name und der Speicherort der konvertierten Grafana-Dashboard-Datei.
- Der Name und der Speicherort der konvertierten Monitoring-Dashboard-Datei.
- Hinweise zu Funktionen im Grafana-Dashboard, die keine entsprechende Funktion in Cloud Monitoring in das konvertierte Dashboard aufgenommen werden.
- Alle bei der Umwandlung aufgetretenen Fehler.

Falls Sie die Dashboards hochgeladen haben, enthält das Berichtsverzeichnis auch eine upload_HH:MM:SS.txt-Datei mit der URL, zu der das Dashboard hochgeladen wurde.

Grafana-Dashboards importieren

Verwenden Sie das Script import.sh, um Grafana-Dashboards zu konvertieren und in Cloud Monitoring hochzuladen:

./import.sh PATH_TO_DIRECTORY_OR_FILE PROJECT_ID

Dieses Script tut Folgendes:

Konvertiert Dashboards in PATH_TO_DIRECTORY_OR_FILE aus dem von Grafana verwendeten JSON-Format in das von Cloud Monitoring verwendete JSON-Format.
Die konvertierten Dashboards werden mit der Google Cloud CLI in Ihr Google Cloud-Projekt PROJECT_ID hochgeladen.

Wenn Sie sich nicht bei der gcloud CLI authentifiziert haben, führen Sie den Befehl gcloud auth login aus, bevor Sie das Script import.sh ausführen.

Sie können alle Grafana-Dashboards in ein Verzeichnis importieren oder ein einzelnes Dashboard im zu importierenden Verzeichnis.

Geben Sie beim Importieren aller Dashboards im Verzeichnis GRAFANA_DASHBOARDS_DIR in das Google Cloud-Projekt PROJECT_ID das Verzeichnis relativ zum Importerverzeichnis an und geben Sie beim Aufrufen des Scripts die Zielprojekt-ID an:
```
./import.sh GRAFANA_DASHBOARDS_DIR PROJECT_ID
```
Wenn Sie nur das Dashboard MY_GRAFANA_DASHBOARD.json im Verzeichnis GRAFANA_DASHBOARDS_DIR konvertieren möchten, fügen Sie beim Aufrufen des Scripts den Dateinamen des Dashboards relativ zum Importerverzeichnis hinzu:
```
./import.sh GRAFANA_DASHBOARDS_DIR/MY_GRAFANA_DASHBOARD.json PROJECT_ID
```

Der Dashboard-Importer enthält ein Grafana-Beispiel-Dashboard als examples/k8s_cluster_example.json Mit dem folgenden Befehl werden Daten importiert, in das angegebene Projekt importieren:

./import.sh examples/k8s_cluster_example.json PROJECT_ID

Bei Aufruf mit der PROJECT_ID my-project-test-1 sieht die Ausgabe etwa so aus:

Converting: Kubernetes Cluster Overview
✓ Kubernetes Cluster Overview converted successfully

Conversion of examples/k8s_cluster_example.json complete. Conversion Report located at: reports/2023-9-28/22:14:57/report.json


To upload these dashboard(s) manually, you can run:
./upload.sh reports/2023-9-28/22:14:57/ <PROJECT_ID>

Conversion Complete. Proceeding to uploading...

Now running: ./upload.sh reports/2023-9-28/22:14:57/ my-project-test-1

Uploading 1 dashboard(s) from a directory with the following args:
Directory: reports/2023-9-28/22:14:57/
Project: my-project-test-1

The following are your dashboards:
- k8s_cluster_example.json

Nachdem das Script import.sh das Ausgabeverzeichnis erstellt und die Dashboards konvertiert hat, werden Sie vor dem Hochladen der konvertierten Dashboards in Ihr Projekt aufgefordert, den Vorgang zu bestätigen. Geben Sie y ein. Das Script lädt das Dashboard hoch und gibt die URL für das neue Dashboard aus:

Would you like to continue? (y/n) y

✓ k8s_cluster_example.json successfully uploaded:
https://console.cloud.google.com/monitoring/dashboards/builder/9c341ef8-cfef-4bdd-98d5-821571c520ef?project=my-project-test-1

Upload log created in reports/2023-9-28/22:14:57/upload_22:14:57.txt

Need to troubleshoot? Please visit:
https://github.com/GoogleCloudPlatform/monitoring-dashboard-samples/tree/master/scripts/dashboard-importer/README.md#troubleshooting

Grafana-Dashboards ohne Hochladen konvertieren

Wenn Sie die konvertierten Dashboards vor dem Hochladen prüfen oder bearbeiten möchten, lassen Sie den Wert PROJECT_ID beim Aufrufen des Scripts import.sh weg:

./import.sh PATH_TO_DIRECTORY_OR_FILE

Der Importer konvertiert die Dashboards, wie unter Grafana-Dashboards importieren beschrieben, lädt die konvertierten Dashboards jedoch nicht in Cloud Monitoring hoch.

Sie können den Uploadschritt später mithilfe des Scripts upload.sh manuell ausführen.

Dashboards manuell hochladen

Verwenden Sie das Script upload.sh, um Dashboards im Cloud Monitoring-JSON-Format manuell hochzuladen.

    ./upload.sh PATH_TO_DIRECTORY_OR_FILE PROJECT_ID

Das Script upload.sh verwendet die Google Cloud CLI, um die JSON-Dateien hochzuladen. Wenn Sie sich nicht bei der gcloud CLI authentifiziert haben, führen Sie den Befehl gcloud auth login aus, bevor Sie das Script upload.sh ausführen.

Geben Sie beim Hochladen aller Dashboards in einem reports/YYYY-M-D/HH:MM:SS-Verzeichnis das Verzeichnis relativ zum Importerverzeichnis sowie die Zielprojekt-ID an, wenn Sie das Script aufrufen:
```
./upload.sh reports/YYYY-M-D/HH:MM:SS PROJECT_ID
```
Wenn Sie alle Dashboards aus einem Verzeichnis hochladen, werden Sie vom Script aufgefordert, den Vorgang fortzusetzen oder zu beenden, bevor Sie die Dashboards hochladen.
Wenn Sie ein bestimmtes Dashboard in ein reports/YYYY-M-D/HH:MM:SS-Verzeichnis hochladen möchten, geben Sie beim Aufrufen des Scripts das Verzeichnis und den Dateinamen relativ zum Importerverzeichnis sowie die Zielprojekt-ID an:
```
./upload.sh reports/YYYY-M-D/HH:MM:SS/MY_MONITORING_DASHBOARD.json PROJECT_ID
```
Wenn Sie ein einzelnes Dashboard aus einem Verzeichnis hochladen, wird das Script ausgeführt, ohne dass Sie zu einer Aktion aufgefordert werden, bevor die Dashboards hochgeladen werden.

Mit dem folgenden Befehl wird beispielsweise ein in einem Unterverzeichnis reports gespeichertes Dashboard in das Google Cloud-Projekt my-project-test-1 hochgeladen:

./upload.sh reports/2023-9-26/22:48:31/k8s_cluster_example.json my-project-test-1
Uploading json file: k8s_cluster_example.json to project: my-project-test-1...

✓ k8s_cluster_example.json successfully uploaded:
https://console.cloud.google.com/monitoring/dashboards/builder/25956d9a-93e2-410c-ada1-ec6872cb6665?project=my-project-test-1

Hochgeladene Dashboards aufrufen

So rufen Sie Ihre hochgeladenen Dashboards auf:

Rufen Sie in der Google Cloud Console die Seite Dashboards auf.
Dashboards aufrufen

Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Monitoring ist.
Suchen Sie in der Liste das Dashboard, das Sie anzeigen möchten. So filtern Sie die Liste der Dashboards:
- Wählen Sie die Kategorie Benutzerdefiniert aus, um nur benutzerdefinierte Dashboards zu sehen.
- Wählen Sie das Label cloud-ops-grafana-importer aus, um nur Grafana zu sehen Dashboards, die mit dem Importer-Tool importiert wurden.
- Verwenden Sie die Filterleiste, um nach dem Namen zu suchen.

Fehlerbehebung

Gelegentlich veröffentlichen wir kleine Updates und Fehlerkorrekturen für das Tool. Vorher versuchen Sie zunächst, das Problem mit git pull, um die neuesten Version des Repositorys und führen Sie den Import dann noch einmal durch.

Informationen zu Problemen mit den konvertierten Dashboards, z. B. Diagrammen, die keine Daten anzeigen, finden Sie in der Datei README des Importers.

Grafana-Dashboards in Cloud Monitoring importieren

Hinweise

Autorisierung

Zu importierende Grafana-Dashboards erfassen

Dashboards mithilfe der Google Cloud Console importieren

Grafana-Dashboards importieren

Importierte Dashboards aufrufen

Dashboards mit dem Importtool importieren

Zusätzliche Voraussetzungen

Dashboard-Importprogramm abrufen

Grafana-Dashboards, die konvertiert werden sollen

Konvertierte Dashboards und andere Informationen

Grafana-Dashboards importieren

Grafana-Dashboards ohne Hochladen konvertieren

Dashboards manuell hochladen

Hochgeladene Dashboards aufrufen

Fehlerbehebung

Nächste Schritte