Visualisera data från Azure Data Explorer i Grafana

  • Artikel
  • 7 minuter för att läsa

Grafana är en analysplattform som gör att du kan köra frågor mot och visualisera data och sedan skapa och dela instrumentpaneler baserat på dina visualiseringar. Grafana har ett Azure Data Explorer plugin-programsom gör att du kan ansluta till och visualisera data från Azure Data Explorer. I den här artikeln får du lära dig att konfigurera Azure Data Explorer som en datakälla för Grafana och sedan visualisera data från ett exempelkluster.

Använd följande video för att lära dig hur du använder Grafanas plugin Azure Data Explorer program, ställ in Azure Data Explorer som en datakälla för Grafana och sedan visualisera data.

I stället kan du konfigurera datakällanoch visualisera data enligt beskrivningen i artikeln nedan.

Förutsättningar

I exempeldatauppsättningen StormEvents finns väderrelaterade data från National Centers for Environmental Information.

Konfigurera datakällan

Du utför följande steg för att konfigurera Azure Data Explorer som en datakälla för ditt instrumentpanelsverktyg. Vi går in mer ingående på de här stegen i det här avsnittet:

  1. Skapa ett Azure Active Directory (Azure AD) för tjänstens huvudnamn. Tjänstens huvudnamn används av ditt instrumentpanelsverktyg för att komma åt Azure Data Explorer tjänsten.

  2. Lägg till Azure AD-tjänstens huvudnamn till tittarrollen i Azure Data Explorer databasen.

  3. Ange anslutningsegenskaper för instrumentpanelsverktyget baserat på information från Azure AD-tjänstens huvudnamn och testa sedan anslutningen.

Skapa ett huvudnamn för tjänsten

Du kan skapa tjänstens huvudnamn i Azure Portal eller använda Azure CLI-kommandoradsupplevelsen. Oavsett vilken metod du använder får du efter skapandet värden för fyra anslutningsegenskaper som du ska använda i senare steg.

Azure Portal

  1. Skapa tjänstens huvudnamn genom att följa anvisningarna i Azure Portal dokumentationen.

    1. I avsnittet Tilldela programmet till en roll tilldelar du rolltypen Läsare till ditt Azure Data Explorer kluster.

    2. I avsnittet Hämta värden för inloggning kopierar du de tre egenskapsvärdena som ingår i stegen: Katalog-ID (klient-ID), Program-IDoch Lösenord.

  2. I den Azure Portal väljer du Prenumerationer och kopierar sedan ID:t för den prenumeration där du skapade tjänstens huvudnamn.

    Prenumerations-ID – portalen.

Azure CLI

  1. Skapa ett huvudnamn för tjänsten. Ange ett lämpligt omfång och en rolltyp för reader .

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

    Mer information finns i Skapa ett huvudnamn för Azure-tjänsten med Azure CLI.

  2. Kommandot returnerar en resultatuppsättning som liknar följande. Kopiera de tre egenskapsvärdena: appID,passwordoch 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. Hämta en lista över dina prenumerationer.

    az account list --output table

    Kopiera lämpligt prenumerations-ID.

    Prenumerations-ID – CLI.

Lägga till tjänstens huvudnamn till tittarrollen

Nu när du har ett huvudnamn för tjänsten kan du lägga till det i tittarrollen i Azure Data Explorer databasen. Du kan utföra den här uppgiften under Behörigheter i Azure Portal eller under Fråga med hjälp av ett hanteringskommando.

Azure Portal – Behörigheter

  1. I Azure Portal du till ditt Azure Data Explorer kluster.

  2. I avsnittet Översikt väljer du databasen med StormEvents-exempeldata.

    Välj databas.

  3. Välj Behörigheter och sedan Lägg till.

    Databasbehörigheter.

  4. Under Lägg till databasbehörigheterväljer du rollen Läsare och sedan Välj huvudnamn.

    Lägg till databasbehörigheter.

  5. Sök efter tjänstens huvudnamn som du skapade. Välj huvudnamn och sedan Välj.

    Skärmbild av fönstret Azure Portal Nya huvudnamn. Knappen Välj och två fält med inchiffrbara egenskaper för tjänstens huvudnamn är markerade.

  6. Välj Spara.

    Skärmbild av fönstret Lägg till databasbehörigheter i Azure Portal. Knappen Spara är markerad.

Hanteringskommando – Fråga

  1. I Azure Portal du till ditt Azure Data Explorer kluster och väljer Fråga.

    Skärmbild av ett Azure Data Explorer kluster i Azure Portal. Frågeobjektet är markerat.

  2. Kör följande kommando i frågefönstret. Använd program-ID och klientorganisations-ID från Azure Portal eller CLI.

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

    Kommandot returnerar en resultatuppsättning som liknar följande. I det här exemplet är den första raden för en befintlig användare i databasen och den andra raden är för tjänstens huvudnamn som precis har lagts till.

    Resultatuppsättning.

Ange egenskaper och testa anslutningen

Med tjänstens huvudnamn tilldelat till tittarrollen anger du nu egenskaper i din instans av Grafana och testar anslutningen till Azure Data Explorer.

  1. På den vänstra menyn i Grafana väljer du kugghjulsikonen och sedan Datakällor.

    Datakällor.

  2. Välj Lägg till datakälla.

  3. På sidan Datakällor/ny anger du ett namn för datakällan och väljer sedan typen Azure Data Explorer Datakälla.

    Anslutningsnamn och typ.

  4. I Inställningaranslutningsinformation anger du namnet på klustret i formuläret https://{ClusterName}.{ Region}.kusto.windows.net. Ange de andra värdena från Azure Portal eller CLI. En mappning finns i tabellen nedan.

    Anslutningsegenskaper.

    Grafana-användargränssnitt Azure Portal Azure CLI
    Prenumerations-ID PRENUMERATIONS-ID SubscriptionId
    Klientorganisations-ID Katalog-ID tenant
    Klient-ID Program-ID:t appId
    Klienthemlighet Lösenord password

  5. Välj Spara test.

    Om testet lyckas går du till nästa avsnitt. Om du får problem kontrollerar du de värden som du angav i Grafana och granskar tidigare steg.

Optimera frågor

Det finns två funktioner som kan användas för frågeoptimering:

Utför optimeringen genom att i DatakällorInställningarfrågeoptimeringargöra nödvändiga ändringar.

Fönstret Frågeoptimering.

Optimera prestanda för frågeåtergivning på instrumentpanelen med cachelagring av frågeresultat

När en instrumentpanel eller ett visuellt objekt återges mer än en gång av en eller flera användare skickar Grafana som standard minst en fråga till Azure Data Explorer. Aktivera cachelagring av frågeresultat för att förbättra prestanda för återgivning av instrumentpaneler och minska belastningen Azure Data Explorer klustret. Under det angivna Azure Data Explorer använder du resultatcachen för att hämta tidigare resultat och kör inte en onödig fråga. Den här funktionen är särskilt effektiv för att minska belastningen på resurser och förbättra prestanda när flera användare använder samma instrumentpanel.

Om du vill aktivera rendering av resultatcache gör du följande i fönstret Frågeoptimeringar:

  1. Inaktivera Använd dynamisk cachelagring.
  2. I Maxålder förcache anger du det antal minuter som du vill använda cachelagrade resultat under.

Aktivera svag konsekvens

Kluster konfigureras med stark konsekvens. Detta garanterar att frågeresultaten är uppdaterade med alla ändringar i klustret. När du aktiverar svag konsekvens kan frågeresultaten ha en fördröjning på 1–2 minuter efter klusterändringarna. Å andra sidan kan en svag konsekvens öka återgivningstiden för visuella objekt. Om omedelbar konsekvens inte är kritisk och prestandan är marginal bör du därför aktivera svag konsekvens för att förbättra prestandan. Mer information om frågekonsekvens finns i Frågekonsekvens.

Om du vill aktivera svag konsekvens går du till fönstret FrågeoptimeringarDatakonsekvensoch väljer Svag.

Visualisera data

Nu när du har konfigurerat Azure Data Explorer som datakälla för Grafana är det dags att visualisera data. Vi visar ett grundläggande exempel med både frågebyggareläget och raw-läget i frågeredigeraren. Vi rekommenderar att du tittar på Skriv frågor för Azure Data Explorer exempel på andra frågor som ska köras mot exempeldatauppsättningen.

  1. På den vänstra menyn i Grafana väljer du plusikonen och sedan Instrumentpanel.

    Skapa instrumentpanel.

  2. Under fliken Lägg till väljer du Lägg till ny panel.

    Lägg till diagram.

  3. På grafpanelen väljer du Panelrubrik och sedan Redigera.

    Redigera panel.

  4. Längst ned på panelen väljer du Datakälla och sedan den datakälla som du har konfigurerat.

    Välj datakälla.

Läge för frågebyggare

Frågeredigeraren har två lägen. Läget för frågebyggaren och raw-läget. Använd läget för frågebyggaren för att definiera frågan.

  1. Under datakällan väljer du Databas och väljer din databas i listrutan.

  2. Välj Från och välj din tabell i listrutan.

    Välj tabell i frågebyggaren.

  3. När tabellen har definierats filtrerar du data, väljer de värden som ska visas och definierar gruppering av dessa värden.

    Filter

    1. Klicka + till höger om Var + för att välja en eller flera kolumner i tabellen i listrutan.
    2. För varje filter definierar du värdet(erna) med hjälp av den tillämpliga operatorn. Det här valet liknar att använda operatorn where i Kusto-frågespråket.

    Val av värde

    1. Klicka + till höger om + för att välja de värdekolumner i listrutan som ska visas i panelen.
    2. Ange sammansättningstyp för varje värdekolumn. En eller flera värdekolumner kan anges. Det här valet motsvarar att använda summarize-operatorn.

    Värdegruppering
    Klicka + till höger om Gruppera efter + för att välja en eller flera kolumner i listrutan som ska användas för att ordna värdena i grupper. Detta motsvarar grupputtrycket i operatorn summarize.

  4. Om du vill köra frågan väljer du Kör fråga.

    Frågebyggaren med alla värden slutförda.

    Tips

    När du slutför inställningarna i frågebyggaren skapas en Kusto-frågespråkfråga. Den här frågan visar logiken som du har konstruerat med den grafiska frågeredigeraren.

  5. Välj Redigera KQL för att flytta till obearbetat läge och redigera frågan med hjälp av flexibiliteten och kraften i Kusto-frågespråket.

Frågebyggare med råfråga.

Raw-läge

Använd raw-läget för att redigera frågan.

  1. I frågefönstret kopierar du följande fråga och väljer sedan Kör fråga. Frågan buckets antalet händelser per dag för exempeldatauppsättningen.

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

    Kör fråga.

  2. Diagrammet visar inga resultat eftersom det är begränsad till data från de senaste sex timmarna som standard. Välj Senaste 6 timmarna på den översta menyn.

    Senaste sex timmarna.

  3. Ange ett anpassat intervall som omfattar 2007, året som ingår i vår StormEvents-exempeldatauppsättning. Välj Använd.

    Anpassat datumintervall.

    Nu visar diagrammet data från 2007, bucketerade per dag.

    Färdig graf.

  4. På den översta menyn väljer du ikonen Spara: Ikonen Spara..

Viktigt

Om du vill växla till läget för frågebyggaren väljer du Växla till byggare. Grafana konverterar frågan till den tillgängliga logiken i Query Builder. Logiken för frågebyggaren är begränsad och därför kan du förlora manuella ändringar som gjorts i frågan.

Flytta till byggaren från obearbetat läge.

Skapa aviseringar

  1. Skapa en ny aviseringskanal genom att välja Aviseringsaviseringskanaler på Start-instrumentpanelen

    skapa meddelandekanal.

  2. Skapa en ny meddelandekanaloch sedan Spara.

    Skapa en ny meddelandekanal.

  3. På instrumentpanelenväljer du Redigera i listrutan.

    välj redigera på instrumentpanelen.

  4. Välj klockikonen för aviseringar för att öppna fönstret Avisering. Välj Skapa avisering. Slutför följande egenskaper i fönstret Avisering.

    aviseringsegenskaper.

  5. Välj ikonen Spara instrumentpanel för att spara ändringarna.

Nästa steg