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 Exploreru, který umožňuje připojit se k datům a vizualizovat je z Azure Data Exploreru. Modul plug-in funguje s Grafana spravovanou službou Azure i s místním grafanou.

V tomto článku se dozvíte, jak nakonfigurovat cluster jako zdroj dat pro Grafana a vizualizovat data v Grafana pro 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

• Pro Azure Managed Grafana je to účet Azure a instance Azure Managed Grafana .
• Grafana verze 5.3.0 nebo novější pro váš operační systém a modul plug-in Azure Data Exploreru pro Grafana K používání Tvůrce dotazů Grafana potřebujete modul plug-in verze 3.0.5 nebo novější.
• Cluster a databáze Azure Data Exploreru. Můžete vytvořit bezplatný cluster nebo vytvořit úplný cluster. Pokud se chcete rozhodnout, která z vás je nejvhodnější, zkontrolujte porovnání funkcí.

Konfigurace zdroje dat

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

Azure Managed Grafana

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

Spravovaná 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 Exploreru.

1. Na webu Azure Portal přejděte do clusteru Azure Data Exploreru.

2. V části Přehled vyberte databázi s ukázkovými daty StormEvents.

   

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

   

4. Do vyhledávacího pole zadejte název pracovního prostoru Managed Grafana.

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 Exploreru jako zdroje dat Grafana

Spravované pracovní prostory Grafana se dodávají s předinstalovaným modulem plug-in Azure Data Exploreru.

1. Na webu Azure Portal přejděte do svého spravovaného pracovního prostoru Grafana.

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

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

   

4. Vyberte Zdroj dat Azure Data Exploreru.

   

5. Do podrobností o připojení zadejte adresu URL clusteru Azure Data Exploreru.

   

6. Vyberte Uložit a otestovat.

Grafana v místním prostředí

Vytvoření instančního objektu služby

Instanční objekt můžete vytvořit na webu 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 webu Azure Portal. Použijte tyto konkrétní informace:

   1. V části Přiřadit aplikaci k části role přiřaďte ke clusteru Azure Data Exploreru typ role Čtenář .

   2. V části Získat hodnoty 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. Na webu 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 readerrole .

   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 pro appIdobjekt , passworda tenant vlastnosti.

   {
     "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 Exploreru. Tuto úlohu můžete provést v části Oprávnění na webu Azure Portal nebo v části Dotaz pomocí příkazu pro správu.

Azure Portal: Oprávnění

1. Na webu Azure Portal přejděte do clusteru Azure Data Exploreru.

2. V části Přehled vyberte databázi s ukázkovými daty 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. Zvolte Uložit.

   

Příkaz pro správu: Dotaz

1. Na webu Azure Portal přejděte do clusteru Azure Data Exploreru a pak vyberte Dotaz.

   

2. V okně dotazu spusťte následující příkaz. Použijte ID aplikace a ID tenanta z webu 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.

   

Zadání vlastností a otestování připojení

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

1. V Grafaně v nabídce vlevo 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 Zdroj dat Azure Data Exploreru.

   

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

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

   

5. Vyberte Uložit a otestovat.

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

Optimalizace dotazů

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

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

Pokud chcete provést optimalizaci, proveďte v nastaveních> zdrojů>dat optimalizace dotazů potřebné změny.

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

Když se řídicí panel nebo vizuál vykreslí více než jednou jedním uživatelem, Grafana ve výchozím nastavení odešle do Azure Data Exploreru 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 Exploreru.

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 zlepšení výkonu, když více uživatelů používá stejný řídicí panel.

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

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

Povolení slabé konzistence

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

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

Pokud chcete povolit slabou konzistenci, vyberte v podokně Optimalizace dotazů možnost konzistence>dat Slabá.

Vizualizace dat

Dokončili jste konfiguraci Azure Data Exploreru 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 nezpracovaný režim editoru dotazů. Doporučujeme zobrazit dotazy pro zápis do Azure Data Exploreru pro příklady jiných dotazů, které se mají s datovou sadou spouštět.

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

   

2. Pod kartou Přidat vyberte Graf.

   

3. V podokně grafu vyberte Upravit ná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ázi a v rozevíracím seznamu zvolte databázi.

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

   

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

   1. Výběrem + vpravo od místa kde (filtr) vyberete 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é se mají v tabulce prezentovat:

   1. Výběrem + napravo od sloupců Hodnota 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. Výběrem + napravo od možnosti Seskupit podle (souhrn) 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

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

7. Výběrem možnosti Upravit KQL přejděte do nezpracovaného režimu. 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 vysadí počet událostí podle dne pro ukázkovou datovou sadu.

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

   

2. Graf nezobrazuje žádné výsledky, protože je ve výchozím nastavení vymezený na data z posledních šesti 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. Potom vyberte Použít.

   

   Graf teď zobrazuje data z roku 2007 rozdělená podle dne.

   

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

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í výstrah

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

   

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

   

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

   

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

   

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

Související obsah

• Psaní dotazů pro Azure Data Explorer