Logy z 3rd-party programov (externé programy)

Základom tejto metódy je overenie funkčnosti programu prostredníctvom výstupného súboru, ktorý zaznamenáva priebeh vykonávania programu. Doručený e-mail obsahujúci log súbor je spracovaný na CM serveri, kde sa jeho obsah analyzuje. Na základe vopred definovaných kritérií sa následne vyhodnotí, či bola požadovaná operácia vykonaná úspešne alebo došlo k chybe.

Spôsoby prevzatia logov z programov tretích strán

Logy určené na vyhodnotenie môžu byť do CM Servera doručené dvoma základnými spôsobmi:

  • Priame odoslanie logu aplikáciou
    Aplikácia disponuje vlastnou funkcionalitou na odosielanie e-mailov a je schopná samostatne odoslať log súbor priamo do CM Servera.
  • Prevzatie logu C-Monitor klientom
    Aplikácia ukladá log súbor na lokálny disk. C-Monitor klient dokáže prevziať jeho prírastok a následne odoslať na CM Server.

Nastavenia na CM Portáli

Definícia - parametre externých programov

Prejdite do časti CM IT Monitoring -> External Programs -> External programs parameters.

Táto časť slúži na definovanie spôsobu spracovania prijatého logu. CM Server musí byť schopný jednoznačne identifikovať typ prijatého logu, teda určiť, z ktorého programu pochádza. Na základe tejto identifikácie je následne log vyhodnocovaný podľa priradených kritérií úspešnosti alebo neúspešnosti.

Ak je rovnaký externý program nasadený na viacerých počítačoch a spôsob vyhodnocovania jeho logov je identický, definícia typu externého programu sa vytvára iba raz. Táto definícia sa potom opakovane používa v rozvrhoch externých programov na spracovanie logov z viacerých počítačov.

Obrázok: Nastavenie parametrov pre vyhodnocovanie externého programu

Rozvrhy externých programov - priradenie log súboru k počítaču v CM

Prejdite do časti CM IT Monitoring -> External Programs -> External programs parameters.

Základným organizačným prvkom v CM je počítač s priradeným CM-ID. Každý typ poruchy sa viaže k nejakému počítaču. Táto logika sa zachováva aj pri spracovaní logov externých programov. Z toho vyplýva, že ak by ste dali log zasielať z počítača, ktorý nie je v CM, je potrebné vyhodnocovanie naviazať na niektorý existujúci počítač s prideleným CM-ID.

Dôvod prečo sa táto časť priradenia volá Rozvrhy externých programov, je že log sa musí posielať pravidelne. Log je očakávaný do určitého intervalu, definovanom v rozvrhu. Ak log v tomto intervale nepríde, je možné povedať, že došlo k chybe, ktorú treba riešiť.

Vytvorenie rozvrhu k externému programu začína výberom počítača, na ktorý bude naviazané vyhodnocovanie. V prípade, že sa logy posielajú pomocou C-Monitor klienta, musíte zvoliť počítač, ktorý logy odosiela, lebo inak nebudú vyhodnotené.

Vysvetlenie k vybraným položkám dialógu:

  1. Meno úlohy – názov úlohy, ktorý môže presne popisovať kontrolovanú činnosť alebo proces. Nemusí ísť o všeobecný názov.
  2. Popis úlohy – pole má čisto informatívny charakter pre CM Technika.
  3. Typ externého programu – výber typu externého programu, ktorý ste si definovali v predchádzajúcom kroku.
  4. Porucha bude poslaná – možnosť obmedziť príjemcov emailových notifikácií o poruche.
  5. Čas spúšťania, Perióda, Interval doručenia správy … – určuje čas spustenia programu a interval, v ktorom sa očakáva prijatie logu. Pokiaľ bude vyhodnocovanie porúch v dňových intervaloch, na presnej hodine veľmi nezáleží. Upozorňujeme, že čas spúšťania musí byť manuálne nastavený aj na strane počítača a musí byť zhodný s nastavením na CM Serveri.
  6. Filter emailových správ – slúži pre odlíšenie už konkrétneho programu, ktorý sledujete (napr. ak by ste mali nastavené vyhodnocovanie viacerých z jedného PC). V prípade, že ide o log posielaný z C-Monitora, používajte pre rozlišovanie len položky Predmet mailu alebo Názov prílohy. Ostatné položky sú dané C-Monitorom a nie sú vhodné pre odlíšenie. Niečo však vždy zadať musíte, inak správa nebude priradená k tomuto rozvrhu.
Pridanie rozvrhu Externého programu
Obrázok: Priradenie vyhodnocovania log súboru k počítaču

Určenie emailovej adresy pre odosielanie logov do CM Servera

E-mailovú adresu, na ktorú je potrebné nastaviť odosielanie e-mailov s logmi, nájdete v nastaveniach C-Monitor klienta na ľubovoľnom počítači, ktorý je registrovaný na vašom CM Serveri.

V časti CM IT Monitoring -> C-Monitor client -> C-Monitor settings otvorte ktorýkoľvek počítač a prescrollujte sa do sekcie Parameters for email communication between C-Monitor client and CM server. Tu skopírujte email v kolónke Email address of the CM server for system e-mails from C-Monitor. Postup je znázornený aj na nasledujúcom obrázku.

Nastavenie parametrov pre emailovú komunikáciu
Obrázok: Zistenie e-mailovej adresy pre posielanie logov

Posielanie logu na CM Server pomocou C-Monitor klienta

V prípade, že má byť log súbor odosielaný na CM Server pomocou C-Monitor klienta, existuje viacero možností ako toto odosielanie nastaviť. Je potrebné rozhodnúť sa podľa:

A) Spúšťanie program je možné naplánovať cez Scheduler C-Monitora

V tomto prípade nastavíme spúšťanie externého programu cez naplánovanú úlohu v Scheduleri C-Monitora.

Na počítači otvorte cez tray menu C-Monitora Scheduler – Monitor Console -> Scheduled Tasks a kliknite vytvorenie novej úlohy (ikona „+“). Vyplňte potrebné položky:

Záložka General:

  • Name (Description) – ľubovoľné pomenovanie úlohy.
  • Command Line – spúšťací príkaz aplikácie aj s parametrami. Ak ide o názov s medzerami, dajte celú cestu aj s názvom programu do úvodzoviek a potom napíšte parametre. Dôležité je tiež nezabudnúť podpísať program ikonou zámku.
  • Startup Directory – adresár spustenia príkazu.
  • Interval (periódu spúšťania) – interval spúšťania programu.
Obrázok: Záložka General

Záložka Accounts:

  • Vyplňte ak má byť aplikácia spustená pod iným používateľom než je spustený C-Monitor.

Záložka Result Files(s):

  • Zaškrtnite wait for execution result and archive it (or) send it via E-Mail.
  • Result file – vložte cestu k log súboru vyhodnocovaného programu.
  • Get only Result File addition – zaškrtnite, ak ide o súbor, do ktorého sa budú stále pridávať záznamy. V takom prípade treba posielať iba prírastky.
Obrázok: Záložka Result File(s)

Záložka E-Mail:

  • From – akákoľvek platná emailová adresa, z ktorej môže byť email odosielaný.
  • To – zberná emailová adresa CM Servera. Bližšie popísané v Určenie emailovej adresy pre odosielanie logov do CM servera.
  • Subject, Text – ich znenie si volíte sami. Znenie musí korešpondovať s nastavením parametrov vyhodnocovania daného externého programu a rozvrhu, ktoré ste nastavili na CM Serveri.

Poznámka: Ak chcete log súbor dodatočne odosielať aj na iné emailové adresy (napr. váš email), môžete ich pridať do políčka To.

Obrázok: Záložka E-Mail

Nakoniec je v nastavení parametrov externého programu na CM Serveri potrebné nastaviť Result of program is sent as single email.

Obrázok: Nastavenie posielania výsledku „as single email“

B) Spúšťanie program nie je možné naplánovať cez Scheduler C-Monitora

V tomto prípade bude naplánovaná úloha len odosielať vytvorený log do CM Servera. Spúšťanie programu je zabezpečené mimo C-Monitora.

Nastavenie tohoto typu úlohy je popísané v článku Posielanie prírastkov Log-súboru CM Technikovi.

Dôležité: Do cieľových emailov je nutné nastaviť prijímaciu adresu CM Servera.

Obrázok: Potrebné nastavenie prijímacej adresy CM Servera

V nastavení parametrov externého programu na CM Serveri je potrebné nastaviť Result of program is sent as single email.

Obrázok: Nastavenie posielania výsledku „as single email“

Zobrazenie vyhodnotených externých programov na CM portáli

Výsledky vyhodnocovania logov z externých programov si môžete zobraziť na CM Portáli v časti CM IT Monitoring -> Application zones -> External programs.

Obrázok: Zobrazenie vyhodnotených externých programov

Upozornenie v CM poruchách

Ak sa na základe vyhodnotenia externého programu vytvorí CM Porucha, bude sa dať zobraziť v časti CM IT Monitoring -> Notices -> Errors.

Obrázok: Vygenerované poruchy z externých programov