Kit de herramientas de registro JRas

El kit de herramientas de registro JRas proporciona información que ayuda al administrador a diagnosticar problemas o ajustar el rendimiento de las aplicaciones.

Deprecated feature Deprecated feature: La infraestructura JRas que se describe en esta tarea y sus subtareas ha caído en desuso. No obstante, puede conseguir resultados parecidos utilizando el registro cronológico de Java™.depfeat

El desarrollo, despliegue y mantenimiento de aplicaciones son tareas complejas. Por ejemplo, cuando una aplicación en ejecución se encuentra con una situación imprevista, es posible que no puede finalizar una operación solicitada. En estos casos, la aplicación deberá indicar al administrador que la operación no se ha realizado correctamente y proporcionar información al respecto. Esta acción permite al administrador llevar a cabo la acción adecuada para corregir el problema. Aquellos que desarrollen o mantengan aplicaciones deben reunir información detallada relativa a la ruta de una aplicación en ejecución para determinar la causa raíz de un error derivado de un defecto en el código. Los recursos que se utilizan con este fin se conocen normalmente como anotaciones de mensajes y rastreo de diagnóstico.

Las anotaciones de mensajes (mensajes) y el rastreo de diagnóstico (rastreo) son bastante similares conceptualmente, pero hay diferencias importantes. Es importante que los desarrolladores de aplicaciones comprendan estas diferencias para utilizar correctamente estas herramientas. Para comenzar, se proporcionan las siguientes definiciones operativas de los mensajes y el rastreo.

Message
Una entrada de mensaje es un registro informativo concebido para que lo vean usuarios finales, administradores del sistema y personal de soporte. El texto del mensaje debe ser claro, conciso e interpretable. Los mensajes suelen estar localizados, es decir, se muestran en el idioma nacional del usuario final. Aunque el destino y el tiempo de vida de los mensajes se pueden configurar, en la operativa habitual del sistema siempre está habilitado un determinado nivel de anotación de mensajes. La anotación de mensajes debe usarse con criterio, ya que están en juego aspectos de rendimiento y el tamaño del repositorio de mensajes.
Rastreo
Una entrada de rastreo es un registro de información concebido para los ingenieros de servicio o los desarrolladores. Este tipo de registro de rastreo puede ser considerablemente más complejo, con más texto y detalle que una entrada de mensaje. Las entradas de rastreo no suelen visualizarse en el idioma local. Las entradas de rastreo pueden ser considerablemente inescrutables, solamente comprensibles por el desarrollador o personal de servicio adecuado. En principio, las entradas de rastreo no se escriben durante la ejecución normal, pero se pueden habilitar según sea necesario para recabar información de diagnóstico.

WebSphere Application Server proporciona una API de rastreo de diagnóstico y anotaciones de mensajes que las aplicaciones pueden utilizar. Esta API está basada en el kit de herramientas de registro JRas autónomo que ha desarrollado IBM®. El kit de herramientas de anotaciones JRas autónomo es una colección de interfaces y clases que proporcionan primitivas de anotación de mensajes y rastreo de diagnóstico. Estas primitivas no están vinculadas a ningún producto ni plataforma determinados. El kit de herramientas de anotaciones JRas autónomo proporciona un soporte limitado, conocido normalmente como soporte de gestión de sistemas, que incluye el soporte de configuración de archivos de anotaciones cronológicas basado en archivos de propiedades.

Conforme a su diseño, el kit de herramientas de anotaciones JRas autónomo no contiene el soporte necesario para la integración con el entorno de ejecución de WebSphere Application Server ni para su uso en un entorno J2EE ( Java 2 Platform, Enterprise Edition). Para superar estas limitaciones, WebSphere Application Server proporciona un conjunto de clases de extensión que cubren estas deficiencias. Esta colección de clases de extensión se conoce como extensiones JRas. Las extensiones JRas no modifican las interfaces introducidas por el kit de herramientas de anotaciones JRas autónomo, sino que proporcionan las clases de implementación adecuadas. En la siguiente sección, se describe la estructura conceptual que introduce el kit de herramientas de anotación JRas. Se puede aplicar igualmente a las extensiones JRas.

Conceptos de JRas

La sección contiene una visión general básica de los conceptos y principios importantes que introduce el kit de herramientas de anotaciones JRas autónomo. Esta información no ofrece una visión general completa de todas las posibilidades de este kit de herramientas de anotaciones ni tampoco pretende ser una descripción detallada de los paradigmas de uso o programación. Puede obtener información más detallada y ejemplos de código en el tema Extensiones JRas y sus subtemas, incluida la documentación del API de las diferentes interfaces y clases que componen el kit de herramientas de anotaciones.

Tipos de sucesos
El kit de herramientas de anotaciones JRas autónomo define un conjunto de tipos de suceso para los mensajes y establece un conjunto de tipos de suceso para el rastreo. Por ejemplo, los mensajes son de tipo informativo, de aviso y de error. Entre los ejemplos de tipo de rastreo cabe mencionar entrada, salida y rastreo.
Clases de sucesos
El kit de herramientas de anotaciones JRas autónomo define clases de sucesos de mensajes y de rastreo.
Registradores
Un registrador es el objeto principal con el que interactúa el código de usuario. Se definen dos tipos de registradores: registradores de mensajes y registradores de rastreo. Los conjuntos de métodos de los registradores de mensajes y de los registradores de rastreo son diferentes, ya que proporcionan funciones diferentes. Los registradores de mensajes solo crean registros de mensajes y los registradores de rastreo solo crean registros de rastreo. Ambos tipos de registradores contienen máscaras que indican las categorías de sucesos que procesa el registrador y las que ignora. Aunque cada registrador JRas está definido para contener tanto una máscara de mensaje como una máscara de rastreo, el registrador de mensajes solo utiliza la máscara de mensajes y el registrador de rastreo solo utiliza la de rastreo. Por ejemplo, si se establece una máscara de mensaje de un registrador de mensajes al estado adecuado, se puede configurar de modo que solo procese los mensajes de error e ignore los mensajes informativos y de aviso. El cambio del estado de la máscara de rastreo de un registrador de mensajes no tiene ningún efecto.

Un registrador contiene uno o varios manejadores a los que remite los sucesos para su proceso posterior. Cuando el usuario llama un método del registrador, este compara el tipo de suceso especificado por el llamante con el valor de la máscara en ese momento. Si el tipo especificado pasa la comprobación de la máscara, el registrador crea un objeto de suceso para capturar la información relacionada con el suceso pasado al método del registrador. Esta información puede incluir, por ejemplo, los nombres de la clase y el método que anota el suceso, un mensaje y los parámetros que se vayan a anotar, entre otros datos. Cuando el registrador crea el objeto de suceso, envía el suceso a todos los manejadores que están registrados en ese momento en el registrador.

Los métodos que se utilizan en la infraestructura de registro no hacen llamadas al método del registrador. Cuando una aplicación utiliza un objeto que extiende una clase de hilo, implementa el método hashCode y realiza una llamada a la infraestructura de registro desde ese método; el resultado es un bucle recursivo.

Manejadores
Un manejador es una abstracción de un dispositivo de salida o consumidor de eventos. Un ejemplo puede ser un manejador de archivos que sabe cómo escribir un suceso en un archivo. El manejador también contiene una máscara que se utiliza para limitar aún más las categorías de sucesos que procesa el manejador. Por ejemplo, se puede configurar un registrador de mensajes para que pase sucesos de aviso y de error, pero se puede configurar un manejador asociado a dicho registrador de mensajes para que solamente pase los sucesos de error. Los manejadores también incluye formateadores, que el manejador invoca para dar formato a los datos del suceso pasado antes de escribirlo en el dispositivo de salida.
Formateadores
Los manejadores se configuran con formateadores, que saben cómo dar formato a determinados tipos de sucesos. Un manejador puede contener varios formateadores, cada uno de los cuales sabe cómo dar formato a una clase de suceso determinada. El manejador pasa el objeto de suceso al formateador que corresponda. El formateador devuelve la salida formateada al manejador que, a continuación, la escribe en el dispositivo de salida.

Icon that indicates the type of topic Concept topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=ctrb_jrasintro
File name: ctrb_jrasintro.html