L'aplicació IBM® Enterprise Records inclou un fitxer log4j.properties d'exemple que es pot configurar.
El fitxer log4j.properties es troba a la carpeta dir_instal·lació_ier\RecordsManagerSweep i podeu configurar el comportament de registre especificant els valors al fitxer per al següent:
S'assigna un nivell a cada registrador del fitxer log4j.properties. Si no assigneu un nivell a un registrador, log4j assigna de forma automàtica el nivell del registrador pare al registrador sense assignar. Per defecte, s'assigna el nivell WARN (avís) a un registrador.
Podeu configurar el fitxer log4j.properties amb diferents paràmetres de registrador, afegidor i disseny. El fitxer log4j.properties ha d'estar disponible per a l'aplicació en temps d'execució a la variable classpath. Podeu comentar les entrades del fitxer d'exemple afegint com a prefix a la sentència un símbol de coixinet (#); les entrades marcades amb el símbol de coixinet (#) no s'executaran en temps d'execució.
Per obrir el fitxer log4j.properties, aneu a la carpeta camí_accés_instal·lació_ier\RecordsManagerSweep i, tot seguit, obriu el fitxer amb un editor de text.
Primer heu de definir el registrador. Podeu tenir diversos registradors per classificar el tipus de registre que us cal per a l'aplicació. Per habilitar el registre per a totes les classes de com.filenet.rm i els seus subpaquets, especifiqueu el registrador com es mostra a la sentència següent:
log4j.logger.com.filenet.rmor
Podeu especificar qualsevol nom per al registrador. Per exemple, podeu anomenar el registrador APILOG com es mostra a la sentència següent:
log4j.logger.com.filenet.rm=warn, APILOG
Heu de definir un nivell de registre per establir el nivell de detalls dels missatges registrats per log4j en temps d'execució. log4j admet cinc nivells normals de registre, com es mostra a la taula següent.
Nivell | Descripció |
---|---|
DEBUG | Designa les incidències informatives refinades que són les més útils per depurar una aplicació. |
INFO | Designa missatges informatius que ressalten el progrés de l'aplicació a un nivell no refinat. |
WARN | Designa situacions potencialment perjudicials. |
ERROR | Designa incidències d'error que permeten que l'aplicació continuï executant-se. |
FATAL | Designa incidències d'error molt greus que presumiblement faran que l'aplicació avorti l'operació. |
Consulteu la documentació de log4j al lloc web d'Apache per obtenir informació sobre nivells de registre especials i personalitzats. Per defecte, l'aplicació comença al nivell WARN. Això es pot modificar als nivells DEBUG, INFO, ERROR, WARN o FATAL en temps d'execució. També podeu incloure diverses sentències de registre, cadascuna per al mateix registrador però amb diferents nivells (com ara DEBUG per a un, WARN per a un altre). Podeu comentar-ne un o l'altre al fitxer d'exemple afegint com a prefix abans de la sentència un símbol de coixinet (#) i canvieu segons calgui entre els nivells DEBUG i WARN. Les entrades marcades amb un símbol de coixinet (#) no s'executaran en temps d'execució. Un registrador que no té un nivell hereta de forma automàtica el nivell del seu registrador pare. Per defecte, el nivell WARN s'assigna al registrador RM API a l'IBM Enterprise Records.
Un registrador s'associa amb un o més afegidors per permetre que els seus missatges de registres s'escriguin al suport de sortida. Podeu definir diferents tipus d'afegidors al fitxer log4j.properties que envia la informació de registre a la ubicació de sortida especificada. A la taula següent es proporciona una llista de tots els afegidors que s'utilitzen al fitxer log4j.properties i descripcions breus i opcions relacionades.
Afegidor | Descripció i fragments de codi |
---|---|
NTEventLogAppender | Afegeix al registre d'incidències del Microsoft Windows NT. Aquest afegidor només es pot instal·lar i utilitzar en un sistema Windows. log4j.appender.APILOG=org.apache.log4j.nt.NTEventLogAppender |
ConsoleAppender | Afegeix missatges de registre al corrent de System.out (valor per defecte) o de System.err amb un disseny especificat per l'usuari. log4j.appender.APILOG=org.apache.log4j.ConsoleAppender Opcions:
|
FileAppender | Afegeix missatges de registre a un fitxer. log4j.appender.APILOG=org.apache.log4j.FileAppender Opcions:
|
RollingFileAppender | Amplia FileAppender per fer una copia de seguretat dels fitxers de registre quan assoleixen una certa mida. log4j.appender.APILOG=org.apache.log4j.RollingFileAppender Opcions:
|
Podeu definir diferents dissenys al fitxer log4j.properties que especifiquin el format del missatge de registre. Podeu especificar que els missatges de registre incloguin la data, l'hora el nom del mòdul, el nom del fil, etc. Aquests paràmetres de configuració s'utilitzen en temps d'execució mentre es registra el missatge.
A la taula següent es proporciona una llista dels dissenys que s'utilitzen al fitxer log4j.properties de l'IBM Enterprise Records i descripcions breus i opcions relacionades.
Disseny | Descripció i fragment de codi |
---|---|
SimpleLayout | Imprimeix el nivell, seguit d'un guionet i, finalment, el text del missatge de registre. org.apache.log4j.SimpleLayout |
PatternLayout | Formata les incidències de registre segons un patró de conversió especificat. Els patrons de conversió consten de text literal i especificadors de conversió. El text literal es general tal qual. Els especificadors de conversió consten del caràcter % seguit d'un modificador de format opcional i un caràcter de conversió obligatori. Per exemple, %-5p [%t]: %m%n és un patró de conversió que consta d'un especificador de conversió de prioritat (també anomenada nivell) seguit del text literal " [", seguit per un especificador de conversió de fil, seguit del text literal "]: ", seguit d'un especificador de conversió de missatges i un separador de línies que depèn del sistema. org.apache.log4j.PatternLayout Opcions:
|
HTMLLayout | Formata la sortida com a taula HTML. org.apache.log4j.HTMLLayout Opcions:
|
Format la sortida com a XML. org.apache.log4j.xml.XMLLayout Opcions:
|
El fitxer log4j.properties que es proporciona amb l'IBM Enterprise Records utilitza PatternLayout per al format de missatge de registre. La taula següent proporciona una llista de patrons de conversió que es poden declarar en el fitxer de configuració i les seves descripcions breus:
Patró | Descripció |
---|---|
%t | Nom del fil que fa la sol·licitud de registre |
%c | Nom del registrador associat amb la sol·licitud de registre |
%-60c | Justifica a l'esquerra el nom del registrador dins un mínim de 60 espais |
%r | Nombre de mil·lisegons transcorreguts des de l'inici de l'aplicació |
%p | Nivell de la sentència de registre |
%m | Missatge |
%Time | Hora a la qual té lloc el registre |
%d | Data de la incidència de registre |
%n | Salt de línia |
La sentència de codi següent mostra com habilitar PatternLayout i especificar un patró de conversió senzill:
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
Per exemple:
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]