IBM FileNet P8, Versión 5.1.+            

Configuración del registro de Workplace XT

IBM® FileNet Workplace XT utiliza el producto Apache log4j para gestionar su registro. Durante el registro, la información acerca de la actividad de la aplicación se graba en las ubicaciones de salida, como la consola o en archivos. El personal de soporte y desarrollo utiliza la información de las entradas del registro para analizar la actividad de la aplicación y para diagnosticar y resolver problemas. El registro sólo es a efectos de diagnóstico y no proporciona seguridad o información de seguimiento de auditoría.

El producto log4j se instala durante la instalación de Workplace XT. Por omisión, el registro no se habilita durante la instalación.

Para habilitar o inhabilitar el rastreo:

  1. Desplácese a la carpeta de configuración de Workplace XT especificada durante la instalación. La ruta predeterminada es: Carpeta de configuración de Workplace XT especificada durante la instalación. La ruta predeterminada es:
    • Windows: <unidad>:\Archivos de programa\FileNet\Config\WebClient
    • UNIX: /opt/FileNet/config/WebClient
  2. Habilite o inhabilite el registro renombrando el archivo de configuración. El archivo de configuración del registro de ejemplo se llama __log4j.properties.
    • Para habilitar el registro, renombre __log4j.properties por log4j.properties.
    • Para inhabilitar el registro, renombre log4j.properties por otro nombre; por ejemplo, __log4j.properties.
  3. Reinicie la aplicación para que los cambios entren en vigor.

Configurar valores de registro

El archivo de ejemplo log4j.properties tiene un conjunto de opciones predeterminadas, especificadas como pares palabra clave=valor. Para cambiar los valores por omisión, abra log4j.properties con un editor de texto, modifique lo que sea necesario y guarde el archivo. Puede configurar los valores de registro en cualquier momento después de la instalación. Los cambios que realice en el archivo de configuración de registro se reconocen automáticamente; no es necesario reiniciar la aplicación o el servidor de aplicaciones.

Los siguientes temas le proporcionan información acerca de algunas opciones de configuración del registro que verá en el archivo. Para obtener más información sobre las opciones de registro, consulte el sitio web de Apache (http://apache.org) en Logging Project, y en el sitio web de registro de Apache (http://logging.apache.org/log4j/).

Registrador

Un registrador graba solicitudes de registro habilitadas a los añadidores. En el archivo log4j.properties, la primera palabra clave describe el registrador raíz. El registrador raíz es el registrador de nivel más alto de la jerarquía y suministra valores por omisión globales; los registradores hijos que no establezcan explícitamente las opciones heredan su comportamiento del registrador raíz.

Añadidor

Puede especificar dónde se graban los datos configurando un añadidor, que envía entradas de registro formateadas a un destino de salida especificado. Los tipos de destino pueden ser un archivo o la consola; la salida se puede redirigir a un registro de sucesos Windowss, reenviarse a un servidor log4j remoto, etc. (Consulte la documentación de Apache log4j para conocer todas las opciones de destino de salida y formateo.) Un registrador puede tener más de un añadidor. Por ejemplo, puede escribir la salida en una consola y en un archivo a la vez. Al aumentar el número de destinos, el rendimiento puede verse afectado.

En Workplace XT, se configuran dos añadidores por omisión. Un añadidor escribe los datos de registro en el formato IBM Common Base Event (CBE), que utilizan las herramientas de IBM Support Assistant para procesar el registro, y el otro añadidor escribe en un formato que es más legible para el ser humano. Puede cambiar el segundo añadidor para reducir el volumen de salida o puede desactivar completamente este añadidor.

Nota:

Nivel

El nivel de registro que especifique determina el tipo y volumen de información recogida. Existe una correlación directa entre el volumen de información recogido y el impacto en el rendimiento del sistema.

El registro de la aplicación Workplace XT admite los niveles estándar INFO, WARN, ERROR y FATAL, además de los niveles ALL y OFF. La siguiente tabla describe brevemente los niveles estándar; consulte la documentación de Apache log4j para obtener más información acerca de los niveles.

Tabla 1. Esta tabla describe los niveles estándar INFO, WARN, ERROR y FATAL, además de los niveles ALL y OFF.
Nivel Descripción
INFO Solicita mensajes informativos que describen el progreso de la aplicación a nivel de grano grueso.
WARN Solicita el registro para situaciones potencialmente dañinas.
ERROR Solicita el registro de excepciones emitidas desde la aplicación.
FATAL Solicita el registro solamente de los sucesos de errores graves que presumiblemente puedan conducir a un fallo de la aplicación.

El nivel que especifique determina el volumen de información recogida. Existe una correlación directa entre el volumen de información recogido y el impacto en el rendimiento del sistema.

Formato de archivo de salida

Al configurar un añadidor, puede utilizar la palabra clave layout para especificar el formato con el que se graban los datos. Se elige un PatternLayout y un ConversionPattern. El PatternLayout especifica un patrón particular para las entradas de registro, y el ConversionPattern, que identifica el patrón de los elementos que se graban en el añadidor, define el patrón. Considere este ejemplo:

log4j.appender.ErrorOutputFile=org.apache.log4j.RollingFileAppender log4j.appender.ErrorOutputFile.layout=org.apache.log4j.PatternLayout log4j.appender.ErrorOutputFile.layout.ConversionPattern=%d [%t] - %-5p %m\r\n

se traduce en la siguiente entrada de registro con formato:

2007-05-31 17:36:12:801 [cwrap] - Document/Checkin ConnectionWrapper.send send.before

Para obtener más información sobre las opciones de formato, consulte la documentación de Apache log4j.

Nota: No cambie el diseño de las entradas de registro de IBM Common Base Event (CBE). Si lo hace, la salida generada no será legible para las herramientas de IBM Support Assistant.

Analizar la salida

El personal de soporte puede examinar las entradas de un archivo de registro para analizar la actividad de la aplicación y diagnosticar problemas que se produzcan en la aplicación. Asimismo, el uso de las herramientas de IBM Support Assistant (ISA) automatizan la fase de análisis. Las herramientas ISA consumen las entradas CBE de la salida del registro de log4j.

También puede utilizar una herramienta como Apache Chainsaw, un visor de registros basado en GUI para examinar entradas de registro no CBE.



Comentarios

Última actualización: Julio de 2011


© Copyright IBM Corp. 2011.
Este centro de información utiliza tecnología Eclipse. (http://www.eclipse.org)