Grafana Průvodce Začínáme Nástěnky Komponenty
Začínáme Úvod Grafana je cloudový nástroj pro tvorbu vizuálních nástěnek. Tento nástroj umožňuje napojení různých databázových zdrojů, jako například InfluxDB, ElasticSearch, PostgreSQL atd. Pomocí snadného klikacího rozhraní je možné vytvářet přehledné monitorovací panely, testovací grafy, porovnávar hodnoty nebo analyzovat data pomocí různých matematických funkcí. Přihlášení Grafana v Hexio IoT Platformě je dostupná na https://grafana.hexio.cloud/login.
Obrázek: Přihlašovací stránka Grafany Poznámka: Grafana může mít i veřejnou organizaci, na kterou můžete být přesměrováni bez přihlášení. Kliknutím na ikonu přihlášení, která je zobrazena na obrázku níže na levé straně, se dostanete zpět na stránku pro přihlášení. Tuto ikonu naleznete dole v levém panelu nabídek. Po přihlášení je na stejném místě zobrazena profilová ikona (obrázek níže - vpravo). V případě, že je levý panel nabídek skrytý, klikněte na logo v levém horním rohu. Obrázek: Ikona přihlášení vs Profilová ikona Domovská stránka Po přihlášení, uvidíte naposledy navštívené nástěnky a nástěnky označené hvězdičkou. Po kliknutí na profilovou ikonu se dostanete do sekce profilu (ikona profilu > Preferences).
Obrázek: Domovská stránka Profil V profilové sekci můžete vidět svoje osobní informace. Je zde možné změnit si i heslo. Pozor: Grafana a Hexio IoT Cloud nejsou vzájemně provázané, tedy změněné heslo se projeví vždy jen v konrétním nástroji a nebude snychronizováno. Obrázek: Nastavení profilu Přepínání mezi organizacemi Jestliže jste členem ve více organizacích, vidíte nástěnky pouze z jedné organizace. Pro přepnutí do jiné organizace, klikněte na profilovou ikonu a poté na tlačítko Switch u momentálně vybrané organizace, označené Current Org (obrázek výše). Následně uvidíte přepínací dialog jako na
obrázku níže. Po kliknutí na tlačítko Switch to se provede přepnutí do zvolené organizace. Obrázek: Přepínání organizací Panel nabídek Hlavní panel nabídek obsahuje několik tlačítek. Nezapomeňte, že ne všechna tlačítka jsou dostupná pro všechny role v Grafaně (Admin/Editor/Viewer). Příklad je zobrazen pro roli administrátora. Ikona PLUS se používá na tvorbu nových nástěnek. Ikona se ČTVERCI umožňuje prohlížet a spravovat nástěnky, stejně jako vytvořit playlist a snímek. Ikona "KOLEČKO S KOMPASEM" slouží pro rychle zobrazení dat. Ikona ZVONEK je pro přehled všech upozornění a pro nastavení oznamovacích kanálů. Ikona OZUBENÉHO KOLEČKA je dostupná pouze pro administrátory organizace. Ikona ŠTÍTU je dostupná pouze pro administrátory celé Grafany.
Obrázek: Položky panelu nabídek Veřejná nástěnka V případě, že nejste přihlášeni, uvidíte volně přístupné nástěnky. Pro přihlášení, kliknete na ikonu zobrazenou na 2. obrázku v sekci Začínáme. V případě, že je levý panel nabídek skrytý, klikněte na logo v levém horním rohu. Obrázek: Veřejná domovská stránka
Nástěnky První nástěnka Kliknutím na ikonu PLUS > Dashboard v hlavním panelu vytvoříte novou nástěnku s nabídkou přidání grafických komponent (Query, Visualization a Convert to row - bude popsáno níže). Ikonou diskety vedle ozubeného kolečka nástěnku uložíte. Obrázek: Nová nástěnka Nastavení nástěnky Po kliknutí na ikonu OZUBENÉHO KOLA projektu nahoře v liště, se dostanete do sekce nastavení nástěnky. Zde můžete změnit název nástěnky, přidat popisek atd. Pro možnost zálohování nástěnky je možné nástěnku zobrazit v JSON formátu (záložka View JSON).
Obrázek: Nastavení nástěnky Časový rozsah grafů je možné měnit v pravém horním rohu kliknutím na ikonu hodin. Zoom v grafech provedete pomocí ikony s lupou a grafy je možné aktualizovat ikonou aktualizace, případně je možné vybrat i automatické obnovení po určitém intervalu. Obrázek: Nastavení časového rozsahu Přidání komponenty U nové nástěnky je možné novou komponentu přidat kliknutím na Add Query (doporučeno) nebo Coose Visualization. Další komponenty se přidávají přes tlačítko s ikonou sloupcového grafu s pluskem v horní liště. Každou komponentu je možné přesunout přetažením za horní panel se jménem komponenty, či změnit velikost komponenty tažením za pravý dolní roh. Toto chování je takřka identické ve Windows OS. V případě, že chcete komponenty sdružit do zabalitelné sekce, přidejte novou komponentu a zvolte
Convert to row, všechny komponenty pod tímto řádkem budou automaticky přidány. Zabalení a rozbalení je možné pomocí šipky u daného řádku ( >, V ). Obrázek: Ukázka zabaleného řádku Editace komponenty Editace komponenty je dostupná kliknutím na jméno komponenty v její hlavičce a zvolením Edit. V nabídce komponenty je možné i provést odstranění (Remove), duplikování (More > Duplicate) nebo zobrazení JSON konfigurace (More > Panel JSON).
Obrázek: Editace komponenty Editace je rozdělena do několika bloků Queries (Dotazy) - tvorba dotazů do databáze Visualization (Vizualizace) - výběr a nastavení grafických komponent (graf, budík atd.) General (Obecné nastavení) - obecné nastavení komponenty (jméno, popisek atd.) Další nastavení - tato nastavení jsou dostupná jen u některých kompoentn (graf - Alert) Dotazy (Queries) V této sekci je možné vybrat databázi a sestavit dotaz na data. Dotaz je možné sestavit pomocí klikacího nástroje s inteligentní nápovědou. Více dotazů je možné provést pomocí tlačítka Add Query, zobrazit výsledný dotaz je možné kliknutím na Query Inspector. Na konci všech dotazů je globální nastavení minimálního intervalu - parametr $ interval, dále přenastavení časového rozsahu a časový posun.
Obrázek: Dotazy do databáze Základní struktura dotazu FROM <database> <measurement(your-topics)> WHERE tag=valueselect field(<value(parsed-fields)>) <selectors(agregation-functions)> GROUP BY time(<time-interval>) fill(<value>) FORMAT AS Time series ALIAS BY <your label> Legenda database výběr databáze, ponechte default measurement tag list všech měření (topiků) v databázi další parametry měření (nepovinné) x-sender-id x-source value uživatel který publikoval aktuální zprávu kanál, přes který byla zpráva odeslána v položce field list nalezených hodnot ve daném měření selector po nastavení seskupení ( GROUP BY ), se selector používá k získání agregované hodnoty z daného intervalu time-interval interval seskupení pro agregaci dat ( $ interval je proměnná, která může být globálně nastavena v Options bar > Min. time interval) value v položce fill indikuje, jak budou interpretována chybějící data your label Příklady: vlastní název měření, musí být přítomen v případě použití dvou Y os (levá a pravá)
Získání všech datových bodů napětí z topiku example.1.voltage FROM default example.1.voltage WHERE + SELECT field(voltage_volt) GROUP BY + FORMAT AS Time series ALIAS BY Raw Voltage Získání průměrné hodnoty tlaku z 5 min. intervalů z topiku example.2.pressure FROM default example.2.pressure WHERE + SELECT field(p_bar) mean() GROUP BY time(5m) fill(null) FORMAT AS Time series ALIAS BY Pressure Získání maximální teploty z celého dne z topiku example.3.temperature FROM default example.3.temperature WHERE + SELECT field(t_ C) max() GROUP BY time(1d) fill(null) FORMAT AS Time series ALIAS BY Max temperature per day Získání teploty z topiku example.4.temperature a převedení na stupně Fahrenheit FROM default example.4.temperature WHERE + SELECT field(t_ C) math(*1.8+32.0) GROUP BY + FORMAT AS Time series ALIAS BY Temperature [ F] Získání 1. derivace vibrací ze sekundového intervalu z topiku example.5.vibration
FROM default example.5.vibration WHERE + SELECT field(vibration) mean() derivative(1s) GROUP BY time(1s) fill(null) FORMAT AS Time series ALIAS BY dvibration / 1s dt Více o dotazech do databáze se dozvíte v oficiální dokumentaci k InfluxDB. Vizuální komponenty (Visualization) Po vytvoření dotazu je možné vybrat konkrétní vizuální komponentu. Na výběr je celá řada grafů, budíků, textů i map. Obrázek: Výběr komponent Obecné nastavení (General) V záložka obecného nastavení je možné měnit jméno a popisek komponenty. Případně nastavit vzor pro opakování.
Obrázek: Obecné nastavení
Komponenty Graf Základní Obrázek: Základní nastavení grafu Volba vykreslení (Draw Modes) Zde je možné pozapínat jak má být graf vykreslen. Sloupce (Bars) Čáry (Lines) Body (Points) Možnosti vykreslení (Mode Options)
Na výběr je tloušťka čáry, výplň apod. Možnost Staircase vytvoří schodovté přechody mezy datovými body. Skládání & Prázdná hodnota (Stacking & Null value) Skládání (Stack) - více grafů seskládá na sebe Prázdná hodnota (Null value) - definuje jak se mají zobrazit prázdné hodnoty null - výpadek v grafu connected (spojeno) - výpadek se spojí null as zero (výpadek jako nula) - výpadek se zobrazí jako nula Osy (Axes) Grafy poskytují další nastavení, jako např. nastvení os - rozsah os, jednotka, označení atd. Nastavení je dostupné zvlášť pro každou osu. Obrázek: Nastavení Os grafu Přiřazení metriky k dané ose je možné po kliknutí na barevnou linku vedle popisku měření pod grafem. Linka je na následujícím obrázku zvýrazněna červeným obdélníkem. Zde je možné měnit i barvu konkrétního měření.
Obrázek: Změna barvy a osy Y Legenda Legenda se používá k nastavení popisku jednotlivých měření. Obrázek: Nastavení Legenda grafů Upozornění (Alert) Grafana poskytuje i základní systém pro upozorňování.
Obrázek: Nastavení upozornění Po nastavení upozornění, můžete nastavit kanály a zprávy v sekci oznámení (Notifications). Kanály, ale musí být předem nastaveny v hlavním panelu nabídek - tlačitko Alerting > Notification channels. Mezi podporované kanály patří: email slack webhook Obrázek: Nastavení oznámení Měřidlo (Gauge) Základní
Obrázek: Nastavení Možností měřidla Zobrazení (Display) Typ zobrazení (Show) Calculation - zobrazení vypočtené agregované hodnoty z vrácených hodnot z databáze All values - zobrazení všech hodnot vrácených z databáze Labels Zapne v měřidle číselné prahové hodnoty. Markers Zapne v měřidle barevné značky. Prvek (Field) Toto nastavení umožňuje sekundárně pojmenovat měřidlo (Title), určit jednotku (Unit), nastavit minimální a maximální rozsah hodnot a nastavit počet desetinných míst. Prvek Title obsahuje několik "wild-cards": $ series_name $ field_name $ calc - vloží jméno měření - vloží jméno hodnoty - typ výpočtu Prahové hodnoty (Tresholds) Prahové hodnoty vytvářejí barevně oddělené sekce pro čitelnější rozpoznání hodnoty. Hodnota Base je brána z Field > Min Mapování hodnoty (Value mapping) Mapování hodnoty je velice užitečný nástroj pro definice vlastních textových hodnot. Například
hodnota 0 může znamenat ZAVŘENO a 1 OTEVŘENO. Na obrázku níže je výchozí mapování nenalezená data (null) jsou zobrazena jako N/A text. Obrázek: Mapování hodnot měřidla