L'application IBM® Enterprise Records comporte un exemple de fichier log4j.properties que vous pouvez configurer.
Le fichier log4j.properties se situe dans le dossier chemin_install_ier\ RecordsManagerSweep, et vous pouvez configurer le comportement de consignation en indiquant des valeurs pour les éléments suivants dans le fichier :
Chaque consignateur du fichier log4j.properties possède un niveau spécifique. Si vous n'affectez pas de niveau à un consignateur, log4j lui attribue automatiquement le niveau du consignateur parent. Le niveau attribué par défaut est WARN.
Vous pouvez configurer le fichier log4j.properties avec différentes valeurs de paramètre logger, appender et layout. Le fichier log4j.properties doit être disponible pour l'application au moment de l'exécution dans le chemin d'accès aux classes. Vous pouvez mettre en commentaire les entrées du fichier exemple en faisant précéder une instruction du symbole dièse (#). Les entrées marquées du symbole dièse ne sont pas exécutées.
Pour ouvrir le fichier log4j.properties, accédez au dossier chemin_install_ier\RecordsManagerSweep, puis ouvrez le fichier à l'aide d'un éditeur de texte.
Vous devez tout d'abord définir le consignateur. Vous disposez pour cela d'un certain nombre de consignateurs permettant de classer les types de consignation nécessaires pour l'application. Pour activer la consignation pour toutes les classes de com.filenet.rm et de ses sous-packages, définissez le consignateur comme indiqué dans l'instruction suivante :
log4j.logger.com.filenet.rmor
Vous pouvez donner le nom de votre choix au consignateur. Par exemple, vous pouvez l'appeler APILOG comme indiqué dans l'instruction suivante :
log4j.logger.com.filenet.rm=warn, APILOG
Vous devez définir un niveau de consignation afin de définir le niveau détaillé des messages enregistrés par log4j lors de l'exécution. log4j prend en charge cinq niveaux normaux de consignation comme indiqué dans le tableau ci-après.
Niveau | Description |
---|---|
DEBUG | Désigne les événements d'information à granularité fine qui sont les plus utiles pour déboguer une application. |
INFO | Désigne les messages d'information qui mettent en évidence la progression de l'application à un niveau de granularité non fine. |
WARN | Désigne les situations potentiellement préjudiciables. |
ERROR | Désigne les événements d'erreur qui peuvent malgré tout ne pas entraver la poursuite de l'exécution de l'application. |
FATAL | Désigne les événements d'erreur très graves qui devraient conduire à l'arrêt de l'application. |
Pour plus d'informations sur les niveaux de consignation spéciaux et personnalisés, consultez la documentation log4j sur le site Web Apache. Par défaut, l'application commence au niveau WARN. Ce niveau peut ensuite être remplacé par le niveau DEBUG, INFO, ERROR, WARN ou FATAL au moment de l'exécution. Vous pouvez également inclure plusieurs instructions logger, chacune se rapportant au même consignateur mais indiquant différents niveaux (par exemple, DEBUG pour l'une, WARN pour l'autre). Vous pouvez mettre en commentaire une ou plusieurs instructions du fichier exemple en les faisant précéder du symbole dièse (#) pour passer du niveau DEBUG au niveau WARN et vice versa. Les entrées marquées du symbole dièse ne sont pas exécutées. Un consignateur ne possédant pas de niveau défini hérite automatiquement du niveau de son consignateur parent. Par défaut, c'est le niveau WARN qui est affecté au consignateur API RM dans IBM Enterprise Records.
Un consignateur est associé à un ou plusieurs ajouteurs (paramètre appender) afin de permettre l'inscription de ses messages de journal sur un support de sortie. Vous pouvez définir différents types d'ajouteur dans le fichier log4j.properties qui envoie les informations de consignation vers l'emplacement de sortie spécifié. Le tableau suivant fournit une liste de tous les ajouteurs utilisés dans le fichier log4j.properties, ainsi qu'une brève description accompagnée des options possibles.
Ajouteur | Description et fragments de code |
---|---|
NTEventLogAppender | Ajoute les données au journal des événements Microsoft Windows NT. Cet ajouteur ne peut être installé et utilisé que sur un système Windows. log4j.appender.APILOG=org.apache.log4j.nt.NTEventLogAppender |
ConsoleAppender | Ajoute les messages de journal au flux System.out (par défaut) ou System.err à l'aide du format spécifié par l'utilisateur. log4j.appender.APILOG=org.apache.log4j.ConsoleAppender Options :
|
FileAppender | Ajoute les messages de journal à un fichier. log4j.appender.APILOG=org.apache.log4j.FileAppender Options :
|
RollingFileAppender | Extension du paramètre FileAppender qui permet de sauvegarder les fichiers journal lorsqu'ils atteignent une certaine taille. log4j.appender.APILOG=org.apache.log4j.RollingFileAppender Options :
|
Vous pouvez définir différents agencements dans le fichier log4j.properties afin de définir le format du message de journal. Vous pouvez spécifier que les messages de journal devront inclure la date, l'heure, le nom de module, le nom d'unité d'exécution, etc. Ces paramètres de configuration sont utilisés en cours d'exécution lors de la consignation du message.
Le tableau suivant fournit une liste de tous les agencements utilisés dans le fichier log4j.properties IBM Enterprise Records, ainsi qu'une brève description accompagnée des options possibles.
Format | Description et fragments de code |
---|---|
SimpleLayout | Imprime le niveau, puis un tiret (-) suivi du texte du message de journal. org.apache.log4j.SimpleLayout |
PatternLayout | Formate les événements du journal en fonction d'un modèle de conversion défini. Les modèles de conversion se composent de texte littéral et d'indicateurs de conversion. Le texte littéral est présenté tel quel en sortie. Les indicateurs de conversion se composent du caractère % suivi d'un modificateur de format facultatif et d'un caractère de conversion obligatoire. Par exemple, %-5p [%t]: %m%n est un modèle de conversion composé d'un indicateur de conversion de priorité suivi du texte littéral [, d'un indicateur de conversion d'unité d'exécution, du texte littéral ]:, d'un indicateur de conversion de message, et enfin d'un séparateur de ligne dépendant du système. org.apache.log4j.PatternLayout Options :
|
HTMLLayout | Formate la sortie sous forme de tableau HTML. org.apache.log4j.HTMLLayout Options :
|
Génère une sortie au format XML. org.apache.log4j.xml.XMLLayout Options :
|
Le fichier log4j.properties fourni avec IBM Enterprise Records utilise le paramètre PatternLayout comme format de message de journal. Le tableau suivant fournit une liste des modèles de conversion pouvant être déclarés dans le fichier de configuration, ainsi qu'une brève description.
Modèle | Description |
---|---|
%t | Nom de l'unité d'exécution qui effectue la requête de consignation |
%c | Nom du consignateur associé à la requête de consignation |
%-60c | Justification à gauche du nom du consignateur avec un espace de 60 caractères au minimum |
%r | Nombre de millisecondes écoulé depuis le démarrage de l'application |
%p | Niveau de l'instruction de consignation |
%m | Message |
%Time | Heure de début de la consignation |
%d | Date de l'événement de consignation |
%n | Nouvelle ligne |
L'instruction de code suivante indique comment activer PatternLayout et spécifier un modèle de conversion simple :
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
Par 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]