HPEL (High Performance Extensible Logging)

HPEL (High Performance Extensible Logging) es un recurso de registro y rastreo que se proporciona como parte de WebSphere Application Server.

Visión general

Supported configurations Supported configurations: El recurso de registro y rastreo básico está habilitado de forma predeterminada. Para utilizar HPEL debe habilitarlo.sptcfg

[AIX Solaris HP-UX Linux Windows][IBM i]HPEL proporciona una forma cómoda de almacenar y acceder a la información de registro, rastreo, System.err y System.out generada por el servidor de aplicaciones o sus aplicaciones. Es una alternativa al recurso de registro y rastreo básico, que proporcionaba los archivos de registro de JVM, de rastreo de diagnósticos y de registro de servicio normalmente denominados SystemOut.log/SystemErr.log, trace.log y activity.log.

[z/OS]HPEL proporciona una forma cómoda de almacenar y acceder a la información de registro, rastreo, System.err y System.out generada por el servidor de aplicaciones o sus aplicaciones. Es una alternativa a los recursos de registro y rastreo existentes que se ofrecen en la plataforma z/OS que aprovechan JES, LogStreams, rastreo de componentes, sistema de archivos jerárquico u otros recursos.

Almacenamiento de registro y rastreo de HPEL

HPEL proporciona un repositorio de datos de registro, un repositorio de datos de rastreo y un archivo de registro de texto. Consulte la figura siguiente para comprender cómo las aplicaciones y el servidor de aplicaciones almacenan la información de registro y de rastreo.

Figura 1. Almacenamiento de registro y rastreo para el registro de HPEL y básico Almacenamiento de registro y rastreo para el registro de HPEL y básico.
Repositorio de datos de registro de HPEL

El repositorio de datos de registro es un recurso de almacenamiento para los registros. Normalmente, los datos de registro están pensados para que los revisen los administradores. Esto incluye cualquier información que las aplicaciones o el servidor graben en System.out, System.err, o java.util.logging a nivel de detalle o superior (incluido Detail, Config, Info, Audit, Warning, Severe, Fatal, y cualquier nivel personalizado a nivel de detalle o superior).

Repositorio de datos de rastreo de HPEL

El repositorio de datos de rastreo es un recurso de almacenamiento para los registros de rastreo. Normalmente, los datos de rastreo están pensados para ser utilizados por los programadores de aplicaciones o por el equipo de soporte de WebSphere Application Server. Esto incluye toda la información que las aplicaciones o el servidor graban en java.util.logging a niveles por debajo de nivel de detalle (incluidos Fine, Finer, Finest, y cualquier nivel personalizado por debajo de nivel de detalle).

Supported configurations Supported configurations: También se incluye contenido de registro y de rastreo en el API de registro JRAS en desuso, en los repositorios de datos de registro y de rastreo. Algunos API de registro, como Jakarta Commons Logging, también pueden configurarse para direccionar sus datos de registro y de rastreo a java.util.logging; además, su salida se almacena también en el repositorio de datos de registro y de rastreo.sptcfg
Registro de texto de HPEL

El archivo de registro de texto es un archivo de texto plano para los registros de anotaciones y rastreo. El archivo de registro de texto se proporciona para su comodidad, principalmente para que el contenido del registro se pueda leer sin tener que ejecutar la herramienta de línea de mandatos LogViewer para convertir el contenido del repositorio de datos de registro a texto sin formato.

El archivo de registro de texto no contiene ningún contenido que no esté también almacenado en el repositorio de datos de registro o el repositorio de datos de rastreo. Puede inhabilitar el registro de texto para mejorar el rendimiento del servidor. El registro de texto se puede configurar para registrar el contenido de rastreo para mayor comodidad en la depuración.

[z/OS]El archivo de registro de texto sólo contiene entradas de registro que se generan mediante el proceso del controlador y no los procesos de sirviente o adjunto. De este modo, los registros de aplicaciones no se graban en el registro cronológico de texto en z/OS. Para ver datos de registro y rastreo de todos los procesos del servidor de aplicaciones, utilice la herramienta de la línea de mandatos LogViewer o la herramienta de visualización de recursos HPEL en la consola administrativa.

Avoid trouble Avoid trouble: La grabación de rastreo en el registro de texto disminuye el rendimiento.gotcha

Rendimiento del registro y el rastreo

[AIX Solaris HP-UX Linux Windows][IBM i]HPEL se ha diseñado y probado para mejorar significativamente el rendimiento del recurso existente de registro y rastreo básico. Un resultado es que el servidor de aplicaciones se puede ejecutar con el registro habilitado, causando un impacto menor en el rendimiento que cuando se rastrean los mismos componentes utilizando el registro básico. Otra consecuencia es que las aplicaciones que escriben frecuentemente en el registro pueden ejecutarse con mayor velocidad con HPEL. Hay varios factores que contribuyen al rendimiento general del registro y el rastreo de HPEL.

Los sucesos de registro y de rastreo se almacenan en un solo lugar

Los sucesos de registro, System.outy System.err se almacenan en el repositorio de datos de registro. Los sucesos de rastreo se almacenan en el repositorio de datos de rastreo. Si el archivo de registro de texto está inhabilitado, es posible que HPEL sólo pueda escribir contenido de registro y de rastreo en estos repositorios. Al almacenar cada tipo de suceso en un lugar, se asegura que el rendimiento no se vea afectado por realizar un almacenamiento de datos redundante.

Los sucesos de registro y, opcionalmente, los sucesos de rastreo, se escriben en el archivo de registro de texto, cuando éste está habilitada. Puesto que estos datos también se almacenan siempre en los repositorios de datos de registro y de datos de rastreo, el contenido del archivo de registro de texto es redundante. El registro de texto es útil para los usuarios que no desean ejecutar la herramienta de línea de mandatos LogViewer para ver los archivos de registros y de rastreo, pero puede inhabilitar el registro de texto si no necesita esta facilidad.

Cada suceso sólo se almacena en un lugar cuando el registro de texto está inhabilitado.

Los procesos no comparten los repositorios de registro y de rastreo

La sincronización de actividades entre procesos produce una disminución del rendimiento de todos los procesos implicados. Con HPEL, cada proceso de servidor tiene su propio repositorio de datos de registro, repositorio de datos de rastreo y archivo de registro de texto. Dado que estos archivos no se comparten entre procesos, no es necesario sincronizar el entorno de ejecución del servidor con otros procesos al escribir en estas destinaciones.

No se da formato a los datos a menos que sea necesario

La acción de formatear datos para que los lea un usuario emplea tiempo de procesador. En lugar de dar formato a los datos de suceso del registro y del rastreo en tiempo de ejecución, los dato de registro y de rastreo de HPEL se almacenan más rápidamente en una representación binaria propietaria. Esto mejora el rendimiento del recurso de registro y de rastreo. Al retrasar el formateo del registro y el rastreo hasta que se ejecuta LogViewer, no se da formato a las secciones del registro o el rastreo que nunca se visualizan.

Puede habilitar el archivo de registro de texto, que almacena los datos de registro y los datos de rastreo en formato de texto legible.

Best practice Best practice: Inhabilite el registro de texto cuando el rendimiento del servidor es una preocupación fundamental, o si no desea el registro de texto.bprac
Los datos de registro y rastreo se almacenan en el almacenamiento intermedio antes de grabarse en disco

Grabar grandes bloques de datos en un disco es más eficaz que grabar la misma cantidad de datos en bloques pequeños. HPEL proporciona un datos de registro y rastreo de almacenamiento intermedio antes de grabarlos en disco. De forma predeterminada, los datos de registro y rastreo se almacenan en un almacenamiento intermedio de 8 KB antes de grabarlos en disco. Si el almacenamiento intermedio se llena en 10 segundos, dicho almacenamiento intermedio se graba en disco. Si el almacenamiento intermedio no se llena en ese tiempo, se graba automáticamente en disco para garantizar que los registros tienen la información más actual.

Supported configurations Supported configurations: El tamaño del almacenamiento intermedio puede controlarse mediante la propiedad del sistema HPEL.BUFFER.SIZE. La frecuencia con la que el almacenamiento intermedio graba en el disco puede controlarse con la propiedad del sistema HPEL.FLUSH.PERIOD.SECS.sptcfg

Administración de registro y de rastreo

HPEL se ha diseñado para que sea fácil de configurar y de entender. Por ejemplo, los administradores pueden configurar fácilmente cuánto espacio de disco dedicar al registro y al rastreo, o cuánto tiempo se deben conservar los registros de anotaciones y de rastreo, y dejar la gestión del contenido de registro y rastreo para el servidor. Otro ejemplo es que se puede acceder a todo el contenido de registro, rastreo, System.out y System.err utilizando un mandato fácil de utilizar (LogViewer), evitando así cualquier posible confusión sobre qué archivo utilizar para acceder a cierto contenido.

Leer de los repositorios de datos de registro y de datos de rastreo

Los repositorios de datos de registro y de datos de rastreo se almacenan en un formato propietario de WebSphere Application Server y no se pueden leer utilizando editores de archivos de texto como Notepad o VI. Puede copiar repositorios de datos de registro y de rastreo en un formato de texto sin formato utilizando el mandato LogViewer.

Leer los repositorios de datos de registro y de rastreo con la herramienta de línea de mandatos LogViewer.

Mandato LogViewer de HPEL

LogViewer de HPEL es una herramienta de línea de mandatos, fácil de utilizar, que se proporciona a los usuarios de HPEL para trabajar con los repositorios de datos de registro y de datos de rastreo. LogViewer proporciona opciones de filtro y de formato que facilitan la búsqueda de contenido importante en los repositorios de datos de registro y de datos de rastreo. Por ejemplo, un usuario puede filtrar cualquier error o aviso y, a continuación, filtrar todas las entradas de registro y rastreo que se han producido en los 10 segundos posteriores a un mensaje de error clave en la misma hebra.

Filtrado mediante el contenido de extensión del registro de rastreo y de anotaciones

Puede utilizar la herramienta de línea de mandatos LogViewer para filtrar registros basados en el contenido de las extensiones de registro de anotaciones y rastreo. El servidor de aplicaciones crea automáticamente una extensión appName para cada registro de anotaciones y de rastreo relacionado con una aplicación Java™ Platform, Enterprise Edition (Java EE), que indica el nombre de esa aplicación. El servidor de aplicaciones crea automáticamente también una extensión requestID para cada registro de anotaciones y de rastreo durante el proceso de determinados tipos de solicitudes (por ejemplo solicitudes HTTP o JMS), que indica el ID exclusivo de esa solicitud.

La extensión requestID se añade solo a los registros de anotaciones y de rastreo cuando está habilitado el rastreo de componente cruzado. HPEL proporciona también a los desarrolladores la capacidad de añadir extensiones personalizadas a los registros de anotaciones y de rastreo mediante una API de contexto de registro de anotaciones cronológicas (com.ibm.websphere.logging.hpel.LogRecordContext).

HPEL en la consola administrativa

La consola administrativa contiene páginas que permiten que los administradores de HPEL puedan:

  • Configurar el repositorio de datos de registro de HPEL.
  • Configurar el repositorio de datos de rastreo de HPEL.
  • Configurar el archivo de registro de texto de HPEL.
  • Ver el contenido de los repositorios de datos de registro y de rastreo de HPEL.
  • Ver y establecer los niveles de detalle de registro para el registro y el rastreo.

Para utilizar estas prestaciones, en la consola administrativa, pulse el enlace Resolución de problemas > Registros y rastreo.

Recursos de desarrollo

HPEL permite trabajar de forma más flexible y eficaz con el contenido de registro y rastreo que el recurso de registro de compatibilidad. El contenido del registro y el rastreo puede filtrarse fácilmente para que sólo se muestren los registros que interesen. Puede utilizar la línea de mandatos (vea la descripción del mandato LogViewer de HPEL) o los desarrolladores pueden crear potentes programas de manejo utilizando la API de HPEL.

Los scripts y programas Java leen datos de los repositorios de datos de registro y de rastreo
Los desarrolladores y autores de scripts pueden elegir entre varias opciones para leer datos de los repositorios de datos de registro y de rastreo:
  • De forma local o remota desde un script wsadmin, utilizando el MBean JMX HPELControlService
  • De forma local o remota mediante un programa Java, utilizando el HPELControlService JMX MBean
  • De forma local utilizando un programa Java, mediante la API com.ibm.websphere.logging.hpel

Utilizar las API de HPEL y la interfaz MBean para acceder al contenido de los repositorios de datos de registro y de rastreo.

MBeans JMX relacionados con HPEL

Se proporciona una interfaz MBean para facilitar el acceso al contenido del repositorio de HPEL de forma remota. Por ejemplo, un desarrollador puede escribir un programa cliente de JMX para leer el contenido de registro de toda la célula de WebSphere Application Server. Esta interfaz forma parte del HPELControlService MBean. Consulte la documentación de la interfaz de MBean para obtener detalles sobre la interfaz de lectura de registro remoto de HPEL.

Tabla 1. MBeans JMX relacionados con HPEL. Los MBeans JMX están relacionados con el funcionamiento de HPEL.
MBean JMX Descripción
HPELControlService Proporciona operaciones relacionadas con la configuración del nivel de detalle de registro o rastreo del servidor, la visualización del registro de componentes de registro, y la consulta de repositorios de registro y rastreo
HPELLogDataService Proporciona operaciones relacionadas con la configuración del repositorio de datos de registro del servidor
HPELTraceDataService Proporciona operaciones relacionadas con la configuración del repositorio de datos de rastreo del servidor
HPELTextLogService Proporciona operaciones relacionadas con la configuración del archivo de registro de texto del servidor
RasLoggingService Sólo se utiliza para la Notificación JMX de registro de sucesos

Cuando se utiliza HPEL para el registro y rastreo en lugar del registro básico, no se utiliza el servicio de MBean JMX de registro y rastreo TraceService.

API de HPEL

Se ha proporcionado una API para que los desarrolladores puedan desarrollar fácilmente herramientas para consumir el contenido de los repositorios de registro y rastreo de HPEL. Por ejemplo, un desarrollador puede escribir un programa Java para buscar en el contenido de registro y de rastreo los mensajes con un ID de mensaje que se encuentre en una lista de IDs de mensaje específicos. Esta API está en el paquete ç com.ibm.websphere.logging.hpel. Consulte la documentación de la API para obtener detalles sobre la API de lectura de registros de HPEL.

Posibilidad de ampliación del registro de anotaciones y de rastreo

Los desarrolladores pueden utilizar HPEL para añadir extensiones personalizadas a los registros de anotaciones y rastreo mediante una API de contexto de registro de anotaciones (com.ibm.websphere.logging.hpel.LogRecordContext). Cuando HPEL almacena los registros de anotaciones cronológicas y de rastreo, incluye las extensiones presentes en el contexto de registro de anotaciones en la misma hebra. Por ejemplo, un desarrollador podría grabar un filtro de servlet para añadir parámetros de solicitud HTTP importantes al contexto de registro de anotaciones. Mientras se ejecuta ese servlet, HPEL añade esas extensiones a los registros de anotaciones y de rastreo creados en la misma hebra.

Al igual que con otros campos de registro de anotaciones y de rastreo, los desarrolladores pueden acceder a las extensiones de registro mediante la API de HPEL. Esto es útil cuando grabe herramientas para leer los repositorios de anotaciones y de rastreo. Los desarrolladores pueden utilizar también la API de contexto para acceder a las extensiones de manejadores de registro cronológico personalizados, filtros y formateadores en tiempo de ejecución.


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_HPELOverview
File name: ctrb_HPELOverview.html