Vizualizace dat z Azure Data Exploreru v Grafaně

Grafana je analytická platforma, kde můžete dotazovat a vizualizovat data a pak vytvářet a sdílet řídicí panely na základě vizualizací. Grafana poskytuje modul plug-in Azure Data Explorer, který umožňuje připojit se k datům z Azure Data Explorer a vizualizovat je. Modul plug-in funguje jak se službou Azure Managed Grafana , tak se službou Grafana v místním prostředí.

V tomto článku se dozvíte, jak nakonfigurovat cluster jako zdroj dat pro Grafana a vizualizovat data v Grafaně pro službu Azure Managed Grafana a Grafana v místním prostředí. Pokud chcete postupovat podle příkladů v tomto článku, ingestujte ukázková data StormEvents. Ukázková datová sada StormEvents obsahuje data související s počasím z národních center pro informace o životním prostředí.

Požadavky

• V případě služby Azure Managed Grafana se jedná o účet Azure a instanci Azure Managed Grafana .
• Pro místní grafana, Grafana verze 5.3.0 nebo novější pro váš operační systém a modul plug-in Azure Data Explorer pro Grafana. K použití Tvůrce dotazů Grafana potřebujete modul plug-in verze 3.0.5 nebo novější.
• Cluster a databáze Azure Data Explorer. Můžete vytvořit bezplatný cluster nebo úplný cluster. Pokud se chcete rozhodnout, který je pro vás nejvhodnější, podívejte se na porovnání funkcí.

Konfigurace zdroje dat

Pokud chcete nakonfigurovat Azure Data Explorer jako zdroj dat, postupujte podle pokynů pro vaše prostředí Grafana.

Azure Managed Grafana

Přidání spravované identity do role čtenáře

Managed Grafana ve výchozím nastavení vytvoří spravovanou identitu přiřazenou systémem pro každý nový pracovní prostor. Můžete ho použít pro přístup ke clusteru Azure Data Explorer.

1. V Azure Portal přejděte do clusteru Azure Data Explorer.

2. V části Přehled vyberte databázi, která obsahuje ukázková data StormEvents .

   

3. Vyberte Oprávnění>Přidat>prohlížeč.

   

4. Do vyhledávacího pole zadejte název pracovního prostoru Spravované grafany.

5. Ve výsledcích hledání vyberte výsledek, který odpovídá názvu vašeho pracovního prostoru, a pak zvolte Vybrat.

   

Nastavení Azure Data Explorer jako zdroje dat Grafana

Spravované pracovní prostory Grafana mají předinstalovaný modul plug-in Azure Data Explorer.

1. V Azure Portal přejděte do pracovního prostoru Managed Grafana.

2. V části Přehled vyberte odkaz Koncový bod a otevřete uživatelské rozhraní Grafana.

3. V nabídce vlevo v Grafaně vyberte ikonu ozubeného kola. Pak vyberte Zdroje dat.

   

4. Vyberte Azure Data Explorer Datasource.

   

5. V části Podrobnosti o připojení zadejte adresu URL clusteru Azure Data Explorer.

   

6. Vyberte Uložit & test.

Grafana v místním prostředí

Vytvoření instančního objektu

Instanční objekt můžete vytvořit v Azure Portal nebo pomocí prostředí příkazového řádku Azure CLI. Po vytvoření instančního objektu získáte hodnoty pro čtyři vlastnosti připojení, které použijete v pozdějších krocích.

portál Azure

1. Postupujte podle pokynů v dokumentaci k Azure Portal. Použijte tyto konkrétní informace:

   1. V části Přiřazení aplikace k roli přiřaďte clusteru Azure Data Explorer typ role Čtenář.

   2. V části Získání hodnot pro přihlášení zkopírujte hodnoty pro tři vlastnosti popsané v krocích: ID adresáře (ID tenanta ), ID aplikace a Heslo.

2. V Azure Portal vyberte Předplatná. Pak zkopírujte ID předplatného, ve kterém jste vytvořili instanční objekt.

   

Azure CLI

1. Pomocí následujícího příkazu vytvořte instanční objekt. Nastavte odpovídající obor a typ role .reader

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

   Další informace najdete v tématu Vytvoření instančního objektu Azure pomocí Azure CLI.

2. Příkaz vrátí sadu výsledků jako v následujícím příkladu. Zkopírujte hodnoty vlastností appId, passworda 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. Získejte seznam předplatných:

   az account list --output table
   

   Zkopírujte příslušné ID předplatného.

   

Přidání instančního objektu do role Čtenář

Teď, když máte instanční objekt, přidáte ho do role Čtenář v databázi Azure Data Explorer. Tuto úlohu můžete provést v části Oprávnění v Azure Portal nebo v části Dotaz pomocí příkazu pro správu.

Azure Portal: Oprávnění

1. V Azure Portal přejděte do clusteru Azure Data Explorer.

2. V části Přehled vyberte databázi, která obsahuje ukázková data StormEvents.

   

3. Vyberte Přidat oprávnění>.

   

4. V části Přidat oprávnění databáze vyberte roli Čtenář a pak zvolte Vybrat objekty zabezpečení.

   

5. Vyhledejte instanční objekt, který jste vytvořili. Vyberte objekt zabezpečení a pak zvolte Vybrat.

   

6. Vyberte Uložit.

   

Příkaz pro správu: Dotaz

1. V Azure Portal přejděte do clusteru Azure Data Explorer a vyberte Dotaz.

   

2. V okně dotazu spusťte následující příkaz. Použijte ID aplikace a ID tenanta z Azure Portal nebo Azure CLI.

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

   Příkaz vrátí sadu výsledků. V následujícím příkladu je první řádek pro existujícího uživatele v databázi. Druhý řádek je pro instanční objekt, který jste právě přidali.

   

Zadejte vlastnosti a otestujte připojení.

S instančním objektem přiřazeným k roli Čtenář teď zadáte vlastnosti v instanci Grafany a otestujete připojení k Azure Data Explorer.

1. V nabídce vlevo v Grafaně vyberte ikonu ozubeného kola. Pak vyberte Zdroje dat.

   

2. Vyberte Přidat zdroj dat.

3. Na stránce Zdroje dat / Nový zadejte název zdroje dat a pak vyberte typ Azure Data Explorer Zdroj dat.

   

4. V části Podrobnostio připojení nastavení > zadejte název clusteru ve formátu https://{ClusterName}.{Region}.kusto.windows.net. Zadejte další hodnoty z Azure Portal nebo Azure CLI. Jako vodítko použijte následující informace o mapování.

   Uživatelské rozhraní Grafana	portál Azure	Azure CLI
   ID předplatného	ID PŘEDPLATNÉHO	SubscriptionId
   ID tenanta	ID adresáře	tenant
   ID klienta	ID aplikace	appId
   Tajný kód klienta	Heslo	password

   

5. Vyberte Uložit & test.

   Pokud je test úspěšný, přejděte k další části. Pokud máte nějaké problémy, zkontrolujte hodnoty, které jste zadali v Grafaně, a projděte si předchozí kroky.

Optimalizace dotazů

K optimalizaci dotazů můžete použít dvě funkce:

• Optimalizace výkonu vykreslování dotazů řídicího panelu
• Povolení slabé konzistence

Pokud chcete provést optimalizaci, proveďte potřebné změny včásti Nastavení>zdrojů> datOptimalizace dotazů.

Optimalizace výkonu vykreslování dotazů řídicího panelu

Když je řídicí panel nebo vizuál vykreslován více než jednou jedním uživatelem, Grafana ve výchozím nastavení odešle do Azure Data Explorer alespoň jeden dotaz. Povolte ukládání výsledků dotazů do mezipaměti, abyste zlepšili výkon vykreslování řídicích panelů a snížili zatížení clusteru Azure Data Explorer.

Během zadaného časového rozsahu azure Data Explorer použije mezipaměť výsledků k načtení předchozích výsledků a nespustí nepotřebný dotaz. Tato funkce je zvlášť účinná při snižování zatížení prostředků a zvýšení výkonu, když stejný řídicí panel používá více uživatelů.

Pokud chcete povolit vykreslování mezipaměti výsledků, postupujte v podokně Optimalizace dotazů takto:

1. Vypněte možnost Používat dynamické ukládání do mezipaměti.
2. V části Maximální stáří mezipaměti zadejte počet minut, během kterých chcete výsledky uložené v mezipaměti používat.

Povolení slabé konzistence

Clustery jsou nakonfigurované se silnou konzistencí. Tato výchozí konfigurace zaručuje, že výsledky dotazů budou aktuální se všemi změnami v clusteru.

Když povolíte slabou konzistenci, výsledky dotazu můžou mít po změnách clusteru prodlevu 1 až 2 minuty. Slabá konzistence ale může zvýšit dobu vykreslování vizuálu. Pokud okamžitá konzistence není kritická a výkon je marginální, povolte slabou konzistenci, abyste zvýšili výkon. Další informace najdete v tématu Konzistence dotazů.

Pokud chcete povolit slabou konzistenci, vyberte v podokně Optimalizace dotazůmožnost Konzistence> datSlabá.

Vizualizace dat

Dokončili jste konfiguraci Azure Data Explorer jako zdroje dat pro Grafana. Teď je čas vizualizovat data.

Následující základní příklad používá režim tvůrce dotazů i režim nezpracovaného editoru dotazů. Doporučujeme zobrazit si dotazy na zápis pro Azure Data Explorer s příklady dalších dotazů, které se mají na datovou sadu spustit.

1. V nabídce vlevo v Grafaně vyberte ikonu plus. Pak vyberte Řídicí panel.

   

2. Na kartě Přidat vyberte Graf.

   

3. V podokně grafu vyberteUpravitnázev> panelu.

   

4. V dolní části podokna vyberte Zdroj dat a pak vyberte zdroj dat, který jste nakonfigurovali.

   

Režim tvůrce dotazů

K definování dotazu použijte režim tvůrce dotazů.

1. Pod zdrojem dat vyberte Databáze a v rozevíracím seznamu zvolte databázi.

2. Vyberte Od a v rozevíracím seznamu zvolte svoji tabulku.

   

3. Teď, když je tabulka definovaná, vyfiltrujte data:

   1. Vyberte + napravo od kde (filtr) a vyberte jeden nebo více sloupců v tabulce.
   2. Pro každý filtr definujte hodnoty pomocí příslušného operátoru. Tento výběr se podobá použití operátoru where v dotazovací jazyk Kusto.

4. Vyberte hodnoty, které chcete v tabulce prezentovat:

   1. Vyberte + napravo od sloupce Hodnota a vyberte sloupce hodnot, které se zobrazí v podokně.

   2. Pro každý sloupec hodnot nastavte typ agregace.

      Můžete nastavit jeden nebo více sloupců hodnot. Tento výběr je ekvivalentní použití operátoru sumarizace.

5. Vyberte + napravo od možnosti Seskupit podle (shrnout) a vyberte jeden nebo více sloupců, které se použijí k uspořádání hodnot do skupin. Tento výběr je ekvivalentní výrazu skupiny v operátoru summarize .

6. Vyberte Spustit dotaz.

   

   Tip

   Při dokončování nastavení v tvůrci dotazů se vytvoří dotazovací jazyk Kusto dotaz. Tento dotaz ukazuje logiku, kterou jste vytvořili pomocí grafického editoru dotazů.

7. Výběrem možnosti Upravit KQL přejděte do režimu nezpracované verze. Upravte dotaz pomocí flexibility a výkonu dotazovací jazyk Kusto.

Nezpracovaný režim

K úpravě dotazu použijte nezpracovaný režim.

1. V podokně dotazu vložte následující dotaz a pak vyberte Spustit. Dotaz pro ukázkovou datovou sadu započítá počet událostí podle dne.

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

   

2. Graf nezobrazuje žádné výsledky, protože je vymezený (ve výchozím nastavení) na data za posledních šest hodin. V horní nabídce vyberte Posledních 6 hodin.

   

3. Zadejte vlastní rozsah, který pokrývá rok 2007, který je součástí ukázkové datové sady StormEvents. Pak vyberte Použít.

   

   Graf teď zobrazuje data z roku 2007 rozdělená do intervalů po dnech.

   

4. V horní nabídce vyberte ikonu pro uložení: .

Pokud chcete přepnout do režimu tvůrce dotazů, vyberte Přepnout na tvůrce. Grafana převede dotaz na dostupnou logiku v tvůrci dotazů. Logika tvůrce dotazů je omezená, takže můžete ztratit ruční změny provedené v dotazu.

Vytváření upozornění

1. Na domovském řídicím panelu vyberte Kanály upozornění>a vytvořte nový kanál oznámení.

   

2. Zadejte název a typ v části Nový kanál oznámení a pak vyberte Uložit.

   

3. Na řídicím panelu vyberte v rozevíracím seznamu Upravit .

   

4. Výběrem ikony zvonku upozornění otevřete podokno Výstraha . Vyberte Vytvořit upozornění a pak vyplňte vlastnosti výstrahy.

   

5. Výběrem ikony Uložit řídicí panel uložte změny.

Související obsah

• Psaní dotazů pro Azure Data Explorer