Registro cronológico Java

El registro de Java™ es el kit de herramientas de registro que proporciona el paquete java.util.logging . El registro de Java proporciona una API de registro estándar para las aplicaciones.

El registro cronológico de mensajes (mensajes) y los rastreos de diagnóstico (rastreo) conceptualmente son similares pero tienen diferencias importantes. Es importante que los desarrolladores de aplicaciones comprendan estas diferencias para utilizar correctamente estas herramientas. Se proporcionan las siguientes definiciones operativas de los mensajes y el rastreo.

Mensaje
Una entrada de mensaje es un registro informativo diseñado para que los vean usuarios finales, administradores del sistema y personal de soporte. El texto del mensaje debe ser claro, conciso e interpretable por un usuario final. Generalmente, los mensajes se localizan y visualizan en el idioma nacional del usuario final. Aunque el destino y la duración de los mensajes se puede configurar, en el funcionamiento normal del sistema habilite un determinado nivel de registro cronológico de mensajes. Utilice el registro cronológico de mensajes con criterio, debido a las consideraciones de rendimiento y al tamaño del repositorio de mensajes.
Rastreo
Una entrada de rastreo es un registro de información diseñado para los técnicos de servicio o los desarrolladores. Este tipo de registro de rastreo puede ser considerablemente más complejo, con más texto y más verboso que una entrada de mensaje. Las entradas de rastreo no suelen visualizarse en el idioma local. Es posible que las entradas de rastreo solamente pueda analizarlas y comprenderlas el personal de desarrollo o de servicio técnico. Se presupone que las entradas de rastreo no se graban durante la ejecución normal, pero se pueden habilitar según sea necesario para reunir información de diagnóstico.

El servidor de aplicaciones redirige las corrientes de datos del sistema en el arranque del servidor. No existe ningún método para permitir a la aplicación que anote cronológicamente la salida en la consola, porque la aplicación no puede obtener las corrientes de datos del sistema. Si desea utilizar la consola para supervisar la aplicación sin utilizar el manejador de la consola, puede supervisar el archivo SystemOut.log o supervisar un archivo creado por otro manejador de archivo.

Nota: El servidor de aplicaciones utiliza el registro cronológico de Java internamente y, por lo tanto, se aplican determinadas restricciones para utilizar las secuencias del sistema con esta API de registro cronológico por parte de las aplicaciones. Durante el arranque del servidor, la salida estándar y las corrientes de datos de error se sustituyen por corrientes de datos especiales que escriben en la infraestructura del registro cronológico, con objeto de incluir la salida de las corrientes de datos del sistema en los archivos de registro cronológico. Debido a esto, las aplicaciones no pueden utilizar java.util.logging.ConsoleHandler ni cualquier otro manejador que escriba en corrientes de datos SystemErr.log o System.out, adjuntados al registrador root. Si el usuario no adjunta el manejador al registrador root, se crea un bucle infinito en la infraestructura de registro cronológico, que conduce a un desbordamiento de la pila y a una colisión de servidor.

Si es necesario el uso de un manejador que escriba en los corrientes de datos del sistema, adjúntelo a un registrador no root para que no publique los registros de anotación en los manejadores padre. Los datos escritos en las corrientes de datos del sistema se formatean y escriben después en el archivo correspondiente de anotación de la corriente de datos del sistema. Para supervisar lo qué se escribe, se pueden supervisar las corrientes de datos y los archivos de anotación configurados (por omisión SystemOut.log y SystemErr.log).

Nota: Este tema hace referencia a uno o varios de los archivos de registro del servidor de aplicaciones. Como alternativa recomendada, puede configurar el servidor para utilizar la infraestructura de registro y rastreo HPEL (High Performance Extensible Logging) en lugar de utilizar los archivos SystemOut.log , SystemErr.log, trace.logy activity.log en sistemas distribuidos y IBM® i . También puede utilizar HPEL junto con los recursos de registro nativos de z/OS® . Si utiliza HPEL, puede acceder a toda la información de registro y de rastreo utilizando la herramienta de línea de mandatos LogViewer desde el directorio bin del perfil de servidor. Consulte la información de sobre cómo utilizar HPEL para resolver problemas de aplicaciones para obtener más información sobre cómo utilizar HPEL.