Programmes de consignation
Les programmes de consignation sont utilisés par les applications et les composants d'exécution pour capturer les événements de trace et de message.
Lorsque des événements importants se produisent, suite à un changement d'état, par exemple lorsque le démarrage d'un serveur a abouti ou lorsqu'un problème potentiel a été détecté, tel qu'un délai d'attente pour une ressource, un message est enregistré dans les journaux. Les événements de trace sont journalisés dans des scénarios de débogage où un développeur doit avoir une vision précise des événements qui se produisent dans chaque composant afin qu'il puisse identifier la cause de l'incident. Les événements journalisés sont souvent les seuls événements disponibles lorsqu'un problème est détecté et sont généralement utilisés lors de la résolution des problèmes et de la reprise après incident.
Les programmes de consignation sont organisés de manière hiérarchique. Chaque programme de consignation peut avoir plusieurs programmes de consignation enfant ou n'en avoir aucun.
Les programmes de consignation peuvent être associés à un regroupement de ressources. Si le regroupement de ressources est spécifié, il permet au programme de consignation de localiser les messages qui y sont journalisés. Si le regroupement de ressources n'est pas spécifié, un programme de consignation utilise le même regroupement de ressources que son parent.
Vous pouvez configurer les programmes de consignation avec un niveau. Si le niveau est spécifié, le programme de consignation le compare aux événements entrants. Les événements dont la gravité est inférieure au niveau défini pour le programme de consignation sont ignorés par ce dernier. Si le niveau n'est pas spécifié, un programme de consignation accepte le niveau utilisé par son parent. Le niveau par défaut des programmes de consignation est Level.INFO.
Les programmes de consignation peuvent ou non être associés à des gestionnaires. Si ces éléments sont indiqués, tous les événements journalisés dans le programme de consignation sont transmis aux gestionnaires associés. Les gestionnaires placent des événements dans des destinations de sortie, telles que des fichiers journaux ou des sockets réseau. Lorsqu'un programme de consignation a transmis un événement journalisé à l'ensemble des gestionnaires associés à ce programme de consignation, ce dernier transmet l'événement aux gestionnaires associés aux parents du programme de consignation. Ce processus s'arrête si un programme de consignation parent est configuré de manière à ce qu'il n'utilise pas les gestionnaires parent. Les gestionnaires de WebSphere Application Server sont associés au programme de consignation racine. Attribuez la valeur false à la propriété useParentHandlers du programme de consignation afin d'empêcher ce dernier d'inscrire des événements dans des gestionnaires situés à un niveau plus élevé de la hiérarchie.
Les programmes de consignation peuvent être associés à un filtre. S'il est indiqué, le filtre est appelé pour chaque événement entrant afin de préciser au programme de consignation s'il doit ou non l'ignorer.
Les applications interagissent directement avec les programmes de consignation afin de journaliser les événements. Afin d'obtenir ou de créer un programme de consignation, un appel de la méthode Logger.getLogger a été effectuée avec un nom pour le programme de consignation. Généralement, le nom du programme de consignation est soit le package, qualifié par le nom de classe, soit le nom de package utilisé pour le programme de consignation. L'espace de nom du programme de consignation hiérarchique est automatiquement créé en utilisant des points dans le nom du programme de consignation. Par exemple, le programme de consignation com.ibm.websphere.ras est associé à un programme de consignation parent com.ibm.websphere qui possède lui-même un parent com.ibm. Le parent situé en haut de la hiérarchie est désigné sous le nom de programme de consignation racine. Ce programme de consignation parent est créé lors de l'initialisation. Le programme de consignation racine est le parent du programme de consignation com.
Les programmes de consignation sont structurés dans une hiérarchie. Tous les programmes de consignation, à l'exception du programme de consignation racine, sont associés à un parent. Chaque programme de consignation peut avoir un ou plusieurs enfants. Il peut également ne pas en avoir. Un programme de consignation hérite les éléments suivants de son parent dans la hiérarchie : gestionnaires de journal, noms des regroupements de ressources et paramètres de filtrage d'événement. La hiérarchie du programme de consignation est gérée par la fonction LogManager.
Les programmes de consignation créent des enregistrements de journaux. Un enregistrement de journal est l'objet de conteneur des données d'un événement. Cet objet est utilisé par les filtres, les gestionnaires et les formateurs de l'infrastructure de la journalisation.
Le programme de consignation offre différents ensembles de méthodes pour la génération de messages de journaux. Pour certaines méthodes de journal, il suffit d'un seul niveau et d'informations pour créer un message. D'autres méthodes logp (journal précis) plus complexes prennent en charge l'appelant lors de la transmission des attributs du nom de la méthode et du nom de la classe ainsi que le niveau et les informations du message. Les méthodes logrb (journal avec regroupement de ressources) ajoute la fonction de spécification d'un regroupement de ressources ainsi que le niveau, les informations de message, le nom de classe et le nom de méthode. L'utilisation des méthodes, telles que severe, warning, fine, finer et finest permet de journaliser un message à un niveau particulier. Pour plus d'informations sur la consignation et sur la manière de l'utiliser dans l'application, voir Utilisation de la consignation Java dans une application. Pour une liste des méthodes complète, voir la documentation java.util.logging à l'adresse http://docs.oracle.com/javase/1.4.2/docs/api/index.html.