Visualisera data från Azure Data Explorer i Grafana

Grafana är en analysplattform där du kan fråga och visualisera data och sedan skapa och dela instrumentpaneler baserat på dina visualiseringar. Grafana tillhandahåller ett Azure-Data Explorer-plugin-program som gör att du kan ansluta till och visualisera data från Azure Data Explorer. Plugin-programmet fungerar med både Azure Managed Grafana och grafana med egen värd.

I den här artikeln får du lära dig hur du konfigurerar klustret som en datakälla för Grafana och visualiserar data i Grafana för Azure Managed Grafana och grafana med egen värd. Om du vill följa exemplen i den här artikeln matar du in StormEvents-exempeldata. StormEvents-exempeldatauppsättningen innehåller väderrelaterade data från National Centers for Environmental Information.

Förutsättningar

• För Azure Managed Grafana, ett Azure-konto och Azure Managed Grafana-instans .
• För grafana med egen värd, Grafana version 5.3.0 eller senare för ditt operativsystem och Azure Data Explorer plugin-program för Grafana. Du behöver plugin-program version 3.0.5 eller senare för att använda Grafana-frågeverktyget.
• Ett Azure Data Explorer-kluster och en databas. Du kan skapa ett kostnadsfritt kluster eller skapa ett fullständigt kluster. Kontrollera funktionsjämförelsen för att avgöra vad som är bäst för dig.

Konfigurera datakällan

Om du vill konfigurera Azure Data Explorer som en datakälla följer du stegen för Grafana-miljön.

Azure Managed Grafana

Lägga till den hanterade identiteten i visningsrollen

Hanterad Grafana skapar som standard en systemtilldelad hanterad identitet för varje ny arbetsyta. Du kan använda den för att komma åt ditt Azure Data Explorer-kluster.

1. I Azure Portal går du till ditt Azure Data Explorer-kluster.

2. I avsnittet Översikt väljer du den databas som har StormEvents-exempeldata .

   

3. Välj Behörigheter>Lägg till>visningsprogram.

   

4. I sökrutan anger du namnet på den hanterade Grafana-arbetsytan.

5. I sökresultaten väljer du det resultat som matchar arbetsytans namn och väljer sedan Välj.

   

Konfigurera Azure Data Explorer som grafanadatakälla

Hanterade Grafana-arbetsytor levereras med Azure Data Explorer plugin-programmet förinstallerat.

1. I Azure Portal går du till din hanterade Grafana-arbetsyta.

2. Under Översikt väljer du länken Slutpunkt för att öppna Grafana-användargränssnittet.

3. I Grafana går du till den vänstra menyn och väljer kugghjulsikonen. Välj sedan Datakällor.

   

4. Välj Azure Data Explorer Datasource.

   

5. I Anslutningsinformation anger du url:en för Azure Data Explorer-klustret.

   

6. Välj Spara & test.

Grafana med egen värd

Skapa ett huvudnamn för tjänsten

Du kan skapa tjänstens huvudnamn i Azure Portal eller med hjälp av Azure CLI-kommandoradsmiljön. När du har skapat tjänstens huvudnamn får du värden för fyra anslutningsegenskaper som du ska använda i senare steg.

Azure Portal

1. Följ anvisningarna i Azure Portal-dokumentationen. Använd den här specifika informationen:

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

   2. I avsnittet Hämta värden för inloggning kopierar du värdena för de tre egenskaper som beskrivs i stegen: Katalog-ID (klientorganisations-ID), program-ID och lösenord.

2. I Azure Portal väljer du Prenumerationer. Kopiera sedan ID:t för prenumerationen där du skapade tjänstens huvudnamn.

   

Azure CLI

1. Använd följande kommando för att 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 i följande exempel. Kopiera värdena för appIdegenskaperna , 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.

   

Lägg till tjänstens huvudnamn i rollen Läsare

Nu när du har ett huvudnamn för tjänsten lägger du till det i rollen Läsare 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 går du till ditt Azure Data Explorer-kluster.

2. I avsnittet Översikt väljer du den databas som har StormEvents-exempeldata.

   

3. Välj Behörigheter>Lägg till.

   

4. Under Lägg till databasbehörigheter väljer du rollen Läsare och väljer sedan Välj huvudkonton.

   

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

   

6. Välj Spara.

   

Hanteringskommando: Fråga

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

   

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

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

   Kommandot returnerar en resultatuppsättning. I följande exempel är den första raden för en befintlig användare i databasen. Den andra raden är för tjänstens huvudnamn som du just lade till.

   

Ange egenskaper och testa anslutningen

När tjänstens huvudnamn har tilldelats rollen Läsare anger du nu egenskaper i din instans av Grafana och testar anslutningen till Azure Data Explorer.

1. I Grafana går du till den vänstra menyn och väljer kugghjulsikonen. Välj sedan Datakällor.

   

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

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

   

4. IAnslutningsinformation för inställningar> anger du namnet på klustret i formuläret .https://{ClusterName}.{Region}.kusto.windows.net Ange de andra värdena från Azure Portal eller Azure CLI. Använd följande mappningsinformation som guide.

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

   

5. Välj Spara & test.

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

Optimera frågor

Du kan använda två funktioner för frågeoptimering:

• Optimera prestanda för frågeåtergivning av instrumentpaneler
• Aktivera svag konsekvens

Om du vill utföra optimeringen gör du de nödvändiga ändringarna i Data sourcesSettings>Query Optimizations (Frågeoptimeringar för datakällor>).

Optimera prestanda för frågeåtergivning av instrumentpaneler

När en instrumentpanel eller ett visuellt objekt återges mer än en gång av en eller flera användare skickar Grafana minst en fråga till Azure Data Explorer som standard. Aktivera cachelagring av frågeresultat för att förbättra prestanda för instrumentpanelsrendering och minska belastningen på Azure Data Explorer-klustret.

Under det angivna tidsintervallet använder Azure Data Explorer 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 cacheåtergivning av resultat gör du följande i fönstret Frågeoptimeringar :

1. Inaktivera Använd dynamisk cachelagring.
2. I Cache Max Age anger du det antal minuter under vilka du vill använda cachelagrade resultat.

Aktivera svag konsekvens

Kluster konfigureras med stark konsekvens. Den här standardkonfigurationen 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 till 2 minuter efter klusterändringar. Svag konsekvens kan dock öka tiden för visuell återgivning. Om omedelbar konsekvens inte är kritisk och prestandan är marginell kan du aktivera svag konsekvens för att förbättra prestandan. Mer information finns i Frågekonsekvens.

Om du vill aktivera svag konsekvens går du till fönstret Frågeoptimeringar och väljer Datakonsekvens>Svag.

Visualisera data

Du har konfigurerat Azure Data Explorer som datakälla för Grafana. Nu är det dags att visualisera data.

I följande grundläggande exempel används både frågeverktygets läge och frågeredigerarens råläge. Vi rekommenderar att du visar skrivfrågor för Azure Data Explorer exempel på andra frågor som ska köras mot datauppsättningen.

1. I Grafana går du till den vänstra menyn och väljer plusikonen. Välj sedan Instrumentpanel.

   

2. Under fliken Lägg till väljer du Graph.

   

3. I graffönstret väljer du Redigera panelrubrik>.

   

4. Längst ned i fönstret väljer du Datakälla och sedan den datakälla som du har konfigurerat.

   

Frågeverktygets läge

Använd frågeverktygets läge för att definiera din fråga.

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.

   

3. Nu när tabellen har definierats filtrerar du data:

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

4. Välj de värden som ska visas i tabellen:

   1. Välj + till höger om Värdekolumner för att välja de värdekolumner som ska visas i fönstret.

   2. Ange aggregeringstypen för varje värdekolumn.

      Du kan ange en eller flera värdekolumner. Det här valet motsvarar att använda sammanfattningsoperatorn.

5. Välj + till höger om Gruppera efter (sammanfatta) för att välja en eller flera kolumner som ska användas för att ordna värdena i grupper. Det här valet motsvarar grupputtrycket i operatorn summarize .

6. Välj Kör fråga.

   

   Tips

   När du slutför inställningarna i frågeverktyget skapas en Kusto-frågespråk fråga. Den här frågan visar logiken som du skapade med hjälp av den grafiska frågeredigeraren.

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

Raw-läge

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

1. Klistra in följande fråga i frågefönstret och välj sedan Kör. Frågan bucketar antalet händelser per dag för exempeldatauppsättningen.

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

   

2. Diagrammet visar inga resultat eftersom det är begränsat (som standard) till data från de senaste sex timmarna. På den översta menyn väljer du Senaste 6 timmarna.

   

3. Ange ett anpassat intervall som omfattar 2007, det år som ingår i StormEvents-exempeldatauppsättningen. Välj sedan Använd.

   

   Nu visar diagrammet data från 2007, bucketade efter dag.

   

4. På den översta menyn väljer du spara-ikonen: .

Om du vill växla till frågeverktygets läge väljer du Växla till byggare. Grafana konverterar frågan till den tillgängliga logiken i frågeverktyget. Logiken för frågeverktyget är begränsad, så du kan förlora manuella ändringar som du har gjort i frågan.

Skapa aviseringar

1. I Startinstrumentpanelen väljer du Aviseringskanaler> för att skapa en ny meddelandekanal.

   

2. Ange ett namn och en typ under Ny meddelandekanal och välj sedan Spara.

   

3. På instrumentpanelen väljer du Redigera i listrutan.

   

4. Välj varningsklockaikonen för att öppna fönstret Avisering . Välj Skapa avisering och slutför sedan egenskaperna för aviseringen.

   

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

Relaterat innehåll

• Skriva frågor för Azure Data Explorer