Změna konfigurace akceptorů

Editace akceptorů

Akceptory, které byly nově vytvořeny, jsou prázdné. Proto je potřeba je nakonfigurovat. U těch akceptorů, které už konfiguraci nastavenou mají, se může stát, že vám jejich původní konfigurace nebude vyhovovat a budete ji chtít změnit.

Slouží k tomu tlačítko Change configuration, které můžete najít pod položkou hlavního menu ACCEPTORS hned v přehledu akceptorů.

Najdete ho také na detailu konkrétního akceptoru, pokud na něj v přehledu kliknete.

Jakmile změníte konfiguraci a uložíte ji tlačítkem Save Configuration. Zobrazí se vám dialog, kam můžete napsat popis změny. Je k tomu určeno první pole. Níže pod znaménkem plus uvidíte provedené změny. Zde je můžete zpětně dohledat.

Jakmile odsouhlasíte tento dialog, uvidíte potvrzení Configuration changed successfully.

Změna konfigurace jednotlivých akceptorů

Nastavení různých druhů akceptorů se od sebe může lišit. Některým akceptorům nakonfigurujete činnosti, které mají provádět, tzv. Joby. Jiným definujete soubory, nad kterými budou pracovat.

Stejně jako může být více souborů, může být i více Jobů pod jedním akceptorem. Každý z Jobů pracuje nezávisle na ostatních.

Společné nastavení pro všechny Joby, nastavujete v obecném nastaveni akceptoru, pod záložkou Global.

DB akceptor

Jedná se o databázový akceptor, prostřednictvím kterého se připojujeme k databázím.

Pokud otevřete konfiguraci tohoto akceptoru, uvidíte dvě záložky:

Global
Jobs

Global

Pod záložkou Global se nastavuje připojení k Altworx, konkrétně k úložišti Kafka. Předvyplněny jsou výchozí hodnoty, které je ale třeba změnit, pokud jde o atypické nasazení. U standardního nasazení není potřeba připojení měnit.

Pod nastavením Kafky najdete posuvník Send errors, kterým zapnete posílání chybových stavů jako zpráv přímo do Raw topiců. Pokud je toto nastavení vypnuté, objeví se informace o chybách pouze v logu akceptoru. Tímto nastavením umožníte, aby scénáře reagovaly na chyby připojení a na příklad na ně upozornily i uživatele.

Jobs

Pod záložkou Jobs nastavujete jednotlivé činnosti, které by měl akceptor vykonávat.

Ve formuláři vidíte následující pole:

ID - zadejte identifikační název, který bude sloužit jako interní identifikace jobu, bude součástí zprávy,
Enabled - zde posuvníkem povolujete spuštění jobu,
Schedule - sem zadáváte, jak často se má spouštět v syntaxi Cron expression https://en.wikipedia.org/wiki/Cron#Cron_expression,
Timezone - v tomto poli nastavíte časovou pásmo, v kterém bude vyhodnocován Schedule, pokud časovou pásmo nezadáte, zaznamenává se čas automaticky v pásmu UTC,
Type - v tomto poli definujete typ databáze, pod roletkou vybíráte mezi možnostmi Postgres nebo Oracle,
Hostname - do tohoto pole zadáváte hostname databáze, ke které se má akceptor připojit a na které má spouštět dané SQL,
Database - zde zadáte název databáze,
User - sem patří vaše uživatelské jméno pro přihlašování se do databáze,
Password - zde uveďte vaše heslo, které zadáváte společně s uživatelským jménem při přihlašování se do databáze,
Query - SQL dotaz, který se s jobem spouští, definuje, co konkrétní job řeší,
Primary key - primární klíč, pomocí kterého se identifikují řádky, které se změnily, toto nastavení je relevantní jen pokud nastavíte Send results na Updates,
Kafka topic - sem zadáváte název RAW topicu v Kafce, do kterého akceptor zprávu pošle,
Message type - uvádí, v jaké formě se má výsledek porovnání poslat do Raw topicu, pod roletkou máte výběr ze dvou možností:
- Single row - pro každý řádek ve výsledku vygeneruje samostatná zpráva,
- All rows - pošle se pouze jedna zpráva, která obsahuje všechny řádky výsledku,
Send results - zde jak se z výsledku dotazu sestaví výsledek exekuce jobu. Opět máte na výběr ze dvou možností:
- Always - výsledkem jobu jsou všechny řádky z výsledku dotazu.
- Updates - porovnává výsledek dotazu s předchozím spuštěním a hledá, co se ve výsledku změnilo. Výsledkem jobu jsou pak jen tyto změny. Standardně se detekují nové a smazané řádky, pokud chcete detekovat i změnu řádku, musíte specifikovat primární klíč v Primary key.
Include columns - zde posuvníkem zaškrtáváte, zda chcete mít ve zprávě vloženy sloupce v pořadí, v jakém se objevily ve výsledku.

Červeně označená pole je nutné pro spuštění Jobu vyplnit.

Stávající joby lze měnit, zaměňovat jejic pořadí, je možné k nim přidat nový job, nebo jednotlivé Joby smazat.

HTTP Poller akceptor

Tento akceptor vytváří dotazy na HTTP server jako na zdroj dat.

Opět obsahuje dvě záložky:

Global
Jobs

Global

V tomto případě už není možné měnit globální nastavení později v rámci jednotlivých Jobů.

Jobs

V záložce Jobs vyplňujete fomulář s těmito poli:

ID - zadejte název, který bude sloužit jako interní identifikace jobu,
Enabled - zde posuvníkem povolujete spuštění jobu,
Schedule - sem zadáváte, jak často se má spouštět v syntaxi Cron expression https://en.wikipedia.org/wiki/Cron#Cron_expression,
URL to monitor - sem zadáváte URL adresu, kterou má Job monitorovat,
Kafka topic - zde zadáváte název RAW topicu, do kterého akceptor zprávu pošle,
Reject unauthorized - posuvníkem lze aktivovat kontrolu validity certifikátů.

Povinnými poli v tomto případě jsou URL to monitor a Kafka topic. Při nevyplnění těchto polí uvidíte nahoře ve formuláři upozornění.

RSYSLOG akceptor

Tento akceptor přijímá informace na portu specifikovaném v konfiguraci. Zprávy, které jsou na tento port protokolem Syslog poslány jsou pak přijaty a uloženy do specifikovaného topicu.

WC (Wall Clock) akceptor

Tento akceptor pracuje nad konkrétními soubory.

Zahrnuje dvě sekce:

Global
File Types

Global

V záložce Global nastavujete připojení ke Kafce a defaultní topic. Topicy pak můžeme nastavovat ještě u jednotlivých typů souborů zvlášť.

File Types

V sekci File Types už definujete práci akceptoru s jednotlivými soubory.

Zadáváte zde:

Type - jedná se o typ souboru, tento typ určuje název souboru, který akceptor monitoruje,
Mode - zde zadáváte způsob, jakým budou výsledné zprávy formátovány, lze zvolit ze dvou možností:
- Per File - znamená, že z celého souboru je vyrobena jedna zpráva,
- Per Line - zpráva je vygenerována zvlášť pro každý řádek,
- Syntax - v tomto případě se jedná o speciální mod, který se řídí podle toho, jakou má soubor příponu,
Topic - zde zadáváte topic, do kterého bude výsledná zpráva poslána.

REALITY NETWORK akceptor

Posledním typem akceptoru, kde můžete měnit konfiguraci je Reality Network akceptor. Tento akceptor je současně editorem pro Síť reality. Jelikož je editace rozsáhlejší oblastí, věnovali jsme jí samostatnou kapitolu.