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 položek 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čit k vyřazení přidáním symbolu # jako předpony příkazu; položky označené symbolem # nebudou za běhu prováděny.
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.rmor
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 tabulce níže.
Ú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 | Označuje velmi závažné chybové události, u kterých se předpokládá, že povedou k předčasnému ukončení 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ý). Jeden nebo druhý pak v ukázkovém souboru můžete označovat k vyřazení, a to přidáním symbolu # jako předpony příkazu, a přepínat tak podle potřeby mezi úrovněmi DEBUG a WARN. Položky označené symbolem # nebudou za běhu prováděny. 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 RM 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. log4j.appender.APILOG=org.apache.log4j.nt.NTEventLogAppender |
ConsoleAppender | Zapisuje zprávy protokolu do proudu System.out (výchozí) nebo System.err na základě rozvržení určeného uživatelem. log4j.appender.APILOG=org.apache.log4j.ConsoleAppender Volby:
|
FileAppender | Zapisuje zprávy protokolu do souboru. log4j.appender.APILOG=org.apache.log4j.FileAppender Volby:
|
RollingFileAppender | Rozšiřuje protokolový soubor FileAppender tím, že soubory protokolu po dosažení určité velikosti zálohuje. log4j.appender.APILOG=org.apache.log4j.RollingFileAppender 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 atd. 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. org.apache.log4j.SimpleLayout |
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 (také označované jako úroveň), který je následován literálovým textem " [", specifikátorem převodu podprocesu, literálovým textem "]: ", specifikátorem převodu zprávy a oddělovačem řádků závislým na systému. org.apache.log4j.PatternLayout Volby:
|
HTMLLayout | Formátuje výstup jako tabulku HTML. org.apache.log4j.HTMLLayout Volby:
|
Formátuje výstup jako tabulku XML. org.apache.log4j.xml.XMLLayout 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]