Registro de mensajes de aplicación en IBM Rational DOORS

En IBM® Rational DOORS, puede utilizar mensajes de aplicación para controlar los registros de diagnóstico para la resolución de problemas.

La versión 9.4 incluye el registro de mensajes de aplicación que se basa en servicios de registro log4cxx de Apache. Puede limitar el tamaño de archivo de registro, configurar la limpieza automática de los archivos antiguos, elegir el formato de los archivos de registro de salida y cambiar el nivel de registro y las configuraciones de registro sin reiniciar el servidor. El archivo de configuración se supervisa cada 60 segundos para detectar los cambios.

Hay cinco modalidades de registro, mencionadas aquí de inferior a superior: Debug (Depuración), Info (Información), Warn (Aviso), Error y Fatal (Muy grave). Cada nivel registrará información para dicho nivel y todos los niveles superiores. Por ejemplo, el nivel Warn incluye información de las modalidades Warn, Error y Fatal.

El servidor de base de datos de Rational DOORS todavía admite el estilo de registro anterior, que se puede habilitar mediante el conmutador de línea de mandatos -logfile. Para obtener más información, consulte Conmutadores de línea de mandatos para el servidor de base de datos.

La información que se pasa a los archivos de registro se controla mediante un archivo de configuración basado en XML. Se proporcionan dos archivos de configuración:

De forma predeterminada, estos archivos se encuentran en la vía de acceso raíz de Rational DOORS; por ejemplo, C:\Archivos de programa\IBM\Rational\DOORS\9.versión.

Archivo de configuración .xml

Los parámetros que controlan el registro de mensajes de aplicación se encuentran en dos secciones del archivo de configuración:
  • Los parámetros de adicionador (appender) proporcionan valores para la vía de acceso de archivo de registro, el nivel de registro, el tamaño máximo de archivo, el índice de copia de seguridad máximo y el formato para cada uno de los archivos de registro.
  • Los parámetros de registrador (logger) proporcionan los valores para la modalidad de registro global y un conjunto de adicionadores que se pueden habilitar para el registro.
Tabla 1. Parámetros de adicionador
Nombre Descripción Valor
appender name Este parámetro es el nombre del adicionador que se utiliza para describir qué adicionadores se habilitan. Cualquiera; por ejemplo, SystemOutAppender
file Este valor de parámetro especifica el nombre y ubicación de un archivo de registro que se crea. Una ubicación accesible en el sistema; por ejemplo, C:\IBM\DOORS\log\SystemError.log
append Si este parámetro se establece en true, se añade información al archivo indicado en el parámetro file. Si este parámetro se establece en false, se sobrescribe el archivo indicado en el parámetro file. true o false
Threshold Este parámetro establece la modalidad del registro. off, fatal, error, warn, info o debug
Si el umbral se establece en fatal, sólo se registra información fatal en el archivo de registro. fatal
Si el umbral se establece en error, se registra información fatal y error en el archivo de registro. error
Si el umbral se establece en warn, se registra información fatal, error y warning en el archivo de registro. warn
Si el umbral se establece en info, se registran mensajes fatal, error, warning e information en el archivo de registro. info
Si el umbral se establece en debug, se registra toda la información en el archivo de registro. debug
Si el umbral se establece en off, el registro se inhabilita. off
MaxFileSize Este parámetro establece el tamaño máximo del archivo de registro. Cuando el archivo de registro alcanza el tamaño máximo, se crea otro archivo de registro. El nombre del nuevo archivo incluye el número incremental. Cualquiera con una unidad; por ejemplo, 1000 KB.
MaxBackupIndex Este parámetro establece el número máximo de archivos que se crean para el registrador. Después de alcanzar el número máximo, se sobrescriben los archivos, empezando por el archivo más antiguo. Cualquier valor entero.
Conversion Pattern Este parámetro especifica el formato en el que se registra la información en el archivo de registro. Puede incluir la fecha y hora, la modalidad de registro y un resumen de la información que se registra. Puede cambiar la secuencia según se necesite. Este valor empieza con la fecha: %d{dd MMM aaaa HH:mm:ss:SSS} [%p] %m%n
Este valor empieza con la modalidad de registro: [%p] %m%n %d{dd MMM aaaa HH:mm:ss:SSS}
Tabla 2. Parámetros de registrador
Nombre de parámetro Descripción Valor
priority Este parámetro establece el nivel de modalidad de registro para el registro global. El valor predeterminado es igual a "all". Para inhabilitar el registro, establezca el valor de este parámetro en "off". all, debug error, fatal, info, off o warn
appender-ref El valor para ref contiene el nombre de los adicionadores que ha definido en las secciones de adicionador. Según los adicionadores que deben habilitarse para el registro, debe proporcionar los nombres de adicionador. <appender-ref ref="DOORSConsoleAppender"/>
Para habilitar varios adicionadores, cree varias instancias de la etiqueta <appender-ref>. <appender-ref ref="SystemOutAppender"/>

Comentarios