Cette rubrique permet de configurer et de gérer les paramètres de niveau de journalisation.
Pour afficher cette page de la console d'administration, cliquez sur .
Les niveaux de journalisation vous permettent de contrôler les événements traités par la journalisation Java. Lorsque vous modifiez le niveau d'un programme de consignation, la modification est propagée aux enfants du programme de consignation.
- Désactivation de la fonction de journalisation et de traçage des données potentiellement sensibles
- Le serveur d'applications comporte une liste de consignateurs connus pour écrire des données potentiellement sensibles dans les fichiers journaux et les fichiers de trace lorsqu'ils sont activés. Par exemple, le fait d'activer certains consignateurs liés à HTTP au niveau Le plus fin peut provoquer le stockage dans les fichiers de trace des informations confidentielles spécifiées par l'utilisateur émanant de demandes HTTP. Si vous souhaitez que le serveur évite d'activer ces consignateurs à des niveaux connus pour être utilisés pour des informations potentiellement sensibles, cochez la case Désactiver la journalisation et le traçage de données potentiellement sensibles. Lorsque le serveur est démarré, ou lorsque la spécification du niveau de détail de journalisation est modifiée lors de l'exécution, le serveur compare la liste de consignateurs et de niveaux dans la spécification du niveau de détail avec les consignateurs et les niveaux figurant dans la liste de consignateurs sensibles, et met à jour la spécification du niveau de détail, le cas échéant.
- Modifier les niveaux de détail du journal
Entrez un niveau de détail de journal définissant les composants, les packages ou les groupes à tracer. La chaîne de niveau de détail de journal doit respecter la grammaire particulière décrite dans cette rubrique. Vous pouvez entrer la chaîne de niveau de détail de journal directement ou générer celle-ci à l'aide de l'interface graphique de trace.
Si vous sélectionnez l'onglet Configuration et développez l'élément des composants et des groupes, une liste statique de composants, packages et groupes connus s'affiche. Cette liste n'est peut-être pas exhaustive.
Si vous sélectionnez l'onglet Exécution et développez l'élément des composants et des groupes, la liste des composants, packages et groupes s'affiche avec tous les composants enregistrés sur le serveur d'applications en cours d'exécution, ainsi que dans la liste statique.
Le format de la spécification de niveau de détail de journal est le suivant :<composant> = <niveau>
où <composant> correspond au composant pour lequel un niveau de détail de journal doit être défini, et <niveau> à l'un des niveaux de journal d'événements valides (désactivé, fatal, grave, avertissement, audit, info, config, détail, fin, plus fin, le plus fin, tous). Plusieurs spécifications de niveau de détail de journal doivent être séparées par deux points (:).
Eviter les incidents : ![[Mise à jour - Juin 2013]](../images/delta.gif)
Les clauses incluses dans une spécification de trace sont lues dans l'ordre où elles figurent dans la chaîne. Donc, si plusieurs variantes de la clause *=info sont incluses dans une spécification de trace, la dernière valeur spécifiée détermine le niveau de trace enregistré par le système. Si vous spécifiez en dernier la clause *=info, le traçage s'effectue au niveau info, quel que soient les autres clauses spécifiées dans la chaîne de trace. Ainsi, spécifier la chaîne :
équivaut à spécifier simplement :*=info:PMGR=all:*=info:com.ibm.ws.sm.*=all
, car la dernière clause prévaut sur toutes celles spécifiées précédemment dans la chaîne.*=all![[Mise à jour - Juin 2013]](../images/deltaend.gif)
gotchaLes composants correspondent aux modules et classes Java ou aux collections de modules Java. Utilisez un astérisque (*) comme caractère générique pour indiquer les composants qui comportent toutes les classes de tous les packages contenus par le composant spécifié. Par exemple :- *
- Désigne tout le code de trace qui est exécuté dans le serveur d'applications, y compris le code système du produit et le code du client.
- com.ibm.ws.*
- Désigne toutes les classes dont le nom de package commence par com.ibm.ws.
- com.ibm.ws.classloader.JarClassLoader
- Désigne la classe JarClassLoader uniquement.
Une erreur peut se produire lors de la définition d'une spécification de niveau de détail de journal à partir de la console d'administration si des éléments sont sélectionnés à la fois dans les listes Groupes et Composants. Dans certains cas, les éléments sélectionnés dans une liste sont perdus lors de l'ajout d'une sélection dans l'autre liste. Pour contourner ce problème, entrez la spécification de niveau de détail de journal directement dans la zone d'entrée du niveau de détail de journal.
Eviter les incidents : Les valeurs de niveau de consignation sont sensibles à la casse et commencent par une lettre minuscule.gotcha| 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 éventuelle ou imminente. Ce niveau peut également indiquer un incident progressif (par exemple, la perte éventuelle de ressources). |
| audit | Un événement majeur affecte l'état du serveur ou les ressources |
| info | Informations générales relatives à l'état d'avancement global de la tâche |
| config | Modification ou statut de configuration |
| detail | Informations générales relatives à l'état d'avancement des sous-tâches |
| fine | Informations de trace - Trace générale + valeurs d'entrée, de sortie et de retour de 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 |
| tout | Tous les événements sont consignés. Si vous créez des niveaux personnalisés, l'option Tous les éléments activés inclut ces niveaux et peut fournir une trace plus détaillée que l'option Le plus fin. |
[Journalisation en mode de base] Les informations de trace, qui sont des événements de niveau Fin, Plus fin et Le plus fin, ne peuvent être écrites que dans le journal de trace. Par conséquent, si vous n'avez pas activé la trace des diagnostics, la définition du niveau de détail de journal Fin, Plus fin ou Le plus fin n'a aucun effet sur les données journalisées.
- Corrélation
- Spécifiez les paramètres de corrélation à activer. Sélectionnez la case
à cocher permettant d'activer la corrélation de trace et de journal afin d'activer
la corrélation pour le serveur d'applications. Désélectionnez cette même case
à cocher afin de désactiver
la corrélation pour le serveur d'applications. SélectionnezInclude
request IDs in log and trace records, Include
request IDs in log and trace records and correlation log records,
ou Include request IDs in log and trace records, create
correlation log records, and capture data snapshots, le cas
le cas échéant.
Pratiques recommandées : Activez XCT pour inclure des ID de demande aux fichiers de journalisation et de trace lorsque vous souhaitez savoir quelles sont les entrées de journaux et de trace, parmi toutes les unités d'exécution et tous les processus de serveur d'applications, qui sont associées à la même demande. Les ID de demande sont uniquement enregistrés lorsque le mode de journalisation et de trace HPEL est utilisé et ils peuvent être visualisés ou utilisés pour le filtrage à l'aide de la commande
logViewer. bprac Pratiques recommandées : Activez XCT pour créer
des enregistrements de journal de corrélation lorsque vous souhaitez consigner la manière dont les demandes sont associées entre des unités d'exécution et des processus et voir des informations supplémentaires sur chaque demande.
L'activation de XCT en vue de créer des enregistrements de journal de corrélation pouvant avoir un impact significatif sur la performance de votre système, il est conseillé de l'utiliser dans des environnements de test et de développement.bprac Pratiques recommandées : Activez XCT pour capturer
des images instantanées de données lorsque vous souhaitez stocker des corps de demande et de réponse entiers dans le système de fichiers. L'activation de XCT en vue de capturer des images instantanées de données pouvant avoir un impact significatif sur la performance de votre système, il est conseillé de l'utiliser dans des environnements de test et de développement. XCT capture des images instantanées de données
pour des demandes et des réponses de message gérées par SIBus.bprac Eviter les incidents : Des images instantanées de données sont capturées et enregistrées dans le répertoire $SERVER_LOG_ROOT/snapdata.
Le serveur d'applications ne nettoie pas automatiquement les fichiers de ce répertoire. Vous devrez régulièrement supprimer les fichiers de ce répertoire lorsque la capture d'images instantanées de données est activée. Les images instantanées de données
stockent tout le contenu des demandes et des réponses et peuvent inclure des informations sensibles. Il est possible que cette option ne soit pas appropriée pour une utilisation dans un environnement de production.gotcha
- Enregistrer les modifications d'exécution dans la configuration également
- Indique que des modifications sont apportées à la fois à l'état dynamique du serveur en cours d'exécution et à la configuration du serveur et qu'elles prendront effet au redémarrage. Si cette case à cocher est désélectionnée, le serveur ne copie pas les paramètres dans la configuration du serveur.