Az IBM® Enterprise Records alkalmazás tartalmaz egy minta log4j.properties fájlt, melyet konfigurálhat.
A log4j.properties fájl az ier_telepítési_útvonal\ RecordsManagerSweep mappában található, és a fájlban található alábbi tulajdonságok értékének megadásával konfigurálhatja a naplózást:
A log4j.properties fájlban szereplő minden naplózóhoz szint van hozzárendelve. Ha nem rendel szintet egy naplózóhoz, akkor a log4j automatikusan hozzárendeli a szülő naplózó szintjét a hozzá nem rendelt naplózóhoz. Alapértelmezésben a FIGYELMEZTETÉS szint van a naplózókhoz rendelve.
A log4j.properties fájlt a naplózó (Logger), a hozzáfűző (Appender) és az elrendezés (Layout) különböző beállításaival konfigurálhatja. A log4j.properties fájlnak az osztályútvonalon kell rendelkezésre állnia az alkalmazás számára futás közben. A mintafájl bejegyzései megjegyzéssé alakíthatók a bejegyzéshez kettőskereszt (#) előtagot adva. Futás közben a rendszer kihagyja a kettőskereszt (#) szimbólummal jelölt bejegyzéseket.
A log4j.properties fájl megnyitásához nyissa meg az ier_telepítési_útvonal\RecordsManagerSweep mappát, majd nyissa meg a fájlt szövegszerkesztőben.
Először meg kell adnia a naplózót. Számos naplózó áll rendelkezésre az alkalmazáshoz szükséges naplózási típus osztályozásához. A com.filenet.rm és alcsomagjai összes osztályának naplózását a következő bejegyzésben módon engedélyezheti:
log4j.logger.com.filenet.rm
A naplózó számára tetszőleges nevet adhat meg. Például adhatja a naplózónak az APILOG nevet a következő bejegyzésben látható módon:
log4j.logger.com.filenet.rm=warn, APILOG
Meg kell adnia a log4j által futás közben rögzített üzenetek részletességi szintjét a naplózási szint megadásával. A log4j öt normál naplózási szintet támogat, ezek az alábbi táblázatban láthatók:
Szint | Leírás |
---|---|
DEBUG | A magas részletességű információs eseményeket gyűjti, melyek leginkább az alkalmazások hibakeresésekor hasznosak. |
INFO | Azokat az információs üzeneteket gyűjti, melyek kiemelik az alkalmazás előrehaladását egy kevésbé részletes szinten. |
WARN | A potenciálisan veszélyes helyzetekről tudósít. |
ERROR | Olyan hibaeseményekről tudósít, amelyek bekövetkezésekor még elképzelhető, hogy az érintett alkalmazás folytatni tudja a futást. |
FATAL | Az alkalmazás futásának befejezését okozó súlyos hibaeseményekről tudósít. |
A speciális s egyéni naplózási szintekről tekintse meg a log4j dokumentációját az Apache webhelyén. Alapértelmezésben az alkalmazás a WARN szinten fut. Ez a szint a DEBUG, INFO, ERROR, WARN és FATAL szintre módosítható futás közben. Megadhat több, naplózóra vonatkozó bejegyzést is, melyek ugyanazon naplózóra, de más szintre (például az egyik a DEBUG, a másik a WARN szintre) vonatkoznak. A mintafájl nem használt bejegyzéseit megjegyzéssé alakíthatja a bejegyzéshez kettőskereszt (#) előtagot adva. Ezután igény szerint válthat a DEBUG és a WARN szint között. Futás közben a rendszer kihagyja a kettőskereszt (#) szimbólummal jelölt bejegyzéseket. A szinttel nem rendelkező naplózók automatikusan szülőjük szintjét öröklik. Alapértelmezésben a WARN szint van hozzárendelve az API-naplózóhoz az IBM Enterprise Records programban.
A naplózók hozzáfűzőkhöz vannak társítva, melyek lehetővé teszik a naplóüzenetek kimeneti adathordozóra írását. A log4j.properties fájlban különféle hozzáfűzők adhatók meg, melyek a naplóinformációkat a megadott kimenet helyre küldik. A következő táblázatban látható lista a log4j.properties fájlban használt összes hozzáfűzőről, és egy rövid leírás, illetve a kapcsolódó beállítások is olvasható.
Hozzáfűző | Leírás és kódtöredékek |
---|---|
NTEventLogAppender | A Microsoft Windows NT Eseménynaplóhoz végez hozzáfűzést. Ez a hozzáfűző csak Windows rendszeren telepíthető és használható.
|
ConsoleAppender | A naplóüzeneteket a System.out (alapértelmezés) vagy a System.err adatfolyamhoz fűzi hozzá a felhasználó által megadott elrendezéssel.
Beállítások:
|
FileAppender | Naplóüzeneteket fűz a fájlhoz.
Beállítások:
|
RollingFileAppender | Úgy terjeszti ki a FileAppender hozzáfűzőt, hogy a naplófájlokról biztonsági mentést készítsen, ha azok elérnek egy adott méretet.
Beállítások:
|
A log4j.properties fájlban a naplóüzenetek formátumát meghatározó különböző elrendezéseket adhat meg. Megadhatja, hogy a naplóüzenet tartalmazza a dátumot, időt, modulnevet, szálnevet vagy más információkat. A konfigurációs beállításokat futás közben, az üzenet naplózásakor használja a program.
A következő táblázatban látható lista a IBM Enterprise Records log4j.properties fájljában használt összes elrendezésről, és egy rövid leírás, illetve a kapcsolódó beállítások is olvashatók.
Elrendezés | Leírás és kódtöredék |
---|---|
SimpleLayout | Kiírja a szintet, majd egy kötőjelet (-) ír, melyet a naplóüzenet szövege követ.
|
PatternLayout | A megadott átalakítási minta szerint formázza a naplózási eseményeket. Az átalakítási minták literális szövegből és átalakítási kulcsszavakból állnak. A literális szöveget a program szó szerint írja ki. Az átalakítási kulcsszavak a % karakterrel kezdődnek, ezt egy elhagyható formátummódosító követi, majd a kötelező átalakítási karakter zárja a kulcsszót. Például a %-5p [%t]: %m%n olyan átalakítási minta, melyben a prioritásátalakítási kulcsszót a " [" literális szöveg követi. Ezt a karaktersorozatot a szálátalakítási kulcsszó követi, mely mögött a "]: " literális szöveg áll. A karaktersorozatot üzenetátalakítási kulcsszó és egy rendszerfüggő sorelválasztó követi.
Beállítások:
|
HTMLLayout | A kimenetet HTML táblázatként formázza.
Beállítások:
|
A kimenetet XML-fájlként formázza.
Beállítások:
|
Az IBM Enterprise Records alkalmazáshoz biztosított log4j.properties fájl a PatternLayout naplóüzenet-formátumot használja. Az alábbi táblázatban található lista a konfigurációs fájlban deklarálható átalakítási mintákról, valamint ezek rövid leírása is olvasható:
Minta | Leírás |
---|---|
%t | A naplókérést küldő szál neve |
%c | A naplókéréshez társított naplózó neve |
%-60c | A naplózó nevének balra igazítása legalább 60 szóközön belül |
%r | Az alkalmazás indítása óta eltelt ezredmásodpercek száma |
%p | A naplóbejegyzés szintje |
%m | Üzenet |
%Time | A naplózás időpontja |
%d | A naplózási esemény dátuma |
%n | Új sor |
A következő kódbejegyzés mutatja be a PatternLayout engedélyezését, és egy egyszerű átalakítási minta megadását:
log4j.appender.APILOG.layout=org.apache.log4j.PatternLayout
log4j.appender.APILOG.layout.ConversionPattern=%-5p %d {nn HHH éééé ÓÓ:pp:mm,EEE},
-%m, %r, [%M] % n
Például:
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]