Migrieren zu Azure Managed Grafana

In diesem Leitfaden wird gezeigt, wie Sie Inhalte aus einem lokalen oder einem in einer Cloud verwalteten Grafana mithilfe der Azure CLI zu Azure Managed Grafana migrieren. Die folgenden Elemente können automatisch migriert werden:

• Datenquellen
• Ordner
• Bibliotheksbereiche
• Dashboards
• snapshots
• annotations

Voraussetzungen

• Eine Grafana-Instanz, die zu Azure Managed Grafana migriert werden soll
• Azure Managed Grafana-Arbeitsbereich
• In beiden Arbeitsbereichen erforderlicher Mindestzugriff: Grafana-Admin

• Verwenden Sie die Bash-Umgebung in Azure Cloud Shell. Weitere Informationen finden Sie unter Schnellstart für Bash in Azure Cloud Shell.

  

• Wenn Sie CLI-Referenzbefehle lieber lokal ausführen, installieren Sie die Azure CLI. Wenn Sie Windows oder macOS ausführen, sollten Sie die Azure CLI in einem Docker-Container ausführen. Weitere Informationen finden Sie unter Ausführen der Azure CLI in einem Docker-Container.

  • Wenn Sie eine lokale Installation verwenden, melden Sie sich mithilfe des Befehls az login bei der Azure CLI an. Führen Sie die in Ihrem Terminal angezeigten Schritte aus, um den Authentifizierungsprozess abzuschließen. Informationen zu anderen Anmeldeoptionen finden Sie unter Anmelden mit der Azure CLI.

  • Installieren Sie die Azure CLI-Erweiterung beim ersten Einsatz, wenn Sie dazu aufgefordert werden. Weitere Informationen zu Erweiterungen finden Sie unter Verwenden von Erweiterungen mit der Azure CLI.

  • Führen Sie az version aus, um die installierte Version und die abhängigen Bibliotheken zu ermitteln. Führen Sie az upgrade aus, um das Upgrade auf die aktuelle Version durchzuführen.

In den folgenden Anweisungen wird gezeigt, wie Sie Inhalte aus einer Grafana-Instanz mithilfe der Azure-Plattform zu Azure Managed Grafana migrieren.

Voraussetzungen

• Eine Grafana-Instanz, die zu Azure Managed Grafana migriert werden soll
• Azure Managed Grafana-Arbeitsbereich
• In beiden Fällen erforderlicher Mindestzugriff: Grafana-Administrator

Erstellen eines Dienstkontotokens

Erstellen Sie zunächst ein Dienstkontotoken, um die erforderlichen Berechtigungen für den Zugriff auf Inhalte und den Export von Inhalten in Ihrer Grafana-Instanz zu erteilen.

1. Erstellen Sie in der Grafana-Instanz, in der Sie Inhalte sammeln möchten (Quelle), ein neues Dienstkonto mit Administratorberechtigungen, indem Sie zu Verwaltung>Benutzer und Zugriff>Dienstkonten>Dienstkonto hinzufügen navigieren.

   

   Tipp

   Für diesen Schritt müssen Grafana-Dienstkonten verwendet werden. Wenn Sie von einem Azure Managed Grafana-Arbeitsbereich migrieren, aktivieren Sie Dienstkonten in Azure Managed Grafana.

2. Geben Sie einen Anzeigenamen für das neue Dienstkonto ein, wählen Sie die Rolle Administrator und anschließend Übernehmen und Erstellen aus.

3. Nachdem das Dienstkonto erstellt wurde, wählen Sie Token hinzufügen aus, legen Sie optional ein Ablaufdatum fest, und wählen Sie Token generieren aus. Denken Sie daran, das Token jetzt zu kopieren, da Sie es nicht mehr anzeigen können, sobald Sie diese Seite verlassen.

Ausführen des Grafana-Migrationsbefehls

Führen Sie in der Azure CLI den Befehl az grafana migrate aus. Ersetzen Sie beim Ausführen des folgenden Befehls die Platzhalter <target-grafana><target-grafana-resource-group><--src-endpoint>, <source-grafana-endpoint> und <source-token> durch den Namen und die Ressourcengruppe des Azure Managed Grafana-Arbeitsbereichs, zu dem Sie migrieren möchten (Ziel), den Endpunkt von Grafana, in dem Sie Inhalte sammeln (Quelle), und das zuvor erstellte Dienstkontotoken.

az grafana migrate --name <target-grafana> --resource-group <target-grafana-resource-group> --src-endpoint <source-grafana-endpoint> --src-token-or-key <source-token>

Die Azure CLI-Ausgabe listet alle Elemente auf, die zu Ihrem Azure Managed Grafana-Arbeitsbereich migriert wurden.

Optionale Parameter für diesen Befehl:

• --dry-run: Anzeigen einer Vorschau der Änderungen ohne Commit
• --folders-to-exclude: Ordner, die von der Sicherung oder Synchronisierung ausgeschlossen werden sollen
• --folders-to-include: Ordner, die in die Sicherung oder Synchronisierung eingeschlossen werden sollen
• --overwrite: Wenn Sie versuchen, ein Dashboard zu migrieren, das bereits in Ihrem Grafana-Zielarbeitsbereich vorhanden ist, überspringt Azure Managed Grafana standardmäßig die Erstellung der neuen Datenquelle, um das Erstellen eines Duplikats zu vermeiden. Mit der Option „Überschreiben“ können Sie vorherige Dashboards, Bibliotheksbereiche und Ordner mit derselben Benutzer-ID oder demselben Titel überschreiben.

Abschließen der Grafana-Migration

Navigieren Sie zu Ihrem Zielarbeitsbereich, und überprüfen Sie, ob Sie alle Elemente finden, die Sie aus Ihrer Grafana-Instanz migriert haben.

Exportieren von Grafana-Dashboards

Exportieren Sie zunächst Ihre Grafana-Dashboards als JSON-Dateien.

1. Öffnen Sie Ihre Grafana-Benutzeroberfläche, und wechseln Sie zu Dashboards.

2. Öffnen Sie eins Ihrer Dashboards, und wählen Sie das Symbol Bereich oder Dashboard teilen aus.

3. Wechseln Sie zur Registerkarte Exportieren, und wählen Sie In Datei speichern aus.

   

4. Wiederholen Sie den Vorgang für jedes Dashboard, das Sie hinzufügen möchten.

Importieren Ihrer Grafana-Dashboards in Azure Managed Grafana

Erstellen Sie ein neues Dashboard in Azure Managed Grafana, indem Sie die exportierten JSON-Dateien importieren.

1. Öffnen Sie auf der Seite Übersicht Ihres Azure Managed Grafana-Arbeitsbereichs die Endpunkt-URL, um das Grafana-Portal zu öffnen.

2. Wählen Sie oben auf der Seite + und dann Dashboard importieren aus.

   

3. Wählen Sie JSON-Datei für Dashboard hochladen und dann die Datei auf Ihrem lokalen Computer aus.

4. Wählen Sie Laden aus, und überprüfen Sie die Dashboardeinstellungen. Bearbeiten Sie optional den Dashboardnamen, den Ordner und den eindeutigen Bezeichner (UID).

5. Wählen Sie Importieren aus, um das Dashboard zu speichern. Wiederholen Sie den Vorgang für jedes Dashboard, das Sie importieren möchten.

   

Weitere Informationen zum Erstellen und Bearbeiten von Dashboards finden Sie unter Erstellen eines Dashboards in Azure Managed Grafana.

Installieren von Datenquellen-Plug-Ins

Wichtige Datenquellen-Plug-Ins, die vom Preisplan Ihres Arbeitsbereichs unterstützt werden, werden standardmäßig installiert. Um andere Plug-Ins zu installieren, folgen Sie dem nachstehenden Prozess:

1. Öffnen Sie Ihren Arbeitsbereich im Azure-Portal, und wechseln Sie zu Plug-In-Verwaltung (Vorschau).
2. Wählen Sie ein zu installierendes Plug-In aus, indem Sie sein Kontrollkästchen aktivieren und Speichern auswählen.
3. Wiederholen Sie den Vorgang für jedes Datenquellen-Plug-In, das Sie hinzufügen möchten.

Weitere Informationen finden Sie unter Hinzufügen eines Plug-Ins.

Konfigurieren Ihrer Datenquellen

Konfigurieren Sie neue Datenquellen in Azure Managed Grafana.

1. Öffnen Sie auf der Seite Übersicht Ihres Azure Managed Grafana-Arbeitsbereichs die Endpunkt-URL, um das Grafana-Portal zu öffnen.
2. Wechseln Sie auf der Grafana-Benutzeroberfläche zu Connections>Data sources>Add new datasource.
3. Wählen Sie eine Datenquelle aus der Liste aus.
4. Füllen Sie die erforderlichen Felder aus, und wählen Sie Save & test aus, um die Konfiguration zu speichern und sicherzustellen, dass Grafana eine Verbindung mit der Datenquelle herstellen kann.
5. Wiederholen Sie diesen Vorgang für jede Datenquelle.