Journalisation et Trace
Le produit possède un composant de journalisation unifié qui traite les messages écrits par le produit et qui fournit un outil de diagnostic de premier niveau.
De plus, le composant de journalisation capture les messages qui sont écrits dans System.out, System.err, java.util.logging et les journaux OSGi. Il unifie le traitement de ces messages avec d'autres messages écrits par le produit. Il ne peut pas capturer les messages qui sont écrits directement par le processus de machine virtuelle Java, comme la sortie -verbose:gc.
- console.log - Ce fichier contient les flux de la sortie standard et de l'erreur standard redirigés du processus de machine virtuelle Java. Cette sortie de console est destinée à une utilisation humaine directe. Le composant de journalisation consigne les principaux événements dans le flux de sortie standard et les erreurs dans le flux d'erreur standard si vous utilisez la configuration consoleLogLevel par défaut. Il copie également les messages consignés dans le flux System.out vers le flux de sortie standard et les flux consignés dans le flux System.err vers le flux d'erreur standard si vous utilisez la configuration copySystemStreams par défaut. Les flux de sortie et d'erreur standard contiennent toujours des messages consignés directement par le processus de machine virtuelle Java (tels que les sorties -verbose:gc). Ce fichier n'est créé que si la commande server start est utilisée et son emplacement peut être modifié via la variable d'environnement LOG_DIR. Pour plus d'informations, voir Administration de Liberty depuis la ligne de commande.
- messages.log - Ce fichier contient tous les messages consignés ou capturés par le composant de journalisation. Tous les messages qui sont écrits dans ce fichier contiennent des informations supplémentaires, par exemple l'horodatage du message et l'ID de l'unité d'exécution à l'origine du message. Il ne contient pas les messages qui sont écrits directement par le processus de machine virtuelle Java.
- trace.log - Ce fichier contient tous les messages consignés ou capturés par le composant de journalisation ou par une trace supplémentaire. Il n'est créé que si vous activez la trace supplémentaire. Il ne contient pas les messages qui sont écrits directement par le processus de machine virtuelle Java.
Configuration de la journalisation
Attribut | Propriété équivalente | Description |
---|---|---|
logDirectory |
|
Vous pouvez utiliser cet attribut pour définir un répertoire pour tous les fichiers journaux, excepté le fichier
console.log, mais en incluant les journaux FFDC. Par défaut, logDirectory est associé à la variable d'environnement LOG_DIR. Le
chemin par défaut de la variable d'environnement
LOG_DIR est
WLP_OUTPUT_DIR/serverName/logs. Eviter les incidents : utilisez
la variable d'environnement LOG_DIR
ou la propriété com.ibm.ws.logging.log.directory
plutôt que l'attribut
logDirectory pour configurer le répertoire dans
lequel vous voulez que tous les messages soient écrits. Sinon, peu
de messages sont initialement écrits dans le répertoire
logs par défaut, puis les messages
restants sont écrits dans le répertoire indiqué en fonction de votre configuration. L'attribut
logDirectory peut être utilisé
pour mettre à jour de manière dynamique les journaux
dans le répertoire indiqué alors que le serveur est en cours
d'exécution.
|
|
|
Date et l'heure ou format de l'environnement local ou format ISO-8601. Vous pouvez spécifier la valeur
true ou false pour l'attribut ou la valeur de la propriété équivalente. La valeur par défaut est false. Si vous spécifiez la valeur true, le format ISO-8601 est utilisé dans le fichier messages.log, dans le fichier trace.log et dans les journaux de l'outil de diagnostic de premier niveau (FFDC). Le format est le suivant : aaaa-MM-jj'T'HH:mm:ss.SSSZ. Si vous spécifiez la valeur false, la date et heure suivent le format de l'environnement local défini sur le système. Si l'environnement local par défaut est introuvable, le format est le suivant : jj/MMM/aaaa HH:mm:ss:SSS z. |
maxFileSize |
|
Taille maximale (en mégaoctets) d'un
fichier journal avant le roulement. L'environnement d'exécution
Liberty procède au roulement des journaux en fonction de la
taille uniquement. Pour désactiver cet attribut, définissez la valeur 0. La taille de fichier maximale est approximative. Par
défaut, la valeur est 20. Remarque : maxFileSize ne s'applique pas au fichier
console.log.
|
maxFiles |
|
Si une taille de fichier maximale est appliquée, ce paramètre détermine combien de fichiers journaux de chaque type sont conservés. Ce paramètre s'applique également au nombre de journaux des exceptions qui récapitulent les exceptions survenues au cours d'un
jour donné. Par conséquent, si la valeur choisie est 10, le répertoire ffdc/ pourra
contenir jusqu'à 10 journaux de messages, 10 journaux de trace et
10 journaux récapitulatifs des exceptions. Par défaut, la valeur est 2. Remarque : maxFiles ne s'applique pas au fichier console.log.
|
consoleLogLevel |
|
Ce filtre contrôle la granularité des messages envoyés à la console. Les valeurs admises sont INFO, AUDIT, WARNING, ERROR et OFF. Par défaut, consoleLogLevel est défini sur la variable d'environnement WLP_LOGGING_CONSOLE_LOGLEVEL (si définie) ou sur AUDIT. |
copySystemStreams |
|
Si la valeur est true, les messages écrits dans les flux System.out et System.err sont copiés dans console.log. Si la valeur est false, ils sont écrits dans des journaux configurés tels que messages.log ou trace.log, mais ils ne sont pas copiés dans console.log. La valeur par défaut est true. |
messageFileName |
|
Le journal des messages porte le nom par défaut messages.log. Ce fichier existe toujours et contient les messages du niveau INFO et des autres niveaux (AUDIT, WARNING, ERROR, FAILURE), en plus des messages envoyés aux flux standard System.out et System.err. Ce journal contient également des horodatages et l'ID de l'unité d'exécution émettrice. Si le fichier journal est substitué, les noms de fichiers journaux antérieures ont le format messages_horodatage.log |
suppressSensitiveTrace | La trace de serveur risque d'exposer des données sensibles lors du suivi de données sans type, tels les octets reçus via une connexion réseau. Si sa valeur est true, cet attribut empêche l'exposition des informations potentiellement sensibles dans les fichiers journaux et de trace. La valeur par défaut est false. | |
traceFileName |
|
Le fichier trace.log est seulement créé si la trace supplémentaire ou détaillée est activée. stdout est considéré comme une valeur spéciale qui a pour effet de diriger la trace vers le flux de sortie standard d'origine. |
traceSpecification |
|
La chaîne de trace est utilisée pour activer la trace de façon sélective. La valeur par défaut est *=info. |
traceFormat |
|
Cet attribut contrôle le format du journal de trace. Le format par défaut pour Liberty est ENHANCED. Vous pouvez aussi utiliser les formats BASIC et ADVANCED, comme dans le WebSphere Application Server Traditional. |
hideMessage |
|
Vous pouvez utiliser cet attribut pour configurer les messages que vous désirez masquer dans les fichiers console.log et message.log. Si les messages sont configurés pour être masqués, ils sont redirigés vers le fichier trace.log. |
![]() |
![]()
|
![]() |
![]() |
![]()
|
![]() |
![]() |
![]()
|
![]() |
![]() |
![]()
|
![]() |
<logging traceSpecification="*=audit:com.myco.mypackage.*=finest"/>
<component> = <level>
où <component> est le composant pour lequel définir un niveau de détail du journal et <level> est l'un des niveaux valides pour le consignateur (off, fatal, severe, warning, audit, info, config, detail, fine, finer, finest, all). Plusieurs spécifications de niveau de détail de journal doivent être séparées par deux points (:).
- *
- Indique tout le code traçable qui s'exécute sur le serveur d'application, y compris le code système produit et le code client.
- com.ibm.ws.*
- Spécifie toutes les classes dont le nom de package commence par com.ibm.ws.
- com.ibm.ws.classloader.JarClassLoader
- Spécifie uniquement la classe JarClassLoader.
Niveau de journalisation de la version 6 et des versions ultérieures | Contenu / Signification |
---|---|
off | La journalisation est désactivée. |
fatal | La tâche ne peut se poursuivre et le composant, l'application et le serveur ne fonctionnent pas. |
severe | La tâche ne peut se poursuivre mais le composant, l'application et le serveur fonctionnent toujours. Ce niveau peut également indiquer une erreur irrémédiable imminente. |
warning | Erreur potentielle ou imminente. Ce niveau peut également indiquer un incident progressif (par exemple, la perte éventuelle de ressources). |
audit | Evénement important qui affecte l'état du serveur ou les ressources |
info | Informations générales qui présentent la progression globale de la tâche |
config | Statut ou modification de la configuration |
detail | Informations générales qui détaillent la progression de la sous-tâche |
fine | informations de Trace - trace générale + valeurs d'entrée/de sortie et , de retour de la méthode |
finer | Informations de trace - trace détaillée |
finest | Informations de trace - Trace détaillée qui inclut les détails nécessaires au débogage des problèmes |
all | Tous les événements sont consignés. Si vous créez des niveaux personnalisés, le niveau all inclut ces niveaux, et peut fournir une trace plus détaillée que le niveau finest. |
com.ibm.ws.logging.max.file.size=1
com.ibm.ws.logging.max.files=3
com.ibm.ws.logging.console.log.level=OFF
com.ibm.ws.logging.message.file.name=loggingMessages.log
Le fichier console.log est réinitialisé lors du redémarrage
du serveur.- Sur les systèmes z/OS, le fichier console.log utilise la page de codes par défaut et tous les autres fichiers journaux utilisent le codage ISO8859-1 et sont balisés comme des fichiers texte avec ce codage. Si la fonction de conversion de page de codes automatique UNIX System Services (USS) de z/OS est active, vous pouvez utiliser des utilitaires de texte et des éditeurs standard pour afficher et gérer les fichiers de configuration. les fichiers journaux qui sont codés avec ISO8859-1.
![[18.0.0.1 and later]](../ng_v18001plus.gif)
- Pour définir messages.log au format JSON dans le fichier server.xml.
<logging messageFormat="json" messageSource="message,trace,accessLog,ffdc" />
- Pour définir la console au format JSON dans le fichier server.env.
WLP_LOGGING_CONSOLE_FORMAT=json WLP_LOGGING_CONSOLE_LOGLEVEL=info WLP_LOGGING_CONSOLE_SOURCE=message,trace,accessLog,ffdc
- Pour définir la console au format JSON dans le fichier bootstrap.properties.
com.ibm.ws.logging.console.format=json com.ibm.ws.logging.console.log.level=info com.ibm.ws.logging.console.source=message,trace,accessLog,ffdc