Aplikace IBM® Enterprise Records zahrnuje ukázkový souborlog4j.properties, který můžete nakonfigurovat.
Soubor log4j.properties se nachází ve složce ier_install_path\ RecordsManagerSweep. Způsob chování protokolování lze konfigurovat zadáním hodnot následujících vlastností v souboru:
Každému registrátoru v souboru log4j.properties je přiřazena úroveň. Pokud registrátoru není přiřazena úroveň, pak soubor log4j nepřiřazenému registrátoru automaticky přiřadí úroveň nadřízeného registrátoru. Při výchozím nastavení je registrátoru přiřazena úroveň WARN.
Soubor log4j.properties můžete nakonfigurovat s odlišnými nastaveními registrátoru, protokolového souboru a rozvržení. Soubor log4j.properties musí být k dispozici pro aplikaci za běhu z cesty třídy. Položky v ukázkovém souboru můžete označovat k vyřazení, a to přidáním znaku # jako předpony příkazu. Položky označené znakem # budou při spuštění přeskočeny.
Chcete-li soubor log4j.properties otevřít, přejděte do složky ier_install_path\RecordsManagerSweep a otevřete soubor v textovém editoru.
Nejprve je třeba nastavit registrátor. Lze určit více registrátorů, aby bylo možné klasifikovat typ protokolování požadovaný u dané aplikace. Chcete-li zapnout protokolování pro všechny třídy produktu com.filenet.rm i pro podřízené balíky, zadejte registrátor tak, jak je uvedeno v následujícím příkazu:
log4j.logger.com.filenet.rm
Pro registrátor můžete zadat jakýkoli název. Můžete jej pojmenovat například APILOG, jak je uvedeno v následujícím příkazu:
log4j.logger.com.filenet.rm=warn, APILOG
Je třeba nastavit úroveň protokolování, která určuje úroveň podrobností zpráv zaznamenávaných souborem log4j za běhu. Soubor log4j podporuje 5 normálních úrovní protokolování, jak je uvedeno v následující tabulce.
Úroveň | Popis |
---|---|
DEBUG | Označuje velmi podrobné informační události, které jsou nanejvýš užitečné pro ladění aplikace. |
INFO | Označuje informativní zprávy, které na méně podrobné úrovni zaznamenávají důležité kroky v průběhu aplikace. |
WARN | Označuje potenciálně škodlivé situace. |
ERROR | Označuje chybové události, které nemusejí nutně způsobit ukončení běhu aplikace. |
FATAL | Určuje závažné chybové události, které mohou způsobit zastavení aplikace. |
Další informace o speciálních a vlastních úrovní protokolování naleznete v dokumentaci souboru log4j na webovém serveru Apache. Při výchozím nastavení se aplikace spustí na úrovni WARN. Toto nastavení lze za běhu upravit na úroveň DEBUG, INFO, ERROR, WARN nebo FATAL. Můžete rovněž zahrnout několik příkazů registrátoru, všechny pro stejný registrátor, avšak s jinými úrovněmi (například DEBUG pro jeden, WARN pro druhý). Položky v ukázkovém souboru můžete označovat k vyřazení, a to přidáním znaku # jako předpony příkazu. Potom můžete podle potřeby přepínat mezi úrovněmi DEBUG a WARN. Položky označené znakem # budou při spuštění přeskočeny. Registrátor, kterému není přiřazena úroveň, automaticky dědí úroveň ze svého nadřízeného registrátoru. Při výchozím nastavení je registrátoru API v produktu IBM Enterprise Records přiřazena úroveň WARN.
Registrátor je přidružen k jednomu nebo více protokolovým souborům, které umožňují zapisování jeho zpráv protokolu na výstupní médium. V souboru log4j.properties, který odesílá informace protokolu do určeného výstupního umístění, můžete nastavit různé druhy protokolových souborů. Následující tabulka představuje seznam všech protokolových souborů, které se používají v souboru log4j.properties, doplněný o stručný popis a související volby.
Protokolový soubor | Popis a fragmenty kódu |
---|---|
NTEventLogAppender | Zapisuje do protokolu událostí systému Microsoft Windows NT. Tento protokolový soubor lze nainstalovat a používat pouze v systému Windows.
|
ConsoleAppender | Zapisuje zprávy protokolu do proudu System.out (výchozí) nebo System.err na základě rozvržení určeného uživatelem.
Volby:
|
FileAppender | Zapisuje zprávy protokolu do souboru.
Volby:
|
RollingFileAppender | Rozšiřuje protokolový soubor FileAppender tím, že soubory protokolu po dosažení určité velikosti zálohuje.
Volby:
|
V souboru log4j.properties lze nastavit různá rozvržení, která určují formát zprávy protokolu. Můžete určit, že zprávy protokolu mají zahrnovat datum, čas, název modulu, název podprocesu a další informace. Tato nastavení konfigurace se používají za běhu při protokolování zprávy.
Následující tabulka poskytuje seznam všech rozvržení používaných v souboru log4j.properties produktu IBM Enterprise Records, společně s krátkými popisy a volbami.
Rozvržení | Popis a fragment kódu |
---|---|
SimpleLayout | Vytiskne úroveň a poté pomlčku (-) následovanou textem zprávy protokolu.
|
PatternLayout | Formátuje události protokolování podle určeného vzorku převodu. Vzorky převodu se skládají z literálového textu a specifikátorů převodu. Literálový text je ve výstupu uveden v aktuální podobě. Specifikátory převodu se skládají ze znaku % následovaného volitelným modifikátorem formátu a povinným znakem převodu. Například %-5p [%t]: %m%n je vzorek převodu sestávající ze specifikátoru převodu priority, který je následován literálovým textem " [". Tento řetězec je následován specifikátorem převodu podprocesu a literálovým textem "]: ". Za ním následuje specifikátor převodu zprávy a oddělovač řádků závislý na systému.
Volby:
|
HTMLLayout | Formátuje výstup jako tabulku HTML.
Volby:
|
Formátuje výstup jako tabulku XML.
Volby:
|
Soubor log4j.properties, který je dodaný s produktem IBM Enterprise Records, používá pro formát zprávy protokolu rozvržení PatternLayout. Následující tabulka poskytuje seznam vzorků převodu, které lze deklarovat v konfiguračním souboru, společně s jejich krátkými popisy:
Vzorek | Popis |
---|---|
%t | Název podprocesu vytvářejícího požadavek na protokolování |
%c | Název registrátoru přidruženého k požadavku na protokolování |
%-60c | Zarovnání názvu registrátoru doleva, minimálně do 60 mezer |
%r | Počet milisekund uplynulých od spuštění aplikace |
%p | Úroveň příkazu protokolu |
%m | Zpráva |
%Time | Čas, kdy došlo k protokolování |
%d | Datum události protokolování |
%n | Nový řádek |
Následující kódový příkaz ukazuje, jak povolit rozvržení PatternLayout a zadat jednoduchý vzorek převodu:
log4j.appender.APILOG.layout=org.apache.log4j.PatternLayout
log4j.appender.APILOG.layout.ConversionPattern=%-5p %d {dd. MMM yyyy HH:mm:ss,SSS}, -%m, %r, [%M] % n
Například:
WARN, 20. čer 2005 14:48:20,900, -[enter] getObjectStoreXML(ObjectStores), 102042, [setLoggerMessage]
WARN, 20. čer 2005 14:48:21,100, -[exit] getObjectStoreXML(ObjectStores), 102342, [setLoggerMessage]