Jeu d'outils de consignation JRas

Le jeu d'outils de consignation JRas fournit des informations de diagnostic pour aider l'administrateur à diagnostiquer les incidents ou optimiser les performances de l'application.

Fonction obsolète Fonction obsolète: L'utilisation de la structure JRas décrire dans cette tâche et ses sous-tâches est déconseillée. Toutefois, vous pouvez atteindre des résultats similaires à l'aide de la consignation Java™.depfeat

Le développement, le déploiement et la maintenance d'applications sont des tâches complexes. Par exemple, lorsqu'une application active est confrontée à une erreur imprévue, elle n'arrive pas toujours à exécuter l'opération demandée. Dans ce cas, vous souhaiterez certainement que l'application avertisse l'administrateur que l'opération a échoué et lui fournisse des informations. Cette action permet à l'administrateur de lancer l'intervention appropriée. Les développeurs et les personnes chargées de la maintenance d'applications ont généralement besoin de rassembler des informations détaillées relatives au chemin d'une application active pour déterminer la cause d'un incident lié à une erreur de code. Les fonctions utilisées à cet effet sont regroupées sous l'appellation consignation des messages et trace de diagnostic.

La consignation des messages (messages) et la trace de diagnostic (trace) sont presque similaires d'un point de vue conceptuel, mais présentent en fait de grandes différences. Il est essentiel que les développeurs d'applications comprennent bien ces différences pour utiliser correctement ces outils. Pour commencer, voici des définitions du fonctionnement des messages et de la fonction de trace.

Message
Une entrée de message est un enregistrement d'information que les utilisateurs finaux, les administrateurs système et le personnel de support peuvent visualiser. Le texte du message doit être clair, concis et compréhensible. Les messages sont généralement localisés, c'est-à-dire qu'ils s'affichent dans la langue de l'utilisateur final. Même si la destination et la durée de conservation des messages peuvent être configurables, un certain niveau de consignation des messages est toujours activé en mode opératoire normal. Le consignation de messages doit être utilisée à bon escient en tenant compte à la fois des performances et de la taille du référentiel de messages.
Trace
Une entrée de trace est un enregistrement d'information à l'usage des concepteurs et développeurs de service. Cet enregistrement de trace peut être beaucoup plus complexe, prolixe et détaillé qu'un enregistrement de message. En général, les entrées de trace ne sont pas localisées. Elles sont parfois quasiment incompréhensibles, sauf pour le développeur ou le personnel du service approprié. En principe, l'enregistrement des entrées de trace ne s'effectue pas au cours de l'exécution normale, mais peut être activé au besoin pour rassembler des informations de diagnostic.

WebSphere Application Server met à la disposition des applications une API de consignation de messages et de trace de diagnostic. Cette API est basée sur le jeu d'outils de développement de fonctions de consignation JRas autonome d'IBM®. Ce jeu d'outils de développement de fonctions de consignation JRas autonome est constitué d'une collection d'interfaces et de classes qui fournissent des primitives de consignation de messages et de trace de diagnostic. Ces primitives ne sont liées à aucun produit spécifique ou plateforme particulière. Le jeu d'outils de développement de fonctions de consignation JRas autonome offre un support limité, généralement appelé support de gestion de système, qui intègre le support de configuration des fichiers journaux d'après des fichiers de propriétés.

Selon sa conception, le jeu d'outils de développement de fonctions de consignation JRas autonome ne contient pas le support requis pour l'intégration au module d'exécution de WebSphere Application Server ou pour l'utilisation dans un environnement J2EE (Java 2 Platform, Enterprise Edition). Pour surmonter ces limites, WebSphere Application Server fournit une série de classes d'extension permettant de pallier ces inconvénients. Cette collection de classes d'extension est appelée extensions JRas. Les extensions JRas ne modifient pas les interfaces du jeu d'outils de développement de fonctions de consignation JRas autonome, mais fournissent les classes d'implémentation requises. La structure conceptuelle introduite par le jeu d'outils de développement de fonctions de consignation JRas autonome est décrite dans la section ci-après. Elle est également applicable aux extensions JRas.

Concepts JRas

Cette section présente les principaux concepts et constructions mis en oeuvre par le jeu d'outils de développement de fonctions de consignation JRas autonome. Ces informations ne constituent pas une description exhaustive des possibilités du jeu d'outils de consignation, ni une discussion détaillée sur l'emploi des paradigmes de programmation. Des informations plus détaillées, notamment des exemples de code, sont disponibles dans la rubrique Extensions JRas et ses sous-rubriques, y compris dans la documentation d'API des diverses interfaces et classes qui constituent le jeu d'outils de journalisation.

Types d'événements
Le jeu d'outils de journalisation JRas autonome définit une série de types d'événements pour les messages et une pour les traces. Par exemple, les messages d'information, d'avertissement et d'erreur constituent trois types de message différents. Les entrées, les exits et les traces constituent trois types de trace différents.
Classes d'événements
Le jeu d'outils de consignation JRas autonome définit à la fois les classes d'événement de trace et de message.
Programmes de consignation
Les programmes de consignation sont les principaux objets avec lesquels le code de l'utilisateur interagit. Il existe deux types de programme de consignation : les consignateurs de messages et les consignateurs de trace. Ces deux programmes fournissant des fonctions différentes, ils disposent de jeux de méthodes différents. Les programmes de consignation de messages ne créent que des enregistrements de message et les programmes de consignation de trace uniquement des enregistrements de trace. Les deux types de programme intègrent des masques qui indiquent les catégories d'événements que traite le programme et celles qu'il doit ignorer. Bien que chaque programme de consignation JRas soit défini de manière à contenir à la fois un masque de message et un masque de trace, le programme de consignation de messages n'utilise que le masque de message et le programme de consignation de traces celui de trace. Vous pouvez, par exemple, définir un masque de message pour un programme de consignation de messages de sorte que ce programme ne traite que les messages d'erreur et ignore les messages d'information et d'avertissement. Modifier l'état d'un masque de trace de programme de consignation de messages est sans effet.

Un programme de consignation contient un ou plusieurs gestionnaires vers lesquels il réachemine les événements en vue d'un traitement supplémentaire. Lorsque l'utilisateur appelle une méthode sur le programme de consignation, ce dernier compare le type d'événement indiqué par l'appelant avec la valeur en cours de son masque. Si le type indiqué est accepté après vérification avec le masque, le programme de consignation crée un objet événement pour capturer les informations relatives à l'événement transmis à la méthode du programme de consignation. Ces informations peuvent en inclure d'autres, telles que le nom de la classe et la méthode qui consigne l'événement, un message et les paramètres à consigner. Une fois que le programme de consignation a créé l'événement objet, il transmet ce dernier à tous les gestionnaires actuellement enregistrés auprès de lui.

Les méthodes utilisées dans l'infrastructure de consignation ne doivent pas appeler la méthode du programme de consignation. Lorsqu'une application utilise un objet qui étend une classe d'unités d'exécution, implémente la méthode hashCode et appelle l'infrastructure de consignation à partir de cette méthode, il en résulte une boucle récursive.

Gestionnaires
Les gestionnaires fournissent une abstraction sur une unité de sortie ou un client d'événement. Par exemple, un gestionnaire de fichiers qui sait comment écrire un événement dans un fichier. Le gestionnaire contient également un masque qui permet de limiter encore les catégories d'événement qu'il traite. Par exemple, un consignateur de messages peut être configuré pour transmettre à la fois des événements d'erreur et d'avertissement, alors qu'un gestionnaire associé à ce consignateur sera configuré pour ne transmettre que les événements d'erreur. Les gestionnaires intègrent aussi des programmes de formatage qu'ils appellent pour formater les données de l'événement transmis avant son écriture sur l'unité de sortie.
Programmes de formatage
Les gestionnaires sont configurés avec des programmes de formatage capables de formater certains types d'événements. Un gestionnaire peut contenir plusieurs programmes de formatage, chacun dédié au formatage d'une classe précise d'événements. Le gestionnaire transmet l'objet événement au programme de formatage approprié. Le programme de formatage renvoie la sortie formatée au manipulateur, qui l'écrit alors sur l'unité de sortie.

Icône indiquant le type de rubrique Rubrique de concept



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=ctrb_jrasintro
Nom du fichier : ctrb_jrasintro.html