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 können So importieren Sie Grafana-Dashboards:

Google Cloud Console verwenden
Mit dem Importer-Tool.

Der Importer konvertiert Dashboard-Dateien im JSON-Format, das von Grafana verwendet wird, in das von Cloud Monitoring verwendete JSON-Format. 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 Abfrageformen oder Datenquellen verwenden, können möglicherweise nicht importiert werden.

Informationen zum Importieren von Prometheus-Benachrichtigungen in Cloud Monitoring finden Sie unter Benachrichtigungsregeln und ‑empfänger aus 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. Für die Verwendung des Importtools gelten 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.

Grafana-Dashboards zum Importieren erfassen

Wenn Sie Grafana-Dashboards importieren möchten, müssen sie lokal als Dateien im JSON-Format gespeichert sein. Möglicherweise möchten Sie ein Verzeichnis speziell für diese Dashboard-Dateien.

Dashboards mithilfe der Google Cloud Console importieren

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

Der Tab Dashboard-Liste auf den Dashboards von Monitoring Seite.
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:
  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 der Auswahl bereitgestellt. Im Bereich Bereitgestellte Dateien wird angezeigt, ob bei der Umwandlung Probleme auftreten.
- 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 Importergebnisse sehen Sie, ob jedes Dashboard erfolgreich importiert wurde.
Wenn Sie ein importiertes Dashboard aufrufen möchten, klicken Sie auf Anzeigen.

Importierte Dashboards aufrufen

So rufen Sie Ihre 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 nach dem Dashboard, das Sie aufrufen 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-Dashboards zu sehen, die über die Google Cloud Console importiert wurden.
- Verwenden Sie die Filterleiste, um nach dem Namen zu suchen.

Dashboards mit dem Importtool importieren

Sie können mit dem Importer-Tool in einem einzelnen Vorgang Grafana-Dashboards konvertieren und in Cloud Monitoring hochladen oder die Konvertierungs- und Uploadschritte separat ausführen. 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-Importeur 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-Importeur 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 gleichzeitig konvertieren, indem Sie einen Pfad zu den Dashboard-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.

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, wird im Verzeichnis reports ein neues Ausgabeverzeichnis erstellt, das nach Datum und Uhrzeit benannt wird. 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 haben und daher nicht in das konvertierte Dashboard aufgenommen werden konnten.
- Alle bei der Umwandlung aufgetretenen Fehler.

Wenn Sie die Dashboards hochgeladen haben, enthält das Berichtsverzeichnis auch eine upload_HH:MM:SS.txt-Datei mit der URL, unter 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 einem Verzeichnis importieren oder ein einzelnes Dashboard im Verzeichnis angeben, das importiert werden soll.

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 ansehen

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 nach dem Dashboard, das Sie aufrufen 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-Dashboards zu sehen, die mit dem Importtool 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. Bevor Sie weitere Schritte zur Fehlerbehebung ausführen, versuchen Sie, das Problem zu beheben, indem Sie mit git pull die neueste Version des Repositorys herunterladen und dann noch einmal importieren.

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

Grafana-Dashboards zum Importieren erfassen

Dashboards mithilfe der Google Cloud Console importieren

Grafana-Dashboards importieren

Importierte Dashboards aufrufen

Dashboards mit dem Importtool importieren

Zusätzliche Voraussetzungen

Dashboard-Importeur 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 ansehen

Fehlerbehebung

Nächste Schritte