Aplikácia IBM® Enterprise Records zahŕňa vzorový súbor log4j.properties, ktorý môžete nakonfigurovať.
Súbor log4j.properties je v priečinku ier_install_path\ RecordsManagerSweep a môžete nakonfigurovať správanie protokolovania špecifikáciou hodnôt v tomto súbore pre nasledujúce vlastnosti:
Každému zapisovaču v súbore log4j.properties je priradená úroveň. Ak nepriradíte úroveň zapisovaču, log4j automaticky priradí nepriradenému zapisovaču úroveň rodičovského zapisovača. Štandardne je zapisovaču priradená úroveň WARN.
Súbor log4j.properties môžete nakonfigurovať s rôznymi nastaveniami zapisovača, pripájača a rozloženia. Súbor log4j.properties musí byť dostupný pre aplikáciu v čase vykonávania z cesty triedy. Záznamy vo vzorovom súbore môžete označiť za komentár, keď pred príkaz pridáte symbol mriežky (#). Záznamy označené symbolom mriežky (#) budú v čase vykonávania preskočené.
Na otvorenie súboru log4j.properties choďte do priečinka ier_install_path\RecordsManagerSweep, potom otvorte súbor pomocou textového editora.
Najskôr musíte nastaviť zapisovač. Môžete mať viacero zapisovačov na klasifikáciu typu protokolovania, ktoré potrebujete pre aplikáciu. Na povolenie protokolovania pre všetky triedy com.filenet.rm a jeho podbalíky, špecifikujte zapisovač ako je ukázané v nasledujúcom príkaze:
log4j.logger.com.filenet.rm
Alebo môžete špecifikovať ľubovoľné meno pre zapisovač. Napríklad môžete pomenovať váš zapisovač APILOG ako je ukázané v nasledujúcom príkaze:
log4j.logger.com.filenet.rm=warn, APILOG
Musíte nastaviť úroveň protokolovania na vytvorenie detailnej úrovne správ, ktoré zaznamenáva log4j v čase vykonávania. log4j podporuje päť normálnych úrovní protokolovania ako ukazuje nasledujúca tabuľka:
Úroveň | Popis |
---|---|
DEBUG | Označuje jemnozrnné informačné udalosti, ktoré sú najužitočnejšie na ladenie aplikácie. |
INFO | Označuje informačné správy, ktoré zvýrazňujú postup aplikácie na hrubozrnnej úrovni. |
WARN | Označuje potenciálne škodlivé situácie. |
ERROR | Označuje chybové udalosti, ktoré stále umožňujú aplikácii pokračovať v chode. |
FATAL | Označuje udalosti závažných chýb, ktoré môžu spôsobiť zastavenie chodu aplikácie. |
Pozrite si dokumentáciu log4j na webovej stránke Apache pre informácie o špeciálnych a vlastných úrovniach protokolovania. Aplikácia štandardne začína v úrovni WARN. Túto úroveň možno v čase vykonávania upraviť na úroveň DEBUG, INFO, ERROR, WARN alebo FATAL. Môžete tiež zahrnúť viaceré príkazy zapisovača, každý pre rovnaký zapisovač, ale s odlišnými úrovňami (napríklad DEBUG pre jednu, WARN pre druhú). Jednu alebo druhú môžete okomentovať vo vzorovom súbore tak, že pred príkaz napíšete symbol mriežky (#). Potom sa môžete v prípade potreby prepínať medzi úrovňami DEBUG a WARN. Záznamy označené symbolom mriežky (#) budú v čase vykonávania preskočené. Zapisovač, ktorý nemá úroveň, automaticky zdedí úroveň jeho rodičovského zapisovača. Zapisovač API má v IBM Enterprise Records štandardne priradenú úroveň WARN.
Zapisovač je priradený k jednému alebo viacerým pripájačom, čo umožňuje, aby boli jeho správy protokolu zapisované do výstupného média. Môžete nastaviť rôzne druhy pripájačov v súbore log4j.properties, ktorý posiela protokolové informácie do špecifikovanej výstupnej lokality. Nasledujúca tabuľka poskytuje zoznam všetkých pripájačov, ktoré sa používajú v súbore log4j.properties spolu so stručnými popismi a súvisiacimi voľbami.
Pripájač | Popis a kódové fragmenty |
---|---|
NTEventLogAppender | Pripája sa k protokolu udalostí Microsoft Windows NT. Tento pripájač možno nainštalovať a používať len na systéme Windows.
|
ConsoleAppender | Pripája správy protokolu k toku System.out (predvolené) alebo System.err pomocou rozloženia špecifikovaného užívateľom.
Voľby:
|
FileAppender | Pripája správy protokolu do súboru.
Voľby:
|
RollingFileAppender | Rozširuje FileAppender na zálohovanie protokolových súborov, keď dosiahnu určitú veľkosť.
Voľby:
|
V súbore log4j.properties môžete nastaviť rôzne rozloženia, ktoré špecifikujú formát správy protokolu. Môžete určiť, že správa protokolu má obsahovať dátum, čas, názov modulu, názov vlákna a ďalšie informácie. Tieto konfiguračné nastavenia sa použijú v čase vykonávania, keď sa protokoluje správa.
Nasledujúca tabuľka poskytuje zoznam všetkých rozložení, ktoré sa používajú v súbore IBM Enterprise Records log4j.properties spolu so stručnými popismi volieb.
Rozloženie | Popis a kódový fragment |
---|---|
SimpleLayout | Zobrazí úroveň, potom pomlčku (-) a za ňou text správy protokolu.
|
PatternLayout | Formátuje udalosti protokolovania podľa špecifikovaného vzoru konverzie. Vzory konverzie sú zložené z textu literálu a špecifikátorov konverzie. Text literálu je výstup tak ako je. Špecifikátory konverzie sa skladajú zo znaku %, za ktorým nasleduje voliteľný modifikátor formátu a povinný konverzný znak. Napríklad %-5p [%t]: %m%n je vzor konverzie zložený zo špecifikátora konverzie priority, za ktorým nasleduje text literálu " [". Za týmto reťazcom nasleduje špecifikátor konverzie vlákna a za ním text literálu "]: ". Za týmto reťazcom nasleduje špecifikátor konverzie správy a oddeľovač riadka závislý od systému.
Voľby:
|
HTMLLayout | Formátuje výstup ako tabuľku HTML.
Voľby:
|
Formátuje výstup ako XML.
Voľby:
|
Súbor log4j.properties dodaný s IBM Enterprise Records používa PatternLayout pre formát správy protokolu. Nasledujúca tabuľka poskytuje zoznam vzorov konverzie, ktoré môžu byť deklarované v konfiguračnom súbore spolu s ich stručnými popismi:
Vzor | Popis |
---|---|
%t | Názov vlákna, ktoré urobilo požiadavku na protokolovanie |
%c | Názov zapisovača priradeného k požiadavke protokolovania |
%-60c | Názov zapisovača zarovnať doľava v rozsahu minimálne 60 odsadení |
%r | Počet milisekúnd uplynutých od spustenia aplikácie |
%p | Úroveň príkazu protokolovania |
%m | Správa |
%Time | Čas kedy došlo k protokolovaniu |
%d | Dátum udalosti protokolovania |
%n | Nový riadok |
Nasledujúci kódový príkaz ukazuje ako povoliť PatternLayout a špecifikovať jednoduchý vzor konverzie:
log4j.appender.APILOG.layout=org.apache.log4j.PatternLayout
log4j.appender.APILOG.layout.ConversionPattern=%-5p %d {dd MMM rrrr HH:mm:ss,SSS},
-%m, %r, [%M] % n
Napríklad:
WARN, 20 Jun 2005 14:48:20,900, -[enter] getObjectStoreXML(ObjectStores),
102042, [setLoggerMessage]
WARN, 20 Jun 2005 14:48:21,100, -[exit] getObjectStoreXML(ObjectStores),
102342, [setLoggerMessage]