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:
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.
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.
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.
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.