Différents mécanismes permettent de consigner les messages d'exécution, en fonction du niveau du serveur sur lequel l'application est exécutée (voir le tableau ci-dessous).
Environnement de déploiement | Environnement | Prise en charge de la consignation |
---|---|---|
WebSphere Application Server version 6.0 ou suivante | Java Runtime Environment (JRE) 1.4.2 ou version ultérieure ; WAS comprend la prise en charge intégrée de la consignation des événements de base communs | Consignation des événements de base communs |
Lorsque vous exécutez une application IBM i 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 traçage dans WebSphere Application Server version 6.0, voir http://publib.boulder.ibm.com/infocenter/wsdoc400/index.jsp?topic=/com.ibm.websphere.iseries.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 version 6.0. Pour plus d'informations sur la configuration du consignateur, voir http://publib.boulder.ibm.com/infocenter/wsdoc400/index.jsp?topic=/com.ibm.websphere.iseries.doc/info/ae/ae/ttrb_configjavalog.html
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 version 6.0 est écrit sur la console du serveur d'applications, et l'enregistrement de journal écrit dans le fichier activity.log de WebSphere Application Server version 6.0. 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 dans WebSphere Application Server version 6.0, voir http://publib.boulder.ibm.com/infocenter/wsdoc400/index.jsp?topic=/com.ibm.websphere.iseries.doc/info/ae/ae/ttrb_entrss.html
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.
Si que 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.
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 statiques des niveaux de détails du journal dans WAS 6.0 # Ce paramètre est valide uniquement lors de l'exécution sous WAS 6.0 ou version ultérieure # Veuillez consulter la page suivante pour paramétrer les niveaux de détail du journal # dans la console d'administration WAS 6.0 : # http://publib.boulder.ibm.com/infocenter/wsdoc400/index.jsp?topic # =/com.ibm.websphere.iseries.doc/info/ae/ae/ttrb_configjavalog.html # 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-app/WEB-INF # "/" séparateur dans les noms de chemin locaux 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. # Ce paramètre est valide uniquement lors de l'exécution sous WAS 6.0 ou version ultérieure # 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 6.0 # 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. # Cette propriété est valide pour WAS 5.1.x exécuté sur JDK 1.4.2, # où les classes java.util.logging sont disponibles. # 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 # cette propriété est valide uniquement dans un environnement exécuté sur JDK 1.4, # mais dans lequel la prise en charge intégrée de CommonBaseEvent n'est pas disponible 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. # Cette propriété est valide pour WAS 6.0, lequel comporte # une prise en charge intégrée de la consignation Java d'événement de base commun. # 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. Utilisez l'analyseur de traces du journal fourni avec WDSC pour les afficher. # Pour plus d'informations, voir l'aide de l'analyseur de traces du journal dans WDSC. # 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