Extensiones de registro y rastreo

La función HPEL (High Performance Extensible Logging) del servidor de aplicaciones proporciona a los desarrolladores un modo de añadir campos de ampliación para registros de registro cronológico y rastreo y un modo correspondiente para que el usuario para filtrar registros de registro cronológico y rastreo por valor de extensión.

Los registros de registro cronológico y rastreo contienen campos para información como la hora de creación del registro y el contenido del mensaje que se registra. Estos campos son campos determinantes que están presentes en todos los registros de registro cronológico y rastreo. En contraste, los campos de extensión son campos que los desarrolladores de aplicaciones pueden añadir a registros de registro cronológico y rastreo, que se pueden utilizar como criterios de filtro al buscar contenido de registro cronológico y rastreo específico. Estas extensiones de registro cronológico y rastreo son visibles en el registro cronológico de texto HPEL al configurar el formato de salida de texto para utilizar el formato Avanzado o son visibles al utilizar el mandato LogViewer en el formato avanzado.

Administradores

El servidor de aplicaciones crea automáticamente un número de extensiones que puede utilizar para filtrar registros de registro cronológico y rastreo. También puede filtrar registros de registro cronológico y rastreo utilizando extensiones añadidas por sus desarrolladores de aplicaciones. Puede utilizar la herramienta de línea de mandatos LogViewer para filtrar los registros basándose en el contenido de las extensiones de registro de anotaciones y de rastreo.

Por ejemplo, para ver todos los registros creados por la hebra,, WebContainer : 6 , puede utilizar el mandato logViewer siguiente:[IBM i]
logViewer -includeExtensions thread="WebContainer : 6" -format advanced
[AIX HP-UX Solaris][Linux]
logViewer.sh -includeExtensions thread="WebContainer : 6" -format advanced
[Windows]
logViewer.bat -includeExtensions thread="WebContainer : 6" -format advanced
[z/OS]
logViewer.sh -instance instance_id -includeExtensions thread="WebContainer : 6" -format advanced
Desarrolladores

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, 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. Esta API resulta útil al grabar herramientas para leer desde repositorios de registros cronológicos y 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.

La tabla siguiente describe las extensiones de registro cronológico y rastreo, incluido el identificador que puede utilizar para filtrar varios aspectos del rastreo.

Tabla 1. Extensiones de registro cronológico y rastreo. Esta tabla lista las extensiones de registro cronológico y rastreo disponibles al utilizar HPEL.
Extensión Descripción
Nombre de aplicación

Especifique el nombre de la aplicación Java™ Platform, Enterprise Edition (Java EE) con la que está relacionado el registro de registro cronológico o rastreo, en el caso de que exista.

requestID

Especifica el ID exclusivo de la solicitud con el que se relaciona cada registro de registro cronológico o rastreo, en el caso de que exista. Para que el servidor de aplicaciones añada una extensión requestID para registros de registro cronológico y rastreo, debe habilitar el rastreo de componentes cruzados (XCT), también conocido en la consola administrativa como correlación de registro cronológico y rastreo. Los ID de solicitud sólo se añaden para determinados tipos de solicitudes, como por ejemplo las solicitudes HTTP o JMS.

SIPCallId

Especifica el identificador de llamada SIP que procesa el servidor proxy SIP o el contenedor SIP. Esta información es común entre los servidores proxy SIP y los contenedores SIP. Puede utilizar esta extensión para realizar un seguimiento del flujo de llamada SIP en los diferentes componentes. El servidor proxy SIP y el contenedor SIP añaden automáticamente este identificador a cada registro de registro cronológico y de rastreo al habilitar el registro cronológico HPEL.

SIPASId

Especifica el ID de sesión de aplicación SIP procesado por el contenedor SIP. Esta información es común entre los contenedores SIP. Puede utilizar esta extensión para realizar un seguimiento del flujo de llamada SIP. El contenedor SIP añade automáticamente este identificador a cada registro de registro cronológico y de rastreo al habilitar el registro cronológico HPEL.

 SIPSessionId

Especifica el ID de sesión SIP procesado por el contenedor SIP. Esta información es común entre los contenedores SIP. Puede utilizar esta extensión para realizar un seguimiento del flujo de llamada SIP. El contenedor SIP añade automáticamente este identificador a cada registro de registro cronológico y de rastreo al habilitar el registro cronológico HPEL.

SIPCallId2

Especifica el ID de llamada SIP segundo que se asocia con la misma sesión de aplicación SIP y que está siendo procesado por el contenedor SIP. Esta información es común entre los contenedores SIP. Puede utilizar esta extensión para realizar un seguimiento del flujo de llamada SIP. El contenedor SIP añade automáticamente este identificador a cada registro de registro cronológico y de rastreo al habilitar el registro cronológico HPEL.

Si se asocia más de dos ID de llamada SIP con una sola sesión de aplicación SIP, sólo se registrarán los dos primeros ID. Los ID adicionales no se registran.

SIPSessionId2

Especifica el ID de sesión SIP segundo que se asocia con la misma sesión de aplicación SIP y que está siendo procesado por el contenedor SIP. Esta información es común entre los contenedores SIP. Puede utilizar esta extensión para realizar un seguimiento del flujo de llamada SIP. El contenedor SIP añade automáticamente este identificador a cada registro de registro cronológico y de rastreo al habilitar el registro cronológico HPEL.

Si se asocia más de dos ID de sesión SIP con una sola sesión de aplicación SIP, sólo se registrarán los dos primeros ID. Los ID adicionales no se registran.

thread

Especifica el nombre de hebra de la solicitud con el que se relaciona cada registro de registro cronológico o rastreo.


Icon that indicates the type of topic Reference topic



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