Gegevens van Azure Data Explorer visualiseren in Grafana

Grafana is een analyseplatform waar u gegevens kunt opvragen en visualiseren en vervolgens dashboards kunt maken en delen op basis van uw visualisaties. Grafana biedt een Azure Data Explorer-invoegtoepassing, waarmee u verbinding kunt maken met en gegevens uit Azure Data Explorer kunt visualiseren. De invoegtoepassing werkt met zowel Azure Managed Grafana als zelf-hostende Grafana.

In dit artikel leert u hoe u uw cluster configureert als een gegevensbron voor Grafana en gegevens visualiseert in Grafana voor Azure Managed Grafana en zelf-hostende Grafana. Als u de voorbeelden in dit artikel wilt volgen, neemt u de StormEvents-voorbeeldgegevens op. De StormEvents-voorbeeldgegevensset bevat weergerelateerde gegevens van de National Centers for Environmental Information.

Vereisten

• Voor Azure Managed Grafana, een Azure-account en een Azure Managed Grafana-exemplaar .
• Voor zelf-hostende Grafana, Grafana versie 5.3.0 of hoger voor uw besturingssysteem en de Azure Data Explorer-invoegtoepassing voor Grafana. U hebt invoegtoepassingsversie 3.0.5 of hoger nodig om de opbouwfunctie voor Grafana-query's te gebruiken.
• Een Azure Data Explorer-cluster en -database. U kunt een gratis cluster maken of een volledig cluster maken. Controleer de functievergelijking om te bepalen wat het beste bij u past.

De gegevensbron configureren

Als u Azure Data Explorer wilt configureren als gegevensbron, volgt u de stappen voor uw Grafana-omgeving.

Azure Managed Grafana

De beheerde identiteit toevoegen aan de rol Kijker

Managed Grafana maakt standaard een door het systeem toegewezen beheerde identiteit voor elke nieuwe werkruimte. U kunt deze gebruiken om toegang te krijgen tot uw Azure Data Explorer-cluster.

1. Ga in de Azure Portal naar uw Azure Data Explorer-cluster.

2. Selecteer in de sectie Overzicht de database met de StormEvents-voorbeeldgegevens .

   

3. Selecteer Machtigingen>Viewer toevoegen>.

   

4. Voer in het zoekvak de naam van uw Beheerde Grafana-werkruimte in.

5. Selecteer in de zoekresultaten het resultaat dat overeenkomt met de naam van uw werkruimte en kies vervolgens Selecteren.

   

Azure Data Explorer instellen als grafana-gegevensbron

Beheerde Grafana-werkruimten worden geleverd met de invoegtoepassing Azure Data Explorer vooraf geïnstalleerd.

1. Ga in de Azure Portal naar uw Beheerde Grafana-werkruimte.

2. Selecteer onder Overzicht de koppeling Eindpunt om de Grafana-gebruikersinterface te openen.

3. Selecteer in Grafana in het linkermenu het tandwielpictogram. Selecteer vervolgens Gegevensbronnen.

   

4. Selecteer Azure Data Explorer Datasource.

   

5. Voer bij Verbindingsgegevens de URL van uw Azure Data Explorer-cluster in.

   

6. Selecteer Save & Test.

Zelf-hostende Grafana

Een service-principal maken

U kunt de service-principal maken in de Azure Portal of met behulp van de Azure CLI-opdrachtregelervaring. Nadat u de service-principal hebt gemaakt, krijgt u waarden voor vier verbindingseigenschappen die u in latere stappen gaat gebruiken.

Azure Portal

1. Volg de instructies in de Azure Portal documentatie. Gebruik deze specifieke informatie:

   1. Wijs in de sectie De toepassing toewijzen aan een rol een roltype Lezer toe aan uw Azure Data Explorer-cluster.

   2. Kopieer in de sectie Waarden ophalen voor aanmelden de waarden voor de drie eigenschappen die worden behandeld in de stappen: Directory-id (tenant-id), Toepassings-id en Wachtwoord.

2. Selecteer Abonnementen in de Azure Portal. Kopieer vervolgens de id voor het abonnement waarin u de service-principal hebt gemaakt.

   

Azure CLI

1. Gebruik de volgende opdracht om een service-principal te maken. Stel een geschikt bereik en een roltype in van reader.

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

   Zie Een Azure-service-principal maken met de Azure CLI voor meer informatie.

2. De opdracht retourneert een resultatenset zoals in het volgende voorbeeld. Kopieer de waarden voor de appIdeigenschappen , passworden 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. Een lijst met uw abonnementen ophalen:

   az account list --output table
   

   Kopieer de juiste abonnements-id.

   

De service-principal toevoegen aan de rol Kijker

Nu u een service-principal hebt, voegt u deze toe aan de rol Kijker in de Azure Data Explorer-database. U kunt deze taak uitvoeren onder Machtigingen in de Azure Portal of onder Query met behulp van een beheeropdracht.

Azure Portal: machtigingen

1. Ga in de Azure Portal naar uw Azure Data Explorer-cluster.

2. Selecteer in de sectie Overzicht de database met de StormEvents-voorbeeldgegevens.

   

3. Selecteer Machtigingen>Toevoegen.

   

4. Selecteer onder Databasemachtigingen toevoegen de rol Viewer en kies vervolgens Principals selecteren.

   

5. Zoek naar de service-principal die u hebt gemaakt. Selecteer de principal en kies vervolgens Selecteren.

   

6. Selecteer Opslaan.

   

Beheeropdracht: Query

1. Ga in de Azure Portal naar uw Azure Data Explorer-cluster en selecteer Query.

   

2. Voer de volgende opdracht uit in het queryvenster. Gebruik de toepassings-id en tenant-id van de Azure Portal of de Azure CLI.

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

   De opdracht retourneert een resultatenset. In het volgende voorbeeld is de eerste rij voor een bestaande gebruiker in de database. De tweede rij is voor de service-principal die u zojuist hebt toegevoegd.

   

Eigenschappen opgeven en de verbinding testen

Nu de service-principal is toegewezen aan de rol Viewer, geeft u nu eigenschappen op in uw exemplaar van Grafana en test u de verbinding met Azure Data Explorer.

1. Selecteer in Grafana in het linkermenu het tandwielpictogram. Selecteer vervolgens Gegevensbronnen.

   

2. Selecteer Gegevensbron toevoegen.

3. Voer op de pagina Gegevensbronnen/Nieuw een naam in voor de gegevensbron en selecteer vervolgens het type Azure Data Explorer Gegevensbron.

   

4. Voer in Instellingen>Verbindingsdetails de naam van uw cluster in het formulier https://{ClusterName}.{Region}.kusto.windows.netin. Voer de andere waarden uit de Azure Portal of de Azure CLI in. Gebruik de volgende toewijzingsgegevens als richtlijn.

   Grafana-gebruikersinterface	Azure Portal	Azure CLI
   Abonnements-id	ABONNEMENTS-id	SubscriptionId
   Tenant-id	Map-id	tenant
   Client-id	Toepassings-id	appId
   Clientgeheim	Wachtwoord	password

   

5. Selecteer Save & Test.

   Als de test is geslaagd, gaat u naar de volgende sectie. Als u problemen ondervindt, controleert u de waarden die u hebt opgegeven in Grafana en bekijkt u de vorige stappen.

Query's optimaliseren

U kunt twee functies gebruiken voor queryoptimalisatie:

• Prestaties voor het weergeven van dashboardquery's optimaliseren
• Zwakke consistentie inschakelen

Als u de optimalisatie wilt uitvoeren, voert u inInstellingen> voor gegevensbronnen>Queryoptimalisaties de benodigde wijzigingen aan.

Prestaties voor het weergeven van dashboardquery's optimaliseren

Wanneer een dashboard of visual meer dan één keer wordt weergegeven door een of meer gebruikers, verzendt Grafana standaard ten minste één query naar Azure Data Explorer. Schakel de cache van queryresultaten in om de weergaveprestaties van dashboards te verbeteren en de belasting van het Azure Data Explorer-cluster te verminderen.

Tijdens het opgegeven tijdsbereik gebruikt Azure Data Explorer de resultatencache om de vorige resultaten op te halen en wordt er geen onnodige query uitgevoerd. Deze mogelijkheid is met name effectief bij het verminderen van de belasting van resources en het verbeteren van de prestaties wanneer meerdere gebruikers hetzelfde dashboard gebruiken.

Ga als volgt te werk in het deelvenster Queryoptimalisaties om de weergave van de resultatencache in te schakelen:

1. Schakel Dynamische caching gebruiken uit.
2. Voer bij Maximale leeftijd van cache het aantal minuten in waarin u resultaten in de cache wilt gebruiken.

Zwakke consistentie inschakelen

Clusters worden geconfigureerd met sterke consistentie. Deze standaardconfiguratie garandeert dat queryresultaten up-to-date zijn met alle wijzigingen in het cluster.

Wanneer u zwakke consistentie inschakelt, kunnen queryresultaten een vertraging van 1 tot 2 minuten hebben na het wijzigen van het cluster. Zwakke consistentie kan echter de weergavetijd van de visual verhogen. Als onmiddellijke consistentie niet essentieel is en de prestaties marginaal zijn, schakelt u zwakke consistentie in om de prestaties te verbeteren. Zie Queryconsistentie voor meer informatie.

Als u zwakke consistentie wilt inschakelen, selecteert u in het deelvenster Queryoptimalisatiesde optie Gegevensconsistentie>Zwak.

Gegevens visualiseren

U hebt Azure Data Explorer geconfigureerd als gegevensbron voor Grafana. Nu is het tijd om gegevens te visualiseren.

In het volgende eenvoudige voorbeeld wordt zowel de opbouwmodus voor query's als de onbewerkte modus van de queryeditor gebruikt. We raden u aan schrijfquery's voor Azure Data Explorer weer te geven voor voorbeelden van andere query's die kunnen worden uitgevoerd op de gegevensset.

1. Selecteer in Grafana in het linkermenu het pluspictogram. Selecteer vervolgens Dashboard.

   

2. Selecteer op het tabblad Toevoegende optie Grafiek.

   

3. Selecteer in het deelvenster Grafiek de optie Titel>van deelvenster bewerken.

   

4. Selecteer gegevensbron onderaan het deelvenster en selecteer vervolgens de gegevensbron die u hebt geconfigureerd.

   

Opbouwmodus voor query's

Gebruik de opbouwmodus voor query's om uw query te definiëren.

1. Selecteer onder de gegevensbron Database en kies uw database in de vervolgkeuzelijst.

2. Selecteer Van en kies uw tabel in de vervolgkeuzelijst.

   

3. Nu de tabel is gedefinieerd, filtert u de gegevens:

   1. Selecteer + rechts van Where (filter) om een of meer kolommen in de tabel te selecteren.
   2. Definieer voor elk filter de waarden met behulp van de toepasselijke operator. Deze selectie is vergelijkbaar met het gebruik van de where-operator in Kusto-querytaal.

4. Selecteer de waarden die in de tabel moeten worden weergegeven:

   1. Selecteer + rechts van waardekolommen om de waardekolommen te selecteren die in het deelvenster worden weergegeven.

   2. Stel voor elke waardekolom het aggregatietype in.

      U kunt een of meer waardekolommen instellen. Deze selectie is gelijk aan het gebruik van de operator summarize.

5. Selecteer + rechts van Groeperen op (samenvatten) om een of meer kolommen te selecteren die worden gebruikt om de waarden in groepen te rangschikken. Deze selectie is gelijk aan de groepsexpressie in de summarize operator.

6. Selecteer Query uitvoeren.

   

   Tip

   Terwijl u de instellingen in de opbouwfunctie voor query's voltooit, wordt er een Kusto-querytaal query gemaakt. Deze query toont de logica die u hebt gemaakt met behulp van de grafische query-editor.

7. Selecteer KQL bewerken om naar de onbewerkte modus te gaan. Bewerk uw query met behulp van de flexibiliteit en kracht van de Kusto-querytaal.

Onbewerkte modus

Gebruik de onbewerkte modus om uw query te bewerken.

1. Plak in het queryvenster de volgende query en selecteer vervolgens Uitvoeren. De query laadt het aantal gebeurtenissen per dag voor de voorbeeldgegevensset.

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

   

2. In de grafiek worden geen resultaten weergegeven omdat het bereik (standaard) is ingesteld op gegevens van de afgelopen zes uur. Selecteer Afgelopen 6 uur in het bovenste menu.

   

3. Geef een aangepast bereik op dat betrekking heeft op 2007, het jaar dat is opgenomen in de StormEvents-voorbeeldgegevensset. Selecteer vervolgens Toepassen.

   

   In de grafiek worden nu de gegevens van 2007 weergegeven, gesorteerd per dag.

   

4. Selecteer in het bovenste menu het pictogram Opslaan: .

Als u wilt overschakelen naar de opbouwmodus voor query's, selecteert u Overschakelen naar opbouwfunctie. Grafana converteert de query naar de beschikbare logica in de opbouwfunctie voor query's. De logica van de opbouwfunctie voor query's is beperkt, waardoor handmatige wijzigingen die u in de query hebt aangebracht, mogelijk verloren gaan.

Waarschuwingen maken

1. Selecteer in Het startdashboardde optie Meldingskanalen waarschuwen> om een nieuw meldingskanaal te maken.

   

2. Voer een naam en type in onder Nieuw meldingskanaal en selecteer vervolgens Opslaan.

   

3. Selecteer bewerken in de vervolgkeuzelijst op het dashboard.

   

4. Selecteer het waarschuwingspictogram om het deelvenster Waarschuwing te openen. Selecteer Waarschuwing maken en voltooi vervolgens de eigenschappen voor de waarschuwing.

   

5. Selecteer het pictogram Dashboard opslaan om uw wijzigingen op te slaan.

Gerelateerde inhoud

• Query's schrijven voor Azure Data Explorer