Nastavení detekce v aktivátoru

Tento článek popisuje rozsah nastavení detekce, která jsou k dispozici při vytváření pravidla. Dozvíte se, jak nastavení detekce funguje ve Fabric Activator a jak je efektivně nakonfigurovat. Různá nastavení detekce spolupracují na určení přesných dat, která chcete sledovat.

Příklady v tomto článku používají ukázkový eventstream událostí doručení balíčku . Konkrétně odkazuje na atribut Temperature a pravidlo Příliš horké pro medicínu vytvořené v tomto kurzu.

Možnosti nastavení detekce

Nastavení detekce nakonfigurujete v podokně Definice , které se zobrazí na pravé straně aktivátoru. Podokno se otevře, když vyberete pravidlo v podokně Průzkumník na levé straně. Nastavení detekce ve filtru Souhrn, Podmínka a Vlastnost spolupracují a definují přesně to, které datové události aktivují pravidlo. Každé nastavení je popsáno v následujících částech.

Následující obrázek znázorňuje podokno Definice s nastavením detekce atributu Teplota pravidla Příliš horké na léky.

Snímek obrazovky s podoknem Definice v Aktivátoru zobrazující nastavení detekce atributu Teplota pro pravidlo Příliš horké pro lék

Summarization

Souhrn převede stream nezpracovaných událostí na jednu vypočítanou hodnotu v průběhu klouzavého časového okna. Skládá se z typu agregace (Operace), velikosti okna a velikosti kroku. Souhrny jsou užitečné, když pravidlo by mělo reagovat na trend nebo vzor v průběhu času, a ne na jednotlivé události.

Velikost okna definuje, jak daleko zpět v čase sahá každý výpočet. Například velikost okna 1 hodinu znamená, že každá souhrnná hodnota se počítá z událostí v poslední hodině. Velikost kroku určuje, jak často okno postupuje a jak se vypočítá nová souhrnná hodnota. Například velikost kroku 15 minut znamená, že se každých 15 minut vytvoří nová agregovaná hodnota. Obě hodnoty mohou být v rozsahu od 10 sekund do 24 hodin.

Následující tabulka popisuje dostupné typy agregace.

Aggregation Popis
Average Vypočítá průměrnou hodnotu vlastnosti nebo sloupce v časovém intervalu.
Minimální Vypočítá minimální hodnotu vlastnosti nebo sloupce v časovém intervalu.
Maximální Vypočítá maximální hodnotu vlastnosti nebo sloupce v časovém intervalu.
Sum Vypočítá součet hodnot vlastnosti nebo sloupce v časovém intervalu.
Celkem Vypočítá počet událostí obsahujících vlastnost nebo sloupec v časovém intervalu. Na rozdíl od funkce Sum, která sečte hodnoty vlastnosti, spočítá celkový počet událostí.

Podmínky

Podmínka definuje vzor, který musí activateor rozpoznat v datech k aktivaci pravidla. Podmínky jsou seskupené podle datového typu a každá skupina obsahuje typy podmínek, které popisují různé druhy změn nebo stavu.

Následující obrázek a tabulka popisují kategorie podmínek dostupné v rozevíracím seznamu.

Snímek obrazovky oddílu Podmínka v podokně Definice s rozbaleným rozevíracím seznamem Podmínka s osmi sbalenými kategoriemi: Číselná změna, Číselný stav, Změna textu, Stav textu, Logická změna, Logický stav, Společná změna a Prezenční signál

Kategorie Popis
Číselná změna Podmínky, které se aktivují, když se číselná hodnota změní vzhledem k prahové hodnotě, například zvýšení nad nebo snížení níže. Pomocí těchto podmínek můžete zjistit směrové trendy v číselných datech.
Číselný stav Podmínky, které se aktivují, když je číselná hodnota v určitém stavu, například Je větší než, Je menší než nebo Je mezi. Pravidlo se aktivuje pro každou událost, kde je podmínka pravdivá.
Změna textu Podmínky, které se aktivují, když se textová hodnota změní na konkrétní hodnotu nebo z ní, například změny na nebo změny z.
Stav textu Podmínky, které se aktivují, když textová hodnota odpovídá vzoru, například Obsahuje, Začíná nebo Končí.
Logická změna Podmínky, které se aktivují, když se změní stav booleovské hodnoty. Aktivuje se , když se hodnota změní z hodnoty false na true. Stane se false aktivuje, když se hodnota změní z true na false.
Logický stav Podmínky, které se aktivují pro každou událost, kde logická hodnota odpovídá zadanému stavu. Rovná se a nerovná se porovnávají hodnotu proti true nebo false.
Běžná změna Aktivuje se, když se změní hodnota atributu. Podmínka Changes platí pro datové typy a nemá žádnou konkrétní prahovou hodnotu nebo cílovou hodnotu.
Srdeční tep Podmínky na základě příchodu události. Nepřítomnost dat se aktivuje, když během stanoveného času nedorazí žádné nové události. První vzhled objektu aktivuje při prvním zobrazení id daného objektu v eventstreamu.

U všech podmínek, které mají pole Hodnota , může být hodnota literál, který zadáte, nebo odkaz na jiný atribut nebo vlastnost na stejná data. Pokud chcete odkazovat na jiný atribut, vyberte tlačítko značky napravo od pole Hodnota nebo zadejte @a pak vyberte atribut nebo vlastnost ze seznamu. V seznamu se zobrazí jenom položky odpovídajícího typu. Odkaz použijte místo literálu, když hodnota, se kterou porovnáváte, není pevná – například když má každý balíček vlastní maximální povolenou teplotu.

Snímek obrazovky podokna Definice pravidla, které monitoruje vlhkost, se zvýrazněnou sekcí „Podmínka“. Pole „Hodnota“ v podmínce „Rovná se“ zobrazuje atribut „Vlhkost“ vybraný jako prahovou hodnotu, přičemž na pravé straně pole je tlačítko štítku, které otevře nástroj pro výběr atributu.

Výskyt

U některých typů podmínek se zobrazí pole Výskyt , které určuje, jak dlouho nebo kolikrát musí být podmínka pravdivá, než se pravidlo aktivuje. Pokud například chcete být upozorněni pouze v případě, že teplota zůstane nad 100 stupňů po dobu alespoň 10 minut, nastavte podmínku na Větší než 100 a nastavte výskyt na Když byla platná po 10 minut. Následující tabulka popisuje dostupné možnosti výskytu.

Výskyt Popis
Pokaždé, když je splněna podmínka Pravidlo se aktivuje pokaždé, když je podmínka pravdivá.
Kdy byla pravdivá nkrát Pravidlo se aktivuje až po splnění zadaného počtu podmínek.
Kdy to platilo pro Pravidlo se aktivuje jenom v případě, že podmínka zůstane po zadanou dobu nepřetržitě pravdivá.

Filtr vlastností

Oddíl Filtr vlastností vytvoří podmínku pro podmnožinu dat, která omezuje události, které pravidlo vyhodnotí. Aktivátor podporuje filtry vlastností u libovolného typu atributu – číselného, textového nebo logického.

Každý filtr určuje atribut, operaci a hodnotu. Do podmínky pravidla se předají jenom události, které vyhovují filtru. Všechny ostatní události jsou vyloučené.

Snímek obrazovky části Filtr vlastností v podokně Definice, který zobrazuje filtr 1 nakonfigurovaný s atributem nastaveným na Teplota (°C), operací nastavenou na Je větší než a hodnotou nastavenou na 0.

Například obrázek znázorňuje filtr atributu Temperature (°C), kde operaceje větší než a hodnota je 0. Tento filtr vyloučí všechny události, ve kterých je teplota nulová nebo nižší. Dalším příkladem je textový filtr, ve kterém je atribut nastaven na City, operace je rovna a hodnota je Redmond – což omezuje vyhodnocování pravidel na události, kde jsou balíčky v Redmondu.

Na jedno pravidlo můžete použít až tři filtry. Když použijete více filtrů, událost musí splňovat všechny filtry, aby se událost vyhodnocovala. Filtry se kombinují s logikou AND.

Upřesňující nastavení

Část Upřesnit nastavení podokna Definice obsahuje nastavení časování, která mají vliv na přesnost vyhodnocení pravidla, nikoli logiku detekce. Nastavení čekání na pozdní příchozí události určuje, jak dlouho má Aktivátor otevřené vyhodnocovací okno, aby mohly dorazit zpožděné události. Další informace najdete v tématu Latence v aktivátoru.