Logovanie chodu aplikácie

Všetky súčasti systému ABRA Gen obsahujú logovací subsystém, ktorý umožňuje podrobné logovanie činnosti aplikácie do súboru. Logovanie používa typicky technik dodávateľa systému pri problémoch s aplikáciou, pri hľadaní riešenia pre optimalizáciu dotazov a pod. Logovanie môže použiť aj skúsený užívateľ, avšak v tomto prípade odporúčame, aby svoje kroky konzultoval s dodávateľom systému. Konfigurácia logovania sa vykonáva pomocou súboru NEXUS.CFG v sekcii logovania. V stanovenom intervale (východisková hodnota je 1 minúta) aplikácia číta tento súbor a zmeny v parametroch logovania okamžite aplikuje, preto je možné logovanie zapínať a vypínať aj za behu aplikácií.

Vzhľadom na to, že zapnuté logovanie má negatívny vplyv na výkon aplikácií, odporúčame v produkčnom systéme pri plnej záťaži logovanie zapínať len na nevyhnutne potrebnú dobu.

V sekcii logovania súboru Nexus.cfg sú o .i. k dispozícii parametre Enabled pre povolenie/zakázanie daného druhu logovania, Level pre nastavenie úrovne logovania, LogDirectory pre nastavenie adresára na ukladanie logovacieho súboru, nastavenie, či logovať do súboru či do pamäti aplikačného servera a mnoho ďalších: 

Aplikácia pri svojom behu generuje veľký počet hlásení, ktoré sa pri vypnutom logovaní zahadzujú, čo nijak neovplyvňuje výkon aplikácie. Tieto hlásenia možno smerovať do súboru, pre každú aplikáciu (klient ABRA Gen, aplikačný server na Windows AppServer/AppServerS či na Linuxe AppServerL a pod.) sa hlásenia logujú do samostatného súboru, pri každom novom spustení aplikácie sa zakladá nový súbor. Jednotlivé hlásenia sú kategorizované podľa miesta, kde vznikli (trieda), a podľa dôležitosti (úroveň). Hlásenia je možné filtrovať podľa kategórií tak, aby sa v logu objavili hlásenia z len vybraných tried a do určenej úrovne dôležitosti.

Konfigurácia logovania má hierarchickú štruktúru a vykonáva sa pomocou týchto sekcií v súbore NEXUS.CFG, vyhodnotenie parametrov logovania sa vykonáva v tu uvedenom poradí:

Pre zapnutie samotného logovania. Nastavenia platné pre všetky triedy a všetky počítače. Táto sekcia zároveň umožňuje nastavenie globálnych parametrov ovplyvňujúcich logovanie platných pre všetky počítače, ako je napr. formát mena logovacích súborov apod.

Zapnutie logovania výnimiek (s vynechaním štandardných akcií):

[Log.ExceptionHook]
Enabled=1
ExcludedExceptionClasses=EAbort;NxHiddenError;EIdSocketError;EIdConnectTimeout;EIdNotASocket;EIdReadTimeout;EDataProtection_CannotRead;EDataProtection_CannotWrite

Vypnutie logovania všetkých výnimiek:

[Log.ExceptionHook]
Enabled=0

Zapnutie logovania len SQL:

[Logs]
LogsDirectory=<cesta platná z pohľadu aplikácie>

[Log.SQL]
Enabled=1
Level=6

Zapnutie logovania všetkého (voliteľne je možné obmedziť na konkrétne aplikácie):

[Logs]
LogsDirectory=<cesta platná z pohľadu aplikácie>
Enabled=1
#Obmedzenie na konkrétne aplikácie
#AllowedApps=AbraGen;AppServer64;appserverl-x64

Nastavenie pre jednu <triedu>, platí pre všetky počítače. Zoznam možných tried je uvedený v samostatnej kapitole nižšie.

Nastavenie pre všetky triedy, platí pre uvedený <počítač>. Meno počítača musí byť uvedené menom, nie IP adresou. Na Linuxe je možné zistiť meno počítača pomocou príkazu "hostname". Klienti v terminálovej prevádzke sa identifikujú ako <meno_serveru>.<meno_stanice>, napr. "SERVER.UCTARNA". Táto sekcia zároveň umožňuje nastavenie globálnych parametrov, podobne ako sekcia [Logs], avšak platných pre uvedený počítač. Tu je napríklad výhodné definovať cestu pre súbory a logy a pod.

Nastavenie cesty pre ukladanie logov na Linuxe (všeobecný názov "ComputerName" nahraďte skutočným názvom počítača získaným príkazom "hostname"):

[ComputerName:Logs]
LogsDirectory=/usr/local/abragen/logs

Nastavenie len pre jednu <triedu>, platí pre uvedený <počítač>.

a) pokiaľ je v konfiguračných nastaveniach nejaká chyba (chybná cesta, preklep v názve parametra), tak je takéto nastavenie ignorované. Ak ide o podstatnú časť pre logovací systém, môže táto skutočnosť viesť až k jeho nefunkčnosti. Žiadne vizuálne prejavy tohto stavu nie sú zámerne riešené.

b) z nasledujúcich nastavení bude zrejmé, že logovanie môže byť zapnuté ako pre klientsku aplikáciu (napr. AbraGen.exe) tak aj pre nejakú serverovú časť aplikácie (napr. AppServers.exe). Oboje spôsobí proces logovania, ale každé na inom mieste. S jedným a tým istým nastavením logovania v nexus.cfg teda bude aplikácia vytvárať svoje logy na klientskej stanici, zatiaľ čo aplikačný server bude logovať na serveri.

Tieto parametre sú platné len pre sekciu [Logs] a [<počítač>.Logs].

Nastavenie intervalu, v akom bude konfigurácia logovania načítaná. Hodnota sa zadáva v sekundách a minimálna hodnota je 10 sekúnd.

Implicitná hodnota je 60 sekúnd.

Nastavenie cesty, do ktorej sa majú ukladať súbory logov.

Implicitná hodnota je cesta do temp adresára. V prípade windows to je obsah env. premennej TEMP (typicky c:\Documents and settings\aktuálny_užívateľ\Local Settings\Temp). Na Linuxe je typické umiestnenie v ceste /tmp. Na rýchlejšie nájdenie logov odporúčame prepísať si na nejakú jednoduchú cestu napr. C:\Logy.

Pozor, cesta musí existovať. Prebieha test na existenciu cesty. V prípade, že cesta neexistuje alebo do nej nie je možné zapisovať, logy sa nevytvárajú a logovanie je zastavené. Po prenačítaní konfigurácie (ktorá prebieha každých cca 60 s, resp. podľa intervalu nastaveného v RefreshConfigurationInterval) systém pokus zopakuje a pokiaľ je cesta stále chybná, je logovanie opäť zastavené. Pokiaľ bola medzitým konfigurácia opravená a zadaná cesta je v poriadku, logovanie sa rozbehne.

Pre minimalizáciu negatívneho dopadu na výkon je vhodné súbory s logmi ukladať na rýchly SSD disk.

Definuje veľkosť logu v bytoch, po jeho prekročení dôjde k presunutiu aktuálneho súboru do zálohy a začne sa vytvárať nový súbor. Súbor so zálohou má rovnaké meno ako pôvodný súbor logu, len sa doplní o príponu s poradovým číslom zálohy. Prípadné existujúce súbory sú prečíslované na číslo o jednotku vyššie.

Implicitná hodnota je 1 073 741 824B, tzn. 1GB.

Počet súborov záloh. Súbor odsunutý do zálohy dostane k menu súboru ako príponu číslo. Čím väčšie číslo, tým sa jedná o staršie logy. Staršie súbory ako nastavený počet sú zabudnuté.

Implicitná hodnota je 5.

Maska pre zostavenie mena logovacieho súboru. V maske sa môžu objaviť nasledujúce značky:

  • %0:s = časová značka založenia súboru
  • %1:s = meno aplikácie bez prípony, tzn. názov procesu
  • %2:s = PID procesu
  • %3:s = meno počítača
  • %4:s = identifikácia systému (napr. ABRA Gen)

Pokiaľ sú uvedené všetky parametre v tomto poradí, je možné použiť len značky %s bez čísla. Odporúčame zadať si v tomto parametri príponu .txt, aby jednotlivé logy bolo možné na windows rýchlo zobrazovať a nebolo nutné vyberať aplikáciu na zobrazenie.

FileNameFormat=LOG%4:s %0:s %1:s %2:s %3:s.txt

PID procesu využijete napr. pri logovaní autoservera, pokiaľ chcete zabrániť zápisu rôznych slave procesov do jedného log súboru.

Implicitná hodnota je "%s %s %s %s %s.log".

Formát časovej značky v mene súboru logu. Je možná ľubovoľná kombinácia nasledujúcich značiek (príklady v zátvorke pre 1.2.2005 06:07:08.009):

  • d = den (1)
  • dd = deň s vodiacou nulou (01)
  • ddd = skratka dňa v týždni (Wed)
  • dddd = deň v týždni (Wednesday)
  • m = mesiac (2)
  • mm = mesiac s vodiacou nulou (02)
  • mmm = skratka názvu mesiaca (Feb)
  • mmmm = názov mesiaca (February)
  • yy = posledné dvojčíslie roku (05)
  • yyyy = rok (2005)
  • h = hodina (6)
  • hh = hodina s vodiacou nulou (06)
  • n = minuta (7)
  • nn = minúta s vodiacou nulou (07)
  • s = sekunda (8)
  • ss = sekunda s vodiacou nulou (08)
  • zzz = milisekunda s vodiacou nulou (009)

Implicitná hodnota je "yy-mm-dd hh-nn-ss".

Pozor: Časová značka funguje na dátum a čas spustenia príslušnej aplikácie. Z toho vyplýva, že druhé spustenie nejakej aplikácie (napr. AbraGen.exe) vždy znamená LOG súbor s novým menom.

Tieto parametre sú platné pre všetky sekcie.

Ak je nastavené na 1, logovanie je aktívne

Implicitná hodnota je 0. Platí pre všetky triedy (v predchádzajúcich verziách sa v prípade niektorých tried vyskytla výnimka (napr. SysLog), kedy ich logovanie bolo implicitne zapnuté).

Úroveň informácií, ktoré sa majú logovať. Platí, že čím vyššie číslo, tým viacej informácií sa bude logovať. Možné hodnoty sú:

  • 0 (Systém) - systémové informácie, typicky spustenie a ukončenie aplikácií
  • 1 (Critical) - kritické chyby
  • 2 (Error) - chyby
  • 3 (Warning) - varovanie
  • 4 (Notice) - bežné hlásenia
  • 5 (Info) - rozširujúce informácie
  • 6 (Debug) - ladiace informácie

Implicitná hodnota je 0.

Zoznam aplikácií, ktorých činnosť sa má logovať. Mená aplikácií sa uvádzajú bez prípony a oddeľujú bodkočiarkou, hodnota "*" znamená všetky aplikácie.

AllowedApps=AbraGen;AppServerS;ABRAOLE;DBTOOL;appserverl-x64

Implicitná hodnota je "*".

Formát časovej značky hlásenia v logu, pozri popis parametra FileNameStamp.

Implicitná hodnota je "ddd dd. hh:nn:ss.zzz".

Formát riadku v logovacom súbore, ide o ľubovoľný text, v ktorom sa môžu objaviť nasledujúce značky:

  • %0:s = časová značka hlásenia
  • %1:s = číslo úrovne
  • %2:s = číslo threadu
  • %3:s = identifikácia triedy

Text hlásenia nie je možné týmto nastavením ovplyvniť. Vždy je pridaný na koniec reťazca.

Pokiaľ sú uvedené všetky parametre v tomto poradí, je možné použiť len značky %s bez čísla.

LineFormat=%0:s [%1:s] %2:s (%3:s)

Implicitná hodnota je "%s [%s] %s (%s)"

Určuje, kam sa bude log ukladať. Možné hodnoty sú: file a memory. Je ich tiež možné kombinovať dohromady, v tom prípade sa oddelia čiarkou alebo bodkočiarkou.

file - výstup sa bude ukladať do súboru tak, ako doteraz. Je to tiež východisková voľba pre väčšinu logovacích tried.

memory - výstup sa bude ukladať do pamäte aplikačného servera. Zobraziť ho je možné pomocou aplikácie AppServerProp.exe.

Target=file,memory

Platí len, ak je v Target uvedené memory a určuje, koľko posledných zápisov do logu sa bude uchovávať na apl. serveri. Táto hodnota sa vzťahuje k jednému spojeniu na apl. server.

Východisková hodnota je 50.

Systémové hlásenia.

Hlásenie subsystému pre prideľovanie unikátnych identifikátorov.

Informácie o perzistentných kanáloch.

Podrobné informácie z obnovy dát.

Informácie z update databázy.

Hlásenie z prenosovej vrstvy (stub objekty).

Hlásenie z najnižšej TCP vrstvy.

Hlásenie z prenosovej vrstvy (proxy objekty).

Informácie o databázových spojeniach a transakciách.

Vysokoúrovňové správy o perzistentných akciách (objekt uPersist).

Informácie o datasetoch v DynSQL.

Logovanie SQL - načítanie BO.

Logovanie SQL - počet BO.

1. Logovanie SQL - testovanie existencie záznamu.

Logovanie SQL - vytváranie záznamu BO.

Logovanie SQL - opravy záznamu BO.

Logovanie SQL - zmazanie záznamu BO.

Logovanie SQL - perzistentné akcie, ktoré čítajú dáta (SELECT).

Logovanie SQL - perzistentné akcie, ktoré menia dáta vrátane DML.

Špeciálna skupina na logovanie len tých SQL príkazov, ktoré prekročia určitý čas.

Má navyše tieto parametre:

Threshold - doba v ms., pri jej prekročení sa SQL príkaz zaloguje, defaultne je 60000

SQLOutputLength - počet znakov SQL príkazu, ktoré sa zalogujú, defaultne je 20. Pri nastavení na 0 sa zaloguje celý SQL príkaz.

Logovanie použitých licencií pre lepšiu diagnostiku využitia licencií.

Je dostupný od Level=4.

Pomocná skupina zjednodušujúca ovládanie komunikácie s SQL serverom. V sekcii konfigurácie skupiny možno použiť len parametre Enabled a Level, pričom sa nimi naraz konfigurujú všetky triedy, ktoré patria do tej istej skupiny.

Časť súboru NEXUS.CFG s konfiguráciou logovania prebiehajúcich SQL:

[Logs]
LogsDirectory=C:\Logs

[Log.SQL]
Enabled=1
Level=6

Logovanie ABRA WS servera a webových služieb. Pôvodné riešenie jednou triedou bolo zmenené na niekoľko logovacích, podrobnejších tried, ktoré je možné lepšie konfigurovať a získavať tak podstatné informácie. Pri implementácii webových služieb sa odporúča zapnúť skupinu. Pozor, bude vznikať množstvo log súborov, ktoré je nutné rozumne odsúvať.

Logovanie XML správ posielaných a prijímaných v rámci komunikácie s Verejným rozhraním pre e-Podanie (VREP) a na lepšiu diagnostiku problémov pri komunikácii s portálom.

Logovanie dostupných informácií o logovacom subsystéme.

Logovanie vyvolávania niektorých funkcií Oracle clienta. Defaultný Target tohto logu je memory.

Logovanie správ windows v hlavnom okne aplikácie a niektorých ďalších prvkoch.

Má navyše tieto parametre:

  • MsgMin - min. číslo správy, od ktorej sa bude logovať
  • MsgMax - max. číslo správy, od ktorej sa bude logovať
  • SourceContain - text, ktorý musí obsahovať text správy, aby sa zalogovala

Pri Level=2 sa loguje len, ak nastane v obsluhe správy výnimka, pri Level=6 sa logujú všetky správy, ktoré do obsluhy správ vstúpia

Logovanie vytvorenia a zrušenia niektorých objektov.

Logovanie modulu SCM. (Napr. časy načítania jednotlivých dátových zdrojov do SQL Lite, dopytovanie SQL Lite, a pod.)

Logovanie odosielania e-mailov zo systému ABRA Gen. O. i. vypíše informácie týkajúce sa odosielania e-mailov prostredníctvom SimpleMAPI rozhrania resp. cez OLE rozhranie Outlooku. Viď tiež help.

Logovanie funkcií digitálneho zabezpečenia - podpisovania a kryptovania.

Logovanie rýchleho vyhľadávania v ABRA Gen.


[Log.FastSearch]
Enabled=1
Level=6

Logovanie prihlasovania do ABRA Gen.

Logovanie v číselníkoch.

Logovanie tlačiarní o informácie týkajúce sa tlačiarne v ovládačoch AbraReport a WinPrint. (Napr. uložená tlačiareň, uložený formát stránky, zoznam dostupných tlačiarní, šírka a výška papiera.)

Na požadovanom mieste vytvoriť adresár pre vznikajúce logy (napr. "C:\G3\AbraGen\Logs").

Do súboru Nexus.cfg je potrebné pridať:

[Logs]
LogsDirectory=C:\G3\AbraGen\Logs
Level=6
[Log.Print]
Enabled=1

Ukážka Logu: 

čt 10. 07:54:02.483 [4] 00007028 (Print) TNxAbraReportDriver.DoConnectPrinter()
čt 10. 07:54:02.484 [4] 00007028 (Print) -->
čt 10. 07:54:02.485 [6] 00007028 (Print) Saved PrinterFullName = "EPSON TM-T20II Receipt"
čt 10. 07:54:02.486 [6] 00007028 (Print) Get RemoteSession: "False"
čt 10. 07:54:02.486 [6] 00007028 (Print) Terminal session: "False"
čt 10. 07:54:02.488 [6] 00007028 (Print) PrinterIndex = "6"
čt 10. 07:54:02.488 [6] 00007028 (Print) Selected printer name = "EPSON TM-T20II Receipt"
čt 10. 07:54:02.489 [6] 00007028 (Print) Windows printers = "PDFCreator, OKI-C332-2152A1, "OKI C332 PS na Sofia", "Microsoft XPS Document Writer", "Microsoft Print to PDF", Fax, "EPSON TM-T20II Receipt", "ABRA KONICA MINOLTA PS BW Laser Class Driver", \\sofia\Konika_Minolta_1600f, "#BAREVNA# KONICA MINOLTA C554SeriesPCL""
čt 10. 07:54:02.490 [6] 00007028 (Print) PaperID = "240"
čt 10. 07:54:02.671 [6] 00007028 (Print) PaperName = "Roll Paper 80 x 297 mm"
čt 10. 07:54:02.690 [4] 00007028 (Print) 
čt 10. 07:54:02.690 [4] 00007028 (Print) TQRPrinter.Create()
čt 10. 07:54:02.691 [4] 00007028 (Print) -->
...
čt 10. 07:54:22.041 [4] 00007028 (Print) TNxAbraReportDriver.PrintBill()
čt 10. 07:54:22.042 [4] 00007028 (Print) -->
čt 10. 07:54:22.043 [6] 00007028 (Print) Saved PrinterFullName = "EPSON TM-T20II Receipt"
čt 10. 07:54:22.044 [6] 00007028 (Print) Get RemoteSession: "False"
čt 10. 07:54:22.045 [6] 00007028 (Print) Terminal session: "False"
čt 10. 07:54:22.046 [6] 00007028 (Print) PrinterIndex = "6"
čt 10. 07:54:22.047 [6] 00007028 (Print) Selected printer name = "EPSON TM-T20II Receipt"
čt 10. 07:54:22.048 [6] 00007028 (Print) Windows printers = "PDFCreator, OKI-C332-2152A1, "OKI C332 PS na Sofia", "Microsoft XPS Document Writer", "Microsoft Print to PDF", Fax, "EPSON TM-T20II Receipt", "ABRA KONICA MINOLTA PS BW Laser Class Driver", \\sofia\Konika_Minolta_1600f, "#BAREVNA# KONICA MINOLTA C554SeriesPCL""
čt 10. 07:54:22.181 [4] 00007028 (Print) 
čt 10. 07:54:22.189 [4] 00007028 (Print) NxCheckAvailablePrinters()
čt 10. 07:54:22.190 [4] 00007028 (Print) -->

Tieto triedy boli zrušené. Namiesto nich vznikla skupina UnusedNumbers.

Trieda ExceptionHook loguje výnimky v systémovom háčiku. Tento log je schopný zaznamenať všetky výnimky počas chodu programu, pokiaľ také v systéme nastanú (využitie napr. na logovanie automatizačného servera), ale aj inde. Pri ukončovaní aplikácie sa udalosti zaznamenávajú len počas doby existencie inštancie logovacej triedy.

ExcludedExceptionClasses

V aplikáciách sa používa mnoho tried výnimiek, napr. Exception, NxError, EAbort atd. Logovanie všetkého robí vyhľadávanie informácií zložitejším, je preto možné zadať filter, ktoré triedy nás nezaujímajú. Viac tried je nutné oddeliť bodkočiarkou.

Východisková hodnota je EAbort;NxHiddenError;EIdSocketError;EIdConnectTimeout;EIdNotASocket;EIdReadTimeout;EDataProtection_CannotRead;EDataProtection_CannotWrite

Parameter by mal obsahovať všetky triedy z východiskovej hodnoty, pokiaľ užívateľ skutočne nepotrebuje niektorú z nich z dôvodu riešenia problému logovať.

ExcludedNxErrorCodes

ABRA zaviedla svoju triedu výnimiek NxErorr. Jednotlivé chyby sa od seba rozlišujú číslom, tzv. ErrorCode. Podobne ako v prípade ExcludedExceptionClasses je výhodné určité chybové kódy nelogovať. Viac hodnôt je možné zadať tak, že jednotlivé hodnoty sa oddelia bodkočiarkou.

Východisková hodnota parametra ExcludedNxErrorCodes je 1511 (neexistujúca položka business objektu). Tzn. ak parameter ExcludedNxErrorCodes nie je nastavený, neloguje sa výskyt výnimky 1511 a ostatné výnimky sa logujú.

Pri nasledujúcom nastavení sa logujú všetky výnimky okrem 1511:

[Log.ExceptionHook]
Enabled=1

Ak chcete zapnúť logovanie výnimky 1511, musíte v Nexus.CFG uviesť nasledujúce:

[Log.ExceptionHook]
Enabled=1
ExcludedNxErrorCodes=

CallStack

Príznak, či sa má doplniť ku každej výnimke CallStack.

Východisková hodnota je 1.

CallStack na linuxovom aplikačnom serveri sa generuje, pokiaľ sú splnené nasledujúce podmienky:

  • Logovanie výnimiek je zapnuté.
  • Existuje adresár, do ktorého sa má log zapísať.
  • Vytvorenie CallStacku nie je zakázané nastavením parametra callstack=0.

Ukážka vypnutia logovania CallStacku na linuxovom aplikačnom serveri:

[Log.ExceptionHook]
Enabled=1
CallStack=0

WithConvertions

Príznak, či sa majú zaznamenávať do logov i konverzie výnimiek.

Východisková hodnota je 0.

Trieda ExceptionHooked loguje aktiváciu/deaktiváciu systému logovania výnimiek, tzn. zahájenie/ukončenie vytváranie logu ExceptionHook.

Ak je aktivované, zapisujú sa do logu záznamy podobné nasledujúcim:

... (ExceptionHooked) Delphi exception system hooked
... (ExceptionHooked) Exception notifier installed
...
... (ExceptionHooked) Delphi exception system unhooked
... (ExceptionHooked) Exception notifier uninstalled

Východisková hodnota je 0.

Trieda ModalWindows zapisuje do logu informácie o modálnych oknách. Takéto okno vyžaduje interaktívny zásah obsluhy. Aktiváciou logu sa môže osvetliť, prečo dôjde k "zaseknutiu" procesov, ktoré nesmú byť interaktívne, napr. webové služby, automatizačný server atď.

Trieda Scripting je zverejnená do skriptovania a umožňuje vykonávať interné logovanie priamo zo skriptovania. Pre zápis informácií do logu zo skriptov je určená trieda TNxScriptingLog a jej metódy, predovšetkým metóda WriteEvent, viď tiež logovanie zo skriptovania.

Skupina zaznamenávajúca informácie o chode automatizačného servera. Aby bolo možné rozumne logovať dianie v automatizačnom serveri, používajú sa pre jeho časti vlastné logy. Logov nie je málo, kvôli zjednodušeniu konfigurácie logovania sme preto zaviedli skupinu. Nie je potrebné obávať sa spomalenia automatizačného servera.

Pozor, pri logovaní automatizačného servera v čase vzniká množstvo súborov, ktoré je potrebné rozumne odsúvať.

Skupina by mala byť vždy aktivovaná.

Skupina umožňuje logovať činnosť Vizualizácie dát. Skupina zapne logovanie tried AbraBI a AbraBIStarterThread, ktoré je možné prípadne jednotlivo vypínať.

Trieda umožní logovať Vizualizáciu dát v systéme ABRA Gen.

Trieda umožní logovať spustenie vstavaného aplikačného servera Jetty.

Pokiaľ použijete iný aplikačný server, napr. Tomcat, nie je možné ho logovať.

Zaznamenávanie synchronizačných objektov automatizačného servera. Automatizačný server je viacvláknová aplikácia, ktorá používa synchronizačné objekty jadra windows. Skupina poskytuje doplnkové informácie k skupine AS~GROUP. Informácie sú čisto ladiaceho charakteru.

Skupinu aktivovať len na žiadosť vývoja, inak zbytočne zahlcuje logy. Nemá zmysel skupinu aktivovať bez skupiny AS~GROUP.

Jednotlivé typy úloh automatizačného servera logujú informácie. Tried v tejto skupine je opäť mnoho, čo typ úlohy, to logovacia trieda.

Triedu odporúčame aktivovať v okamihu, keď je potrebné sledovať, čo sa v úlohách deje. Nemá zmysel skupinu aktivovať bez skupiny AS~GROUP.

Trieda zapisuje do logu informácie o priebehu predkontovania účtovných zápisov. Loguje pomocou správ typu 4 (Notice, "bežné hlásenia") a prípadné chyby počas vyhodnotenia výrazu predkontácií pomocou typu 2 (Error, "chyby"). Triedu odporúčame aktivovať v okamihu, keď je potrebné sledovať, čo presne sa deje v okamihu predkontovávania, ak sa účtovné zápisy nepredkontovali podľa očakávania, ale nie je zrejmé, prečo.

Trieda zapisuje do logu informácie o všetkých chybných SQL dopytoch.

Trieda zapisuje do logu informácie o chybných HTTP komunikáciách.

Napr. pri blokovaní odchádzajúcich pripojení z panela Aktuality z okna pre spúšťanie agend môže zápis v logu vyzerať nasledovne: 

Exception: EIdSocketError Socket Error # 10013. Access denied.

Trieda zapisuje do logu priebeh spracovania exportov v rámci EDI komunikácie a umožňuje tak jednoduchšie odladenie vyhodnocovania pravidiel spracovania exportov.

[Log.EDI]
Enabled=1
Level=6

Skupina umožňuje logovať činnosť OLE klienta. Pre všetky triedy v OLE sú zavedené samostatné logy, ktoré sú súčasťou skupiny AbraOLE, stačí teda zapnúť ju.

[Log.AbraOLE]
Enabled=1
Level=6

Skupina slúži na logovanie Web API služieb.

Ide o logovanie na úrovni "business logiky". Web API server obdrží požiadavku, odovzdá ho knižnici ApiLib.dll a samotné vybavovanie požiadavky je logované v závislosti na tu popísanej konfigurácii WA~Group. Okrem toho je možné logovať tiež činnosť samotného Web API servera - prijímanie HTTP požiadaviek od klienta a vracanie odpovedí. Viac informácií viď sekcia Logovanie v kapitole Nastavenie Web API.

Konfigurácia pri detailnom ladení (napríklad pri odhaľovaní problémov v spolupráci s vývojovým oddelením dodávateľa):

[Logs]
LogsDirectory=<cesta platná z pohľadu aplikácie>
AllowedApps=java
[Log.WA~Group]
Enabled=1
Level=6

Skupina obsahuje celý rad tried pre logovanie nízkoúrovňových operácií, ktoré je často z výkonnostných dôvodov vhodné deaktivovať.

Pokiaľ zapnete logovanie vybraných operácií pomocou niektorej konkrétnej triedy (viď príklady nižšie), nezabudnite zapnúť tiež logovanie celej skupiny WA~Group.

Obmedzenie logovania na správy o spracovaní požiadaviek klienta:

[Log.WA/Requests]
Enabled=1

[Log.WA/RequestProxy]
Enabled=1

[Log.WA/WorkerList]
Enabled=0

[Log.WA/SysReqHandler]
Enabled=0

[Log.WA/SupervisorHandler]
Enabled=0

[Log.WA/ErrorCheckThread]
Enabled=0

[Log.WA/InstMiddleware]
Enabled=0

[Log.WA/ProcessPool]
Enabled=0

[Log.WA/SysMiddleware]
Enabled=0

Skupinu je možné využiť tiež na logovanie monitorovania spotreby pamäte.

Aktivácia monitorovania pamäte:

[Log.WA/MemoryMonitoring]
Enabled=1

Logovanie môže pomôcť pri odhalení situácie, kedy sa po dokončení požiadavky neuvoľní celková alokovaná pamäť - v logu sa objaví záznam obsahujúci informáciu, ktorá vyzerá nasledovne:

[6] 00006E14 (WA/MemoryMonitoring) Memory that remained allocated on demand (X-RequestID=IJC1THIMV5Y4PGIJSSWQXFNT40): 27 656 192 B

V rámci skupiny je možné logovať tiež dopytovanie dynamických SQL:

Aktivácia logovania dopytovania DynSQL prostredníctvom Web API:

[Log.WA/DSQL/Compiler]
Enabled=1
								
[Log.WA/DSQL/Exexutor]
Enabled=1

Log DSQL/Compiler pokrýva fázu prípravy DynSQL, DSQL/Executor potom vlastní vykonávanie dopytu (načítanie dát na úrovni jednotlivých datasetov).

Ďalšou možnosťou využitia je logovanie volania skriptov:

Aktivácia logovania volania skriptov prostredníctvom Web API:

[Log.WA/Script]
Enabled=1

Umožňuje logovať vyvolanie online nápovedy. Viď tiež Často kladené otázky - Problémy so spustením online nápovedy v prehliadači po použití F1.

[Log.AbraHelp]
Enabled=1
Level=6

K logovaniu inštalácie:

  • logovanie inštalácie update:

    Inštalácia nemá žiadne svoje špeciálne vyvolanie logovania, takže sa loguje všeobecným zapnutím logovania bez špecifikácie.

    Príklad zápisu do sekcie logovania v nexus.cfg:

    [Logs]

    Enabled=1

    Level=6

    LogsDirectory={DIR}

    Výsledný log bude napr.: 17-02-02 17-51-58-055 Setup2 1820 COMPILER.MICE-NTB2 ABRAGen.log

    Takto zapnuté logovanie znamená, že sa potom bude logovať i vlastná ABRA Gen. Pokiaľ to nechcete a zaujímala vás len inštalácia, tak po vykonaní inštalácie je potrebné príkaz pre logovanie v nexus.cfg zapoznámkovať alebo ho odstrániť.

    Okrem vyššie uvedeného inštalačný proces ďalej loguje výsledky kontrol vykonávaných počas inštalácie update (kontroly databázy za každé spojenie a pod.). Toto sa deje vždy, nie je potrebné nijak zapínať. Výsledný log je súbor s názvom tvoreným podľa inštalovanej verzie, dátumu atd. Napr. installlog_170103_17-02-02 16-29-02-013.txt a je uložený v roote inštalácie ABRA Gen.

  • logovanie novej inštalácie:

    Pri novej inštalácii nie je možné logovanie riešiť zapnutím logovania v nexus.cfg (keďže tento zatiaľ neexistuje). Rieši sa spustením inštalačného programu s parametrom. Viď parametre inštalačného programu - parameter -log-new-installation.

Skupina umožňuje logovať Nepoužité čísla dokladov.

[Log.UnusedNumbers]
Enabled=1
Level=6

Log.GDIHandles umožňuje logovať aktuálne alokované handlery. Používa sa v špecifických prípadoch pri odhaľovaní možných príčin leakovania alebo pádov Web API.

[Log.GDIHandles]
Enabled=1
Level=6

Logovanie činností spojených s funkcionalitou ochrany dát. Skupinu tvorí niekoľko tried, ktoré je možné konfigurovať samostatne (hlavne zapínať/vypínať logovanie a nastavovať úroveň podrobnosti) alebo zapnúť logovanie pre všetky triedy zo skupiny naraz.

Nastavením podľa nižšie uvedeného príkladu by sa zahájilo logovanie na maximálnej úrovni podrobnosti pre celkovú funkcionalitu spojenú s ochranou dát (z dôvodu vyťaženia systému neodporúčame).

[Log.DataProtection~Group]
Enabled=1
Level=6

V súčasnej spadajú do tejto skupiny štyri logovacie triedy, logovanie činností príslušných komponentov možné nastavovať v štyroch zodpovedajúcich sekciách NEXUS.CFG:

  • [Log.DataProtection] - Loguje aktivity spojené s používaním tried TNxCompanyCache.TDataProtectionCache a TNxDataProtection - vstupy/výstupy do/z dôležitých metód.
  • [Log.DataProtectionUpdater] - Loguje aktivity spojené s generovaním povolení na spracovanie dát - log obsahuje identifikáciu povolenia, zdrojového záznamu (z ktorého sa povolenie generuje), subjektu (napr. osoby alebo firmy), pravidla, definície.
  • [Log.DataProtectionFindOwnerInDB] - Loguje aktivity spojené s dohľadávaním vlastníka (dopytom do databázy).
  • [Log.GDPRDriver] - Loguje aktivity spojené s používaním triedy TNxGDPRDriver (činnosť ovládača ochrany dát).

Zoznam obsahuje ďalšie triedy a skupiny, ktoré je pre logovanie možné zapnúť. Ide o menej používané triedy, ktoré majú využitie skôr pre logovanie chodu aplikácie vývojármi, preto uvádzame len anglické názvy tried a skupín bez ďalšieho vysvetlenia.

  • Debugger
  • WA/RESTApplication/Memory
  • WA/RESTApplication/ProfilingRequest
  • WA/RESTApplication/Pool
  • WA/RESTApplication/Security
  • NonNativeClients
  • ARCScripting
  • StopWatch
  • BOOperation
  • PhoneDrivers
  • Styles
  • WindowsInfo
  • ZOrderInfo
  • GridPaintMsg
  • SiteOperation
  • AfterSave
  • PLMValuation'
  • HTTPProxy
  • AbraBI
  • UnusedNumbers/Cleaner
  • UnusedNumbers/Cleaner/Threads
  • UnusedNumbers/Server
  • UnusedNumbers/Client
  • NPS
  • DataProtectionOwnerSeeker
  • DataProtectionReportExport
  • BlobBusinessObject
  • CRPPlan
  • ObjectSpace
  • StoreDoc
  • Production
  • WA~Monitoring
  • WageCalculator
  • HeaderAndRowsAmounts
  • WindowsInfo~TaskGroup
  • AppServer
  • NPS~Group
  • Rolls~Group
  • DataSets~Group