Skip to main content
ALTWORX Dokumentace
Přepnout tmavý/světlý/automatický režim Přepnout tmavý/světlý/automatický režim Přepnout tmavý/světlý/automatický režim Zpět na domovskou stránku
  1. ALTWORX Dokumentace
  2. /
  3. Uživatelská dokumentace
  4. /
  5. Uživatelské rozhraní
  6. /
  7. QUERY - Dotazy
  8. /
  9. Nastavení widgetů

Nastavení widgetů

General settings

V sekci obecné nastavení se uvádí základní informace o widgetu (název, velikost, aktualizace dat, atd.).

Obsahuje konkrétně tato pole:

  • TITLE - pole slouží pro zadání názvu widgetu, který vytváříte nebo upravujete.

  • WIDTH - pole pro zadání šířky widgetu, do pole můžete vepsat číslo nebo využít šipky nahoru a dolů, které se objeví vpravo při najetí myší na pole; šipkami můžete nastavit šířku widgetu v hodnotách od 1 do 4.

  • HEIGHT - pole pro nastavení výšky widgetu, i zde se při najetí myší na pole objeví šipky nahoru a dolů, kterými můžete nastavit výšku widgetu v hodnotách od 1 do 3; hodnotu je možné také do pole vepsat.

  • REFRESH RATE (SECONDS) - pole umožňující zadat počet sekund, po jejichž uplynutí se mají ve widgetu aktualizovat údaje, maximum je 3600 s, tedy 1 hodina.

LIST

V sekci LIST se nastavuje vše, co souvisí se seznamem aktiv ve widgetu - řazení (sort), vyhledávání (search) i štítky (badge).

Nastavení obsahuje tato zaškrtávací políčka:

  • DUPLICATES - zapne či vypne zobrazení duplikátních aktiv. V případě, kdy se dotazem ptáte na nějakou vlastnost aktiv určitého typu v konkrétním období, může odpověď zahrnovat každé aktivum v typu jednou, ale také vícekrát.

Pro ilustraci: Zajímají vás aktiva typu serverovny. Ptát se můžete třeba na teplotu jednotlivých serveroven v časovém rozmezí od pondělí 3. 4. do pátku 7. 4. Výsledek může vypsat aktivum serverovna1 s teplotou 24˚C v pondělí 3. 4. Toto aktivum však může být v případě, že se hodnota sledovaného atributu změní, ve výsledku dotazu vypsáno opakovaně, např. pro úterý 4. 4., kdy teplota klesla na 22˚C, i pro čtvrtek 6. 4., kdy teplota vzrostla na 23˚C.

Při zaškrtnutí políčka DUPLICATES se započítávají do seznamu stejná aktiva vícekrát, avšak s odlišnými hodnoty vyžádaného atributu. Je to výhodné v případě, že chcete sledovat, jak se u vybrané vlastnosti aktiva vyvíjejí její hodnoty, a zaznamenávat tyto změny (serverovna1 (teplota): 3. 4.: 24˚C, 4. 4.: 22˚C, 6. 4.: 23˚C).

V případě, že vám jde o výpis hodnot pro různá aktiva v konkrétním období a porovnání hodnot mezi nimi v tu chvíli, pak vám postačí pro každý server jedna hodnota a není nutné zaškrtávat políčko DUPLICATES. Zde je příhodnější mít zahrnuto každé aktivum pouze jednou (dne 3. 4.: serverovna1: 24˚C, serverovna2: 25˚C, serverovna3: 22˚C).

  • SEARCH - toto políčko zapíná a vypíná pole pro vyhledávání událostí, které widget zpracovává.

Se seznamem přímo souvisí možnost řazení jeho položek podle vybraných kritérií a přidávání štítků k jednotlivým položkám.

Sekce SORT

Prostřednictvím této sekce můžete spravovat řazení aktiv ve widgetu. Jako výchozí řazení je přednastaveno řazení podle nadcházejících možných změn, způsob Upcoming. Zvolit si však můžete i jiné možnosti, v tomto případě např. Created nebo Severity. Zvolený způsob řazení je tmavěji zbarvený než ostatní možnosti. Kromě výběru řazení můžete kliknutím na šipku vpravo volit, jakým způsobem se hodnoty seřadí, sestupně či vzestupně.

U řazení Upcoming se po výběru šipky dolů seřadí položky seznamu od těch aktiv, jejichž stav by se mohl změnit v co nejbližší době a pokračuje těmi, u nichž je očekávaná změna v pozdějším čase. Při kliknutí na šipku směrem vzhůru se aktiva seřadí od těch s nejpozději očekávanou změnou po ty, u nichž změnu očekáváme nejdříve.

Volba možnosti Created a výběr šipky dolů seřadí aktiva od těch nejdříve vytvořených po ty nejpozději vytvořené (od nejstarších po nejmladší). U šipky směrem vzhůru je tomu naopak. Nejnovější aktiva vidíte jako první.

Řazení Severity uspořádá při kliknutí na šipku dolů aktiva od těch s nejmenší závažností (žlutá barva) po ty s největší závažností (červená barva), po kliknutí na šipku nahoru se řazení mění od těch nejzávažnějších případů po ty nejméně závažné.

V nastavení widgetů můžete v sekci SORT vidět nejprve seznam již definovaných způsobů řazení aktiv. U každé položky v seznamu jsou dvě tlačítka:

  • Edit - pro upravení stávající definice,
  • Delete - pro smazání dosavadní definice.

Pod seznamem uložených definic najdete tlačítko Add sort definition pro vložení vlastního způsobu řazení.

Přidání nové definice řazení

  1. spouští se tlačítkem Add sort definition,
  2. vyplníte pole TITLE - název nového způsobu řazení,
  3. v poli ATTRIBUTE pod roletkou vpravo vyberete vlastnost, podle které chcete události řadit,
  4. novou definici potvrdíte tlačítkem Done vpravo nahoře.

Pole DEFAULT SORT slouží k nastavení výchozího řazení. Pod roletkou vpravo vybíráte z přednastavených definic.

Zaškrtávací políčko Reverse obrátí pořadí položek ve vybraném řazení.

Sekce BADGES

Tato sekce slouží pro vytváření definic různých štítků u jednotlivých položek. I v této sekci jsou nejprve umístěny již uložené definice, pokud tedy nějaké definované dříve byly. U každé z těchto uložených definic jsou tlačítka Edit pro úpravu definice a Delete pro její smazání. Pod nimi je tlačítko Add badge definition pro přidání nové defince štítku.

Přidání nové definice štítku

  1. Možnost definovat nový štítek spustíte tlačítkem Add badge definition.

  2. Následně vyplňte pole COLOR AND TITLE, zvolte si barvu, kterou bude štítek mít, pokud mu nenastavíte threshold, a název štítku.

  3. V poliATTRIBUTEvyberte vlastnost aktiva, která se ve štítku zobrazí.

  4. Pro štítek můžete nastavit THRESHOLD, to znamená hranici, která pokud bude splněna, štítek se zbarví zelenou barvou, bude-li však hodnota pod stanovenou hranicí, bude štítek červený.

  5. Barvy v THRESHOLDU můžete v souladu s kontextem prohodit zaškrtnutím políčka Inverted, tzn. pokud je hraniční hodnota naplněna nebo překročena, štítek bude červený, pokud není dosažena, štítek bude zelený.

  6. Definici každého štítku je možné konvertovat do formátu JSON pomocí tlačítka Convert to JSON. Poté už zůstane definice v tomto formátu, nejde jí vrátit zpět do formuláře pro editaci. Změny však lze provádět i ve formátu JSON, přepisovat název, barvy, vzorce apod.

  7. Aby se změna v zadání definice štítku projevila, je potřeba ji potvrdit tlačítkem Done vpravo nahoře.

CHART

Zaškrtnutí políčka u sekce CHART přidá do widgetu graf, který zobrazuje výsledek dotazu. Graf můžete v této sekci nastavit podle vlastních preferencí.

Nastavení je členěno do částí TIME DIMENSION a METRICS.

Sekce TIME DIMENSION

V této sekci si zvolíte atribut, který bude představovat časovou osu. Ve výchozím stavu je toto pole prázdné, graf vykresluje časovou osu vytvoření aktiva. Pod roletkou vpravo však můžete vybrat jiný atribut, ve kterém je uložený čas, např. sys_period.lower, sys_period.upper.

  • FILL TIME DIMENSION - toto políčko je ve výchozím stavu zaškrtnuto, doplňuje chybějící časy s nulovou hodnotou.

Pro ilustraci, pokud vám dotaz vrátí následující výsledky:

2023-01-01 - 1
2023-01-05 - 1
2023-01-06 - 1

vidíte, že intervaly mezi 1. a 2. časem (1. 1. - 5. 1.) a mezi 2. a 3. časem (5. 1. - 6. 1.) jsou odlišné. Aktivujeme-li políčko Fill time dimension, doplní se první interval o chybějící dny s nulovými hodnotami (2. 1., 3. 1., 4. 1.):

2023-01-02 - 0
2023-01-03 - 0
2023-01-04 - 0

Rozdíl ilustrovaný na grafech

Na prvním grafu je políčko Fill time dimension zaškrtnuto (jsou doplněny nulové hodnoty):

Na druhém grafu je odškrtnuto:

  • SCALE METRICS - zaškrtnutím tohoto políčka vypnete jednotné měřítko metriky, tzn. že pokud máte více metrik, mezi jejichž hodnotami je zásadní rozdíl (jedny nabývají velmi malých hodnot a druhé velmi velkých), je možné nastavit odlišná měřítka pro jednotlivé metriky.

U prvního snímku je políčko Scale metric zaškrtnuto - jednotné měřítko pro metriky je tedy vypnuto a můžete tak porovnat nárůst a pokles hodnot vzhledem k jejich vlastním hodnotám.

U druhého snímku je políčko odškrtnuto, měřítko pro obě metriky je tedy jednotné. Zde na první pohled vidíte velký rozdíl mezi hodnotami obou metrik.

  • TIME DIMENSION LABELS - políčko, jež má na starosti zobrazení časových štítků na ose X,
  • BRUSH - zaškrtnutím tohoto políčka se zobrazí osa kopírující graf ve zmenšené podobě, díky ní je možné vymezit hranice zobrazeného období v grafu.

Sekce METRICS

V této sekci je opět na prvním místě seznam již vytvořených definic metrik, pokud jsou přednastaveny. Každou ze stávajících definic můžete upravovat pomocí tlačítka EDIT nebo mazat pomocí tlačítka DELETE. Díky níže položenému tlačítku Add metric definition můžete přidat definici pro novou metriku.

Přidání nové definice metriky

  1. Zadávání nové definice spustíte tlačítkem Add metric definition.

  2. Vyplníte pole COLOR AND TITLE, kam zadáte název vaší nové metriky a vyberete si pro ni barvu odlišnou od jiných metrik.

  3. Dále v poli TYPE rozhodnete, zda se bude zobrazovat plošný, lineární nebo sloupcový graf (area / line / bar).

  4. V poli INPUTvyberete pod roletkou vpravo atribut, vlastnost, jejíž hodnoty bude graf vykreslovat.

  5. V poli AGGREGATION zvolíte, jaký způsob agregování hodnot v metrice chcete (avg / min /max /sum /enum).

    Pro ilustraci: Je nutné vytvořit metriku Severity zaznamenávající severitu aktiv ve vymezeném období (8:00 - 10:00) s granularitou 1 hodiny. V každém časovém úseku se mohou vyskytovat aktiva s různou severitou: nízkou (žlutá barva), střední (oranžová barva), vysokou (červená barva).

    • 8:00: žlutá (5), oranžová (3), červená (1),
    • 9:00: žlutá (8), oranžová (2), červená (2),
    • 10:00: žlutá (7), oranžová (1), červená (3).

    Rozdílné zobrazení u jednotlivých typů agragace:

    • Při agregaci typu enum se zobrazí metriky (spojité čáry) jako výčet pro jednotlivé hodiny uvedený výše: žlutá čára bude spojovat hodnoty 5, 8 a 7, oranžová 3, 2 a 1, červená 1, 2 a 3.
    • Při typu avg se zobrazí pro všechny severity v grafu jedna čára, která bude spojovat v každém čase průměrné hodnoty severit, 8:00: 5+3+1/3 = 3, 9:00: 8+2+2/3 = 4, 10:00: 1+2+3/3 = 2.
    • Při typu min čára spojí nejnižší hodnoty severit, 8:00: 1, 9:00: 2, 10:00: 1.
    • Při typu max čára spojí nejvyšší hodnoty severit, 8:00: 5, 9:00: 8, 10:00: 7.
    • Při typu sum se sečtou všechny hodnoty a čára bude spojovat součty hodnot v určitém čase: 8:00: 9, 9:00: 12, 10:00: 12.

  6. Pole EXPRESSION opět může sloužit pro zadání matematického výrazu, který ovlivní vykreslení grafu.

    Jako Expression můžete použít následující výraz: (%s / 60 / 60 / 24), kde se na místo %s doplní vstupní hodnota. Tento ilustrační příklad upraví velké číslo vyjadřující čas v sekundách nejprve na minuty, pak na hodiny a pak na dny.

  7. Pole PRINT slouží k formátování výsledku, můžete ho například obalit textem (%s km, zbývá %s dní, atd.). %s zastupuje výslednou hodnotu, samotné písmeno určuje, jakým způsobem se má hodnota naformátovat (v případě písmene s se jedná o textový řetězec), další možnosti jsou např. formát %d, kdy d naformátuje hodnotu jako číslo v desítkové soustavě, nebo formát %f, kdy f naformátuje hodnotu jako číslo s pohyblivou řádovou tečkou.

    Tento formát se obecně nazývá printf, více o něm se můžete dočíst zde.

  8. Zaškrtnutím pole Connect null values se v metrice spojí i prázdné hodnoty (tzn. obsahující null).

  9. Políčko Convert to JSON opět slouží pro možnost uchovávat a měnit definici ve formátu JSON, jako tomu je i u definování štítku (badge) výše.

  10. Upravenou definici vždy uložte pomocí tlačítka Done vpravo nahoře.

GRAPH

Zaškrtnutím této možnosti zobrazíte část sítě reality - vybrané aktivum a jeho okolí.

DETAILS

Při zaškrtnutí této sekce se bude po kliknutí na položku v seznamu LIST otevírat pravý panel s podrobnými informacemi o vybraném aktivu. V nastavení widgetu můžete nastavit, co chcete, aby se ve widgetu při kliknutí na položku zobrazovalo:

Pravý panel ve widgetu je podobný jako pravý panel u aktiva v síti reality pod záložkou NETWORK.

  • DETAILS - zobrazí vlastnosti vybraného aktiva a hodnoty u jednotlivých atributů,

  • ACTIONS - zobrazí akční tlačítka, například možnost zvalidovat neočekávanou událost nebo ji uzavřít,

  • SOLUTION - zobrazí možná řešení v nejbližší budoucnosti (vidlička),

  • CONTEXT - zobrazí aktiva související s vybraným aktivem, pokud jsou zadaná,

  • METRIC - zobrazi graf definovaný u daného aktiva, data čerpá ze samotného aktiva, nemá spojitost s grafem ve widgetu,

  • EVENTS - zobrazí události spojené s vybraným aktivem.

SUM

Tato sekce souvisí s widgety ukazující celkový počet vybraných aktiv, například typu Sum nebo Count. Je potřeba ji zaškrtnout, aby se vám bublina s celkovou sumou ve widgetu zobrazovala, jinak vás může widget zmást svým prázdným obsahem.

  • TYPE ARCS - zaškrtnutím tohoto políčka se zobrazí oblouky kolem aktiva, které barevně odpovídají typům aktiv zahrnutých v sumě (celkovém počtu).

THRESHOLD

Threshold je v tomto případě opět hraniční mez pro barevnost widgetu. Ta pak na první pohled dává najevo, zda je celkový počet aktiv definovaných dotazem ve stavu, který je pro vás žádoucí nebo naopak. Záleží na tom, zda stanovenou hodnotu je ideální překročit, pak si nastavíte pro vyšší hodnoty např. uklidňující zelenou barvu, nebo by hodnota naopak překročena být neměla a raději si nastavíte červenou barvu asociující varování. Mezní hodnota je na názorném příkladu nastavena na 41. Pokud je pro vás překročení nežádoucí, počet aktiv nad 41 zabarví widget červeně.

Pokud je pro vás žádoucí, aby hodnota 41 byla překročena, pak můžete barvy obrátit zaškrtnutím políčka Invert threshold.

gdoc_arrow_left_alt Funkce záložky QUERY AQL Manuál gdoc_arrow_right_alt