Visualisieren von Daten über Azure Data Explorer in Grafana

Grafana ist eine Analyseplattform, auf der Sie Daten abfragen und visualisieren und dann Dashboards basierend auf Ihren Visualisierungen erstellen und freigeben können. Grafana bietet ein Azure Data Explorer-Plug-In, mit dem Sie eine Verbindung mit Daten aus Azure Data Explorer herstellen und diese visualisieren können. Das Plug-In funktioniert sowohl mit Azure Managed Grafana als auch mit selbstgehosteten Grafana.

In diesem Artikel erfahren Sie, wie Sie Ihren Cluster als Datenquelle für Grafana konfigurieren und Daten in Grafana für Azure Managed Grafana und selbstgehostete Grafana visualisieren. Um den Beispielen in diesem Artikel zu folgen, erfassen Sie die StormEvents-Beispieldaten. Das StormEvents-Beispieldataset enthält wetterbezogene Daten der National Centers for Environmental Information.

Voraussetzungen

• Für Azure Managed Grafana instance ein Azure-Konto und Azure Managed Grafana.
• Für selbstgehostete Grafana, Grafana Version 5.3.0 oder höher für Ihr Betriebssystem und das Azure Data Explorer-Plug-In für Grafana. Sie benötigen Plug-In-Version 3.0.5 oder höher, um den Grafana-Abfrage-Generator verwenden zu können.
• Schnellstart: Erstellen eines Azure Data Explorer-Clusters und einer Datenbank. Sie können einen kostenlosen Cluster odereinen vollständigen Cluster erstellen. Um zu entscheiden, welches für Sie am besten geeignet ist, überprüfen Sie den Featurevergleich.

Konfigurieren der Datenquelle

Führen Sie zum Konfigurieren von Azure Data Explorer als Datenquelle die Schritte für Ihre Grafana-Umgebung aus.

Von Azure verwaltetes Grafana

Hinzufügen der verwalteten Identität zur Rolle "Viewer"

Managed Grafana erstellt standardmäßig eine systemseitig zugewiesene verwaltete Identität für jeden neuen Arbeitsbereich. Sie können damit auf Ihren Azure Data Explorer-Cluster zugreifen.

1. Navigieren Sie im Azure-Portal zum Azure Data Explorer-Cluster.

2. Wählen Sie im Abschnitt Übersicht die Datenbank mit den StormEvents-Beispieldaten aus.

   

3. Wählen Sie Berechtigungen>Viewer hinzufügen> aus.

   

4. Geben Sie in das Suchfeld den Namen Ihres Verwalteten Grafana-Arbeitsbereichs ein.

5. Wählen Sie in den Suchergebnissen das Ergebnis aus, das Ihrem Arbeitsbereichsnamen entspricht, und wählen Sie dann Auswählen aus.

   

Einrichten von Azure Data Explorer als Grafana-Datenquelle

Verwaltete Grafana-Arbeitsbereiche verfügen über das vorinstallierte Azure Data Explorer-Plug-In.

1. Wechseln Sie im Azure-Portal zu Ihrem Verwalteten Grafana-Arbeitsbereich.

2. Wählen Sie unter Übersicht den Link Endpunkt aus, um die Grafana-Benutzeroberfläche zu öffnen.

3. Wählen Sie in Grafana im linken Menü das Zahnradsymbol aus. Wählen Sie dann Datenquellen aus.

   

4. Wählen Sie Azure Data Explorer Datenquelle aus.

   

5. Geben Sie unter Verbindungsdetails Ihre Azure Data Explorer-Cluster-URL ein.

   

6. Wählen Sie Speichern und testen aus.

Selbstgehostete Grafana

Erstellen eines Dienstprinzipals

Sie können den Dienstprinzipal im Azure-Portal oder mithilfe der Befehlszeilenoberfläche der Azure CLI erstellen. Nachdem Sie den Dienstprinzipal erstellt haben, erhalten Sie Werte für vier Verbindungseigenschaften, die Sie in späteren Schritten verwenden werden.

Azure-Portal

1. Befolgen Sie die Anweisungen in der Azure-Portal-Dokumentation. Verwenden Sie diese spezifischen Informationen:

   1. Weisen Sie im Abschnitt Zuweisen der Anwendung zu einer Rolle den Rollentyp Leser zu Ihrem Azure Data Explorer-Cluster zu.

   2. Kopieren Sie im Abschnitt Werte für die Anmeldung abrufen die Werte für die drei Eigenschaften, die in den Schritten behandelt werden: Verzeichnis-ID (Mandanten-ID), Anwendungs-ID und Kennwort.

2. Wählen Sie im Azure-Portal Abonnements aus. Kopieren Sie dann die ID für das Abonnement, in dem Sie den Dienstprinzipal erstellt haben.

   

Azure CLI

1. Verwenden Sie den folgenden Befehl, um einen Dienstprinzipal zu erstellen. Legen Sie einen geeigneten Bereich und den Rollentyp reader fest.

   az ad sp create-for-rbac --name "https://{UrlToYourDashboard}:{PortNumber}" --role "reader" \
                            --scopes /subscriptions/{SubID}/resourceGroups/{ResourceGroupName}
   

   Weitere Informationen finden Sie unter Erstellen eines Azure-Dienstprinzipals mit der Azure CLI.

2. Der Befehl gibt ein Resultset wie im folgenden Beispiel zurück. Kopieren Sie die Werte für die appIdEigenschaften , passwordund tenant .

   {
     "appId": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
     "displayName": "{UrlToYourDashboard}:{PortNumber}",
     "name": "https://{UrlToYourDashboard}:{PortNumber}",
     "password": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
     "tenant": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
   }
   

3. Rufen Sie eine Liste Ihrer Abonnements ab:

   az account list --output table
   

   Kopieren Sie die entsprechende Abonnement-ID.

   

Hinzufügen des Dienstprinzipals zur Rolle "Viewer"

Nachdem Sie nun über einen Dienstprinzipal verfügen, fügen Sie ihn der Rolle Viewer in der Azure Data Explorer-Datenbank hinzu. Sie können diese Aufgabe unter Berechtigungen im Azure-Portal oder unter Abfrage mit einem Verwaltungsbefehl ausführen.

Azure-Portal: Berechtigungen

1. Navigieren Sie im Azure-Portal zum Azure Data Explorer-Cluster.

2. Wählen Sie im Abschnitt Übersicht die Datenbank mit den StormEvents-Beispieldaten aus.

   

3. Klicken Sie auf Berechtigungen>Hinzufügen.

   

4. Wählen Sie unter Datenbankberechtigungen hinzufügen die Rolle Viewer und dann Prinzipale auswählen aus.

   

5. Suchen Sie nach dem von Ihnen erstellten Dienstprinzipal. Wählen Sie den Prinzipal aus, und wählen Sie dann Auswählen aus.

   

6. Wählen Sie Speichern aus.

   

Verwaltungsbefehl: Abfrage

1. Wechseln Sie im Azure-Portal zu Ihrem Azure Data Explorer-Cluster, und wählen Sie dann Abfrage aus.

   

2. Führen Sie den folgenden Befehl im Abfragefenster aus. Verwenden Sie die Anwendungs- und Mandanten-ID aus dem Azure-Portal oder der Azure CLI.

   .add database {TestDatabase} viewers ('aadapp={ApplicationID};{TenantID}')
   

   Der Befehl gibt ein Resultset zurück. Im folgenden Beispiel ist die erste Zeile für einen vorhandenen Benutzer in der Datenbank. Die zweite Zeile ist für den Dienstprinzipal, den Sie gerade hinzugefügt haben.

   

Angeben von Eigenschaften und Testen der Verbindung

Da der Dienstprinzipal der Rolle "Viewer" zugewiesen ist, geben Sie nun Eigenschaften in Ihrem instance von Grafana an und testen die Verbindung mit Azure Data Explorer.

1. Wählen Sie in Grafana im linken Menü das Zahnradsymbol aus. Wählen Sie dann Datenquellen aus.

   

2. Wählen Sie die Option Datenquelle hinzufügen.

3. Geben Sie auf der Seite Datenquellen/Neu einen Namen für die Datenquelle ein, und wählen Sie dann den Typ Azure Data Explorer Datenquelle aus.

   

4. Geben Sie unter Einstellungen>Verbindungsdetails den Namen Ihres Clusters im Format ein https://{ClusterName}.{Region}.kusto.windows.net. Geben Sie die anderen Werte aus dem Azure-Portal oder der Azure CLI ein. Verwenden Sie die folgenden Zuordnungsinformationen als Leitfaden.

   Grafana-Benutzeroberfläche	Azure-Portal	Azure CLI
   Subscription Id (Abonnement-ID)	ABONNEMENT-ID	SubscriptionId
   Mandanten-ID	Verzeichnis-ID	tenant
   Client-ID	Anwendungs-ID	appId
   Geheimer Clientschlüssel	Kennwort	password

   

5. Wählen Sie Speichern und testen aus.

   Wenn der Test erfolgreich war, wechseln Sie zum nächsten Abschnitt. Wenn Probleme auftreten, überprüfen Sie die Werte, die Sie in Grafana angegeben haben, und überprüfen Sie die vorherigen Schritte.

Optimieren von Abfragen

Sie können zwei Features für die Abfrageoptimierung verwenden:

• Optimieren der Dashboardrenderingleistung für Abfragen
• Aktivieren der schwachen Konsistenz

Nehmen Sie zum Ausführen der Optimierung unter Datenquellen>Einstellungen>Abfrageoptimierungen die erforderlichen Änderungen vor.

Optimieren der Dashboardrenderingleistung für Abfragen

Wenn ein Dashboard oder Visual von einem oder mehreren Benutzern mehr als einmal gerendert wird, sendet Grafana standardmäßig mindestens eine Abfrage an Azure Data Explorer. Aktivieren Sie die Zwischenspeicherung von Abfrageergebnissen, um die Renderingleistung Dashboard zu verbessern und die Auslastung des Azure Data Explorer-Clusters zu reduzieren.

Während des angegebenen Zeitraums verwendet Azure Data Explorer den Ergebniscache zum Abrufen der vorherigen Ergebnisse und führt keine unnötige Abfrage aus. Diese Funktion ist besonders effektiv, um die Ressourcenauslastung zu reduzieren und die Leistung zu steigern, wenn mehrere Benutzer dasselbe Dashboard verwenden.

Führen Sie zum Aktivieren des Ergebniscacherenderings im Bereich Abfrageoptimierungen die folgenden Schritte aus :

1. Deaktivieren Sie Dynamisches Zwischenspeichern verwenden.
2. Geben Sie unter Cache Max Age (Maximales Alter des Cache) den Zeitraum in Minuten ein, in dem Sie zwischengespeicherte Ergebnisse verwenden möchten.

Aktivieren der schwachen Konsistenz

Cluster werden mit starker Konsistenz konfiguriert. Mit dieser Standardkonfiguration wird sichergestellt, dass die Abfrageergebnisse mit allen Änderungen im Cluster auf dem neuesten Stand sind.

Wenn Sie eine schwache Konsistenz aktivieren, können Abfrageergebnisse nach Clusteränderungen eine Verzögerung von 1 bis 2 Minuten aufweisen. Eine schwache Konsistenz kann jedoch die Visuelle Renderingzeit erhöhen. Wenn die sofortige Konsistenz nicht entscheidend ist und die Leistung nur geringfügig ist, aktivieren Sie schwache Konsistenz, um die Leistung zu verbessern. Weitere Informationen finden Sie unter Abfragekonsistenz.

Um eine schwache Konsistenz zu aktivieren, wählen Sie im Bereich Abfrageoptimierungendie Option Datenkonsistenz>Schwach aus.

Visualisieren von Daten

Sie haben azure Data Explorer als Datenquelle für Grafana konfiguriert. Jetzt ist es an der Zeit, Daten zu visualisieren.

Im folgenden einfachen Beispiel werden sowohl der Abfrage-Generator-Modus als auch der Rohmodus des Abfrage-Editors verwendet. Es wird empfohlen, Schreibabfragen für Azure Data Explorer beispiele für andere Abfragen anzuzeigen, die für das Dataset ausgeführt werden sollen.

1. Wählen Sie in Grafana im linken Menü das Plussymbol aus. Wählen Sie dann Dashboard aus.

   

2. Wählen Sie unter der Registerkarte Hinzufügen die Option Diagramm aus.

   

3. Wählen Sie im Diagrammbereich Die Option Bereichstitel>bearbeiten aus.

   

4. Wählen Sie unten im Bereich Datenquelle und dann die von Ihnen konfigurierte Datenquelle aus.

   

Abfrage-Generator-Modus

Verwenden Sie den Abfrage-Generator-Modus, um Ihre Abfrage zu definieren.

1. Wählen Sie unter der Datenquelle Datenbank aus, und wählen Sie ihre Datenbank aus der Dropdownliste aus.

2. Wählen Sie Von und dann Ihre Tabelle aus der Dropdownliste aus.

   

3. Nachdem die Tabelle definiert ist, filtern Sie die Daten:

   1. Wählen Sie + rechts neben Where (Filter) aus, um eine oder mehrere Spalten in Der Tabelle auszuwählen.
   2. Definieren Sie die Werte für jeden Filter, indem Sie den entsprechenden Operator verwenden. Diese Auswahl ähnelt der Verwendung des where-Operators in Kusto-Abfragesprache.

4. Wählen Sie die Werte aus, die in der Tabelle angezeigt werden sollen:

   1. Wählen Sie + rechts neben Den Wertspalten aus, um die Wertspalten auszuwählen, die im Bereich angezeigt werden.

   2. Legen Sie für die einzelnen Wertspalten jeweils den Aggregationstyp fest.

      Sie können eine oder mehrere Wertspalten festlegen. Diese Auswahl entspricht der Verwendung des summarize-Operators.

5. Wählen Sie + rechts neben Gruppieren nach (Zusammenfassen) aus, um eine oder mehrere Spalten auszuwählen, die zum Anordnen der Werte in Gruppen verwendet werden. Diese Auswahl entspricht dem Gruppenausdruck im summarize Operator.

6. Wählen Sie Run Query (Abfrage ausführen) aus.

   

   Tipp

   Während Sie die Einstellungen im Abfrage-Generator abschließen, wird eine Kusto-Abfragesprache Abfrage erstellt. Diese Abfrage zeigt die Logik, die Sie mit dem grafischen Abfrage-Editor erstellt haben.

7. Wählen Sie KQL bearbeiten aus, um in den Rohmodus zu wechseln. Bearbeiten Sie Ihre Abfrage mithilfe der Flexibilität und Leistungsfähigkeit der Kusto-Abfragesprache.

RAW-Modus

Bearbeiten Sie die Abfrage im RAW-Modus.

1. Fügen Sie im Abfragebereich die folgende Abfrage ein, und wählen Sie dann Ausführen aus. Die Abfrage buckett die Anzahl der Ereignisse nach Tag für das Beispieldataset.

   StormEvents
   | summarize event_count=count() by bin(StartTime, 1d)
   

   

2. Das Diagramm zeigt keine Ergebnisse an, da es (standardmäßig) auf Daten der letzten sechs Stunden beschränkt ist. Wählen Sie im oberen Menü Letzte 6 Stunden aus.

   

3. Geben Sie einen benutzerdefinierten Bereich an, der das Jahr 2007 abdeckt, das im StormEvents-Beispieldataset enthalten ist. Wählen Sie dann Anwenden aus.

   

   Jetzt zeigt das Diagramm die nach Tag gegliederten Daten von 2007 an.

   

4. Wählen Sie im oberen Menü das Symbol Speichern aus: .

Wählen Sie Switch to builder (Zum Generator wechseln) aus, um in den Abfrage-Generator-Modus zu wechseln. Grafana konvertiert die Abfrage in die verfügbare Logik im Abfrage-Generator. Die Logik des Abfrage-Generators ist eingeschränkt, sodass Sie möglicherweise manuelle Änderungen verlieren, die Sie an der Abfrage vorgenommen haben.

Erstellen von Warnungen

1. Wählen Sie im StartdashboardWarnungsbenachrichtigungskanäle> aus, um einen neuen Benachrichtigungskanal zu erstellen.

   

2. Geben Sie einen Namen ein, geben Sie unter Neuer Benachrichtigungskanal ein, und wählen Sie dann Speichern aus.

   

3. Wählen Sie auf der Dashboard in der Dropdownliste Bearbeiten aus.

   

4. Wählen Sie das Glockensymbol aus, um den Bereich Warnung zu öffnen. Wählen Sie Warnung erstellen aus, und füllen Sie dann die Eigenschaften für die Warnung aus.

   

5. Wählen Sie das Symbol Dashboard speichern aus, um Ihre Änderungen zu speichern.

Verwandte Inhalte

• Schreiben von Abfragen für den Azure-Daten-Explorer