Gegevens uit Azure Data Explorer in Grafana visualiseren

  • Artikel
  • 8 minuten om te lezen

Grafana is een analyseplatform waarmee u gegevens kunt opvragen en visualiseren en vervolgens dashboards kunt maken en delen op basis van uw visualisaties. Grafana biedt een Azure Data Explorer-invoeging,waarmee u verbinding kunt maken met gegevens van Azure Data Explorer. In dit artikel leert u hoe u een Azure Data Explorer als een gegevensbron voor Grafana kunt instellen en vervolgens gegevens uit een voorbeeldcluster kunt visualiseren.

Gebruik de volgende video voor meer informatie over het gebruik van de Azure Data Explorer-invoegcode van Grafana, het instellen van Azure Data Explorer als een gegevensbron voor Grafana en het visualiseren van gegevens.

In plaats daarvan kunt u de gegevensbron configureren en gegevens visualiseren zoals beschreven in het onderstaande artikel.

Vereisten

De set met voorbeeldgegevens StormEvents bevat gegevens van het weer afkomstig van de National Centers for Environmental Information.

De gegevensbron configureren

U voert de volgende stappen uit om een Azure Data Explorer als gegevensbron voor uw dashboardhulpprogramma te configureren. Deze stappen worden in deze sectie in meer detail besproken:

  1. Maak een Azure Active Directory (Azure AD)-service-principal. De service-principal wordt door uw dashboardhulpprogramma gebruikt om toegang te krijgen tot Azure Data Explorer service.

  2. Voeg de Azure AD-service-principal toe aan de rol viewers in Azure Data Explorer database.

  3. Geef de verbindingseigenschappen van uw dashboardhulpprogramma op op basis van gegevens van de Azure AD-service-principal en test vervolgens de verbinding.

Een service-principal maken

U kunt de service-principal maken in de Azure Portal of met behulp van de Azure CLI-opdrachtregelervaring. Ongeacht welke methode u gebruikt, na het maken krijgt u waarden voor vier verbindingseigenschappen die u in latere stappen gaat gebruiken.

Azure Portal

  1. Als u de service-principal wilt maken, volgt u de instructies in de Azure Portal documentatie.

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

    2. Kopieer in de sectie Waarden voor aanmelden de drie eigenschapswaarden die in de stappen worden behandeld: Map-id (tenant-id), Toepassings-iden Wachtwoord.

  2. Selecteer in Azure Portal abonnementen en kopieer vervolgens de id voor het abonnement waarin u de service-principal hebt gemaakt.

    Abonnements-id - portal.

Azure CLI

  1. Een service-principal maken. Stel een geschikt bereik en een roltype van reader in.

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

    Zie Een Azure-service-principalmaken met Azure CLI voor meer informatie.

  2. De opdracht retourneert een resultatenset die er als volgt uit ziet. Kopieer de drie eigenschapswaarden: appID,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. Haal een lijst met uw abonnementen op.

    az account list --output table

    Kopieer de juiste abonnements-id.

    Abonnements-id - CLI.

De service-principal toevoegen aan de rol viewers

Nu u een service-principal hebt, voegt u deze toe aan de rol viewers 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 Azure Portal naar uw Azure Data Explorer cluster.

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

    Selecteer database.

  3. Selecteer Machtigingen en vervolgens Toevoegen.

    Databasemachtigingen.

  4. Selecteer onder Databasemachtigingen toevoegende rol Kijker en vervolgens Principals selecteren.

    Voeg databasemachtigingen toe.

  5. Zoek de service-principal die u hebt gemaakt. Selecteer de principal en selecteer vervolgens.

    Schermopname van Azure Portal deelvenster Nieuwe principals. De knop Selecteren en twee velden met indecipherable service-principal-eigenschappen zijn gemarkeerd.

  6. Selecteer Opslaan.

    Schermopname van het deelvenster Databasemachtigingen toevoegen in Azure Portal. De knop Opslaan is gemarkeerd.

Beheeropdracht - Query

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

    Schermopname van Azure Data Explorer cluster in de Azure Portal. Het item Query is gemarkeerd.

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

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

    De opdracht retourneert een resultatenset die er als volgt uit ziet. In dit voorbeeld is de eerste rij voor een bestaande gebruiker in de database en de tweede rij voor de service-principal die zojuist is toegevoegd.

    Resultatenset.

Eigenschappen opgeven en de verbinding testen

Nu de service-principal is toegewezen aan de rol viewers, geeft u 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 en vervolgens Gegevensbronnen.

    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.

    Verbindingsnaam en -type.

  4. Voer Instellingennaam van het cluster in het formulier {ClusterName} in als https://{ClusterName}.{ Region}.kusto.windows.net. Voer de andere waarden uit de Azure Portal cli in. Zie de tabel onder de volgende afbeelding voor een toewijzing.

    Verbindingseigenschappen.

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

  5. Selecteer Test opslaan.

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

Query's optimaliseren

Er zijn twee functies die kunnen worden gebruikt voor queryoptimalisatie:

Als u de optimalisatie wilt uitvoeren, voert u in Gegevensbronnen InstellingenQueryoptimalisatiesde benodigde wijzigingen aan.

Deelvenster Queryoptimalisatie.

Prestaties van het weergeven van dashboardquery's optimaliseren met behulp van queryresultaten in de caching

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 queryresultaten in de caching in om de prestaties van het weergeven 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 het weergeven van de resultatencache in te stellen:

  1. Schakel Dynamisch in deaching gebruiken uit.
  2. Voer in Maximale leeftijd vancache het aantal minuten in waarin u de resultaten in de cache wilt gebruiken.

Zwakke consistentie inschakelen

Clusters worden geconfigureerd met sterke consistentie. Dit garandeert dat de queryresultaten up-to-date zijn met alle wijzigingen in het cluster. Bij het inschakelen van zwakke consistentie kunnen queryresultaten een vertraging van 1-2 minuten hebben na clusterwijzigingen. Aan de andere kant kan zwakke consistentie de weergavetijd van visuals verbeteren. Als onmiddellijke consistentie daarom niet essentieel is en de prestaties marginaal zijn, moet u zwakke consistentie inschakelen om de prestaties te verbeteren. Zie Queryconsistentie voor meer informatie over queryconsistentie.

Als u zwakke consistentie wilt inschakelen, selecteert u zwakke in het deelvenster QueryoptimalisatiesGegevensconsistentie.

Gegevens visualiseren

Nu u klaar bent met het configureren Azure Data Explorer als een gegevensbron voor Grafana, is het tijd om gegevens te visualiseren. We laten een eenvoudig voorbeeld zien met zowel de opbouwmodus voor query's als de onbewerkte modus van de query-editor. U kunt het beste Write queries for Azure Data Explorer voor voorbeelden van andere query's die moeten worden uitgevoerd op de voorbeeldgegevensset.

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

    Dashboard maken.

  2. Selecteer op het tabblad Toevoegen de optie Nieuw deelvenster toevoegen.

    Grafiek toevoegen.

  3. Selecteer in het grafiekvenster Panel Title en vervolgensEdit.

    Deelvenster Bewerken.

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

    Selecteer gegevensbron.

Opbouwmodus voor query's

De queryeditor heeft twee modi. De opbouwmodus voor query's en de onbewerkte modus. Gebruik de opbouwmodus voor query's om uw query te definiëren.

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

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

    Selecteer tabel in de opbouwfunctie voor query's.

  3. Zodra de tabel is gedefinieerd, filtert u de gegevens, selecteert u de waarden die moeten worden presenteren en definieert u de groepering van deze waarden.

    Filter

    1. Klik + rechts van Waar + een of meer kolommen in de tabel in de vervolgkeuzelijst te selecteren.
    2. Definieer voor elk filter de waarde(s) met behulp van de toepasselijke operator. Deze selectie is vergelijkbaar met het gebruik van de operator where in kusto-querytaal.

    Waardeselectie

    1. Klik + rechts van + in de vervolgkeuzepagina de waardekolommen te selecteren die in het deelvenster worden weergegeven.
    2. Stel voor elke waardekolom het aggregatietype in. Een of meer waardekolommen kunnen worden ingesteld. Deze selectie is gelijk aan het gebruik van de samenvatten-operator.

    Waardegroepering
    Klik + rechts van + om een of meer kolommen in de vervolgkeuzepagina te selecteren die worden gebruikt om de waarden in groepen te rangschikken. Dit is gelijk aan de groepsexpressie in de samenvatten-operator.

  4. Selecteer Query uitvoeren om de query uit te voeren.

    Opbouwfunctie voor query's met alle voltooide waarden.

    Tip

    Tijdens het uitvoeren van de instellingen in de opbouwfunctie voor query's wordt er een Kusto-querytaalquery gemaakt. Deze query toont de logica die u hebt gemaakt met de grafische queryeditor.

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

Opbouwfunctie voor query's met onbewerkte query.

Onbewerkte modus

Gebruik de onbewerkte modus om uw query te bewerken.

  1. Kopieer in het querydeelvenster de volgende query en selecteer vervolgens Query uitvoeren. Met de query wordt het aantal gebeurtenissen per dag voor de voorbeeldgegevensset verzameld.

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

    Voer de query uit.

  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.

    Afgelopen zes uur.

  3. Geef een aangepast bereik op voor 2007, het jaar dat is opgenomen in onze StormEvents-voorbeeldgegevensset. Selecteer Toepassen.

    Aangepast datumbereik.

    De grafiek toont nu de gegevens uit 2007, verzameld per dag.

    Voltooide grafiek.

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

Belangrijk

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 en daarom kunnen handmatige wijzigingen in de query verloren gaan.

Ga naar builder vanuit de onbewerkte modus.

Waarschuwingen maken

  1. Selecteer in het startdashboard Waarschuwingsmeldingenkanalen om een nieuw meldingskanaal te maken

    meldingskanaal maken.

  2. Maak een nieuw meldingskanaalen klik vervolgens op Opslaan.

    Maak een nieuw meldingskanaal.

  3. Selecteer in het Dashboardbewerken in de vervolgkeuzekeuze.

    selecteer Bewerken in het dashboard.

  4. Selecteer het pictogram van een waarschuwingsbel om het deelvenster Waarschuwing te openen. Selecteer Waarschuwing maken. Voltooi de volgende eigenschappen in het deelvenster Waarschuwing.

    waarschuwingseigenschappen.

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

Volgende stappen