Paramètres de niveau de journalisation

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 Résolution des incidents > Journaux et trace > nom serveur > Modifier les niveaux de détail de journalisation.

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.

Remarque : Cette rubrique fait référence à un ou plusieurs des fichiers journaux de serveur d'applications. Il est recommandé de configurer le serveur de telle sorte qu'il utilise l'infrastructure de journalisation et de trace HPEL (High Performance Extensible Logging) à la place des fichiers SystemOut.log, SystemErr.log, trace.log et activity.log sur les systèmes distribués et IBM® i. Vous pouvez également utiliser HPEL conjointement avec vos fonctions de journalisation z/OS natives. Si vous utilisez l'infrastructure HPEL, vous pouvez accéder à toutes les informations de journalisation et de trace en utilisant l'outil de ligne de commande LogViewer à partir de votre répertoire bin de profil de serveur. Pour plus d'informations sur l'utilisation de HPEL, voir les informations sur l'utilisation de HPEL en vue du traitement des incidents liés aux applications.
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>

<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 Eviter les incidents: Les clauses incluses dans la spécification de trace sont lues dans l'ordre dans lequel elles apparaissent dans la chaîne. Par conséquent, si plusieurs variantes de la clause *=info sont incluses dans une spécification de trace, la dernière valeur spécifiée est la valeur qui détermine le niveau de trace consigné par le système. Si vous indiquez *=info comme dernière clause, le traçage a lieu au niveau informations, quelles que soient les autres clauses spécifiées dans la chaîne de trace. Par exemple, si vous avez spécifié la chaîne de trace suivante :
*=info:PMGR=all:*=info:com.ibm.ws.sm.*=all  
cela revient à spécifier simplement :
*=all
En effet, la clause finale se substitue à toutes les clauses spécifiées précédemment dans la chaîne.gotcha
Les 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.*
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.

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.

Sélectionnez un composant ou un groupe en vue de définir un niveau de détail de journal. Le tableau suivant répertorie les niveaux valides pour les serveurs d'applications sur WebSphere Application Server version 6 et versions ultérieures.
Eviter les incidents Eviter les incidents: Les valeurs de niveau de consignation sont sensibles à la casse et commencent par une lettre minuscule.gotcha
Tableau 1. Niveaux de journalisation valides. Le tableau suivant répertorie les niveaux valides pour les serveurs d'applications sur WebSphere Application Server version 6 et versions ultérieures.
Niveau de journalisation de la version 6 et des versions ultérieures Contenu / Signification
désactivé 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 significatif affectant l'état du serveur ou les ressources
info Informations générales relatives à l'état d'avancement global de la tâche
config Statut ou modification de la configuration
detail Informations générales décrivant 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 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
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.
Lorsque vous activez un niveau de journalisation dans la version 6.0 ou les versions ultérieures, vous activez également tous les niveaux de gravité supérieurs. Par exemple, si vous définissez le niveau de journalisation avertissement sur votre serveur d'applications version 6.x, les événements de type avertissement, grave et fatal sont traités.

[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 la trace de 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électionnez Include 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 échéant.
Pratiques recommandées 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 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 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 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.

Icône indiquant le type de rubrique Rubrique de référence



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=utrb_loglevel
Nom du fichier : utrb_loglevel.html