Prise en charge de la consignation des événements de base communs pour les applications WebFacing

Exécution dans WebSphere Application Server

Les applications WebFacing utilisent la consignation des événements de base communs WebSphere Application Server pour diagnostiquer les problèmes liés aux applications d'exécution. Lorsque vous exécutez une application WebFacing sur un serveur d'applications, les informations consignées sont envoyées par défaut à la console du serveur d'applications. Pour plus d'informations sur la consignation et le tracage dans WebSphere Application Server, voir le centre d'information pour votre niveau de WebSphere Application Server, par exemple, http://publib.boulder.ibm.com/infocenter/wasinfo/v8r0/index.jsp?topic=/com.ibm.websphere.nd.multiplatform.doc/info/ae/ae/ttrb_addtrace.html.

Vous pouvez configurer le niveau de consignation dans le consignateur de l'application WebFacing (com.ibm.etools.iseries.webfacing.nom_racine_contexte) à l'aide de la console d'administration de WebSphere Application Server. Pour plus d'informations sur la configuration du consignateur, voir le Centre de documentation associé à votre niveau de WebSphere Application Server et recherchez Configuration des propriétés du consignateur à l'aide de la console d'administration.

Vous pouvez également configurer le niveau de détails du consignateur, ainsi que d'autres paramètres du consignateur d'applications WebFacing à l'aide du fichier de configuration webfacinglogging.properties.

Par défaut, le message de consignation de WebSphere Application Server est écrit sur la console du serveur d'applications, et l'enregistrement de journal écrit dans le fichier activity.log de WebSphere Application Server. Si vous activez le traçage via la console d'administration du serveur d'applications, les informations de trace sont écrites dans le fichier trace.log de l'instance du serveur d'applications. Lorsque le traçage est activé, tous les messages de consignation sont consignés dans le fichier trace.log au format texte brut. Tous les enregistrements de journal dotés du niveau de consignation CONFIG et supérieur sont également consignés dans le fichier activity.log au format Common Base Event. Pour plus d'informations sur l'activation du traçage de WebSphere Application Server, voir le centre de documentation associé à votre niveau de WebSphere Application Server et recherchez Activation du traçage au démarrage du serveur.

Vous pouvez également configurer les paramètres des applications WebFacing pour séparer les informations de consignation et de traçage de l'exécution en différents fichiers au sein du système sur lequel votre serveur d'applications est exécuté. Les enregistrements de journal dont le niveau de consignation est supérieur ou égal à CONFIG sont écrits dans un fichier de consignation, ainsi que dans un fichier de trace si le traçage est activé pour ce consignateur. Les enregistrements de trace dont le niveau de consignation est inférieur à CONFIG sont écrits dans un fichier de trace. Pour connaître les propriétés qui activent cette fonction, voir la section Paramètres de configuration des applications WebFacing ci-dessous.

Les fichiers journaux et de trace sont organisés par session HTTP. Le nom du fichier journal est ID_session.log, où ID_session représente l'ID de la session du navigateur qui accède à l'application WebFacing. De la même manière, le nom du fichier de trace est ID_session.trace. Le fichier journal lié à une application WebFacing est écrit dans un répertoire portant le même nom que le nom de racine contextuel du projet Web qui contient l'application WebFacing. Pour plus d'informations sur la configuration de l'emplacement des fichiers journaux et de trace WebFacing, voir la propriété logFileLocation dans la section Paramètres de configuration des applications WebFacing ci-après.

Pour plus d'informations sur l'utilisation d'Agent Controller pour IBM® i, voir :

Si vous souhaitez seulement consulter le texte du message de votre enregistrement de journal, configurez les paramètres de sorte que l'enregistrement de journal soit écrit sous la forme d'une chaîne brute. Pour plus d'informations sur le contrôle du format de votre enregistrement de journal d'événement de base commun, voir la propriété useXMLFormatForCBELogging dans la section Paramètres de configuration des applications WebFacing.

Paramètres de configuration des applications WebFacing

Le fichier webfacinglogging.properties, situé au chemin WebContent/WEB-INF/classes du projet Web WebFacing, permet de configurer les paramètres de consignation et de trace de l'application WebFacing. Voici les paramètres de ce fichier.

# Contrôle le niveau de consignation d'exécution
# Les niveaux, par ordre décroissant, sont les suivants :
#   SEVERE (valeur la plus élevée)
#   WARNING
#   INFO
#   CONFIG
#   FINE
#   FINER
#   FINEST (valeur la plus faible)
# Il existe en outre le niveau OFF qui permet de désactiver la consignation
# et le niveau ALL qui permet d'activer la consignation ou le traçage de tous les messages.
# Pour plus d'informations, voir la classe java.util.logging dans la documentation Java.
# Les niveaux supérieurs ou égaux à CONFIG sont considérés comme des niveaux de consignation.
# Les niveaux inférieurs à CONFIG sont considérés comme des niveaux de traçage.
# Le niveau par défaut est SEVERE.
com.ibm.etools.iseries.webfacing.level=SEVERE

# Contrôle si le niveau de consignation défini dans ce fichier remplace
# les paramètres de configuration statistiques des niveaux de détails du journal dans WAS
# Les valeurs correctes sont :
#     true  - par défaut
#     false
com.ibm.etools.iseries.webfacing.overrideAdminLevelSetting=true

# Contrôle le répertoire dans lequel les fichiers journaux et les fichiers de trace sont écrits.
# Un sous-répertoire portant le même nom que l'app-web est créé
# pour stocker tous les fichiers journaux et de traces d'une application Web spécifique.
# Cette valeur est utilisée lorsque la propriété "logToFile" est définie sur "true".
# "%WASTraceDir" - répertoire de trace de l'instance de serveur WAS.
#                  Il s'agit de la variable SERVER_LOG_ROOT définie par défaut
#                  sur le serveur WAS. Cette valeur est utilisée comme valeur par défaut
#                  si l'application Web est exécutée dans un environnement WAS.
#                  Si elle n'est pas disponible, "%h/iserieslogs" est utilisé par
#                  défaut.
# "%h" - valeur de la propriété système "user.home"
#        "%h/iserieslogs" est utilisé comme valeur par défaut
# "%t" - valeur du répertoire temporaire du système
# "."  - valeur du répertoire WEB-INF
# "/" séparateur dans les noms de chemin locaux
#
# Exemple de chemin d'accès au poste de travail :
# "c:\\mon_répertoire\\mon_rép_journal"
# Veuillez noter qu'il faut utiliser ici une double barre oblique inversée.
#
# Exemple de chemin d'accès au système de fichier intégré pour iSeries
# "/home/mon_id/mon_rép_journal"
com.ibm.etools.iseries.webfacing.logFileLocation=%WASTraceDir

# Contrôle l'écriture des informations de consignation et de trace dans les fichiers.
# Les valeurs correctes sont :
#     true
#     false  - par défaut -- Dans ce cas, les informations sont écrites dans la console.
com.ibm.etools.iseries.webfacing.logToFile=false

# Contrôle l'utilisation du gestionnaire de sortie parent de ce consignateur.
# Si cette propriété est définie sur false, les informations de consignation et de trace
# ne sont pas écrites dans le fichier activity.log ou trace.log de WAS
# Les valeurs correctes sont :
#     true  - par défaut
#     false
com.ibm.etools.iseries.webfacing.useParentHandler=true

# Contrôle le format des enregistrements du journal Java écrits dans un fichier.
# Si cette propriété est définie sur true, les enregistrements du journal écrits dans
# le fichier journal sont au format XML.
# Voir la classe java.util.logging.XMLFormatter dans la documentation Java
# pour plus d'informations.
# Si cette propriété est définie sur false, les enregistrements du journal écrits dans
# le fichier journal se présente sous forme d'une chaîne de texte brut.
# Les valeurs correctes sont :
#     true  - par défaut
#     false
com.ibm.etools.iseries.webfacing.useXMLFormatForJSR47Logging=true

# Contrôle le format d'écriture des enregistrements de journal d'événement de base commun dans les fichiers.
# Si cette propriété est définie sur true, les enregistrements du journal écrits dans
# le fichier journal sont au format XML
# Common Base Event.  
# Si cette propriété est définie sur false, les enregistrements du journal écrits dans le fichier
# journal se présentent sous forme d'une chaîne de texte brut.
# Les valeurs correctes sont :
#     true  - par défaut
#     false
com.ibm.etools.iseries.webfacing.useXMLFormatForCBELogging=true

# Contrôle le nombre de fichiers journaux créés pour chaque application Web
# avant la suppression du fichier journal le plus ancien.
com.ibm.etools.iseries.maxlog=3
Remarque : Si le serveur d'applications est exécuté sur IBM i, il vous faudra peut-être affecter à ce répertoire les autorisations nécessaires à la création des fichiers journaux dans le système de fichiers installables. Dans le cas d'IBM WebSphere Application Server, vous devez accorder l'autorisation en écriture au profil utilisateur QEJBSVR. Le profil QEJBSVR, plus particulièrement, doit disposer des autorisations de lecture, d'écriture et d'exécution dans le répertoire de traces du tableau ci-dessus.