Permite especificar límites en el tamaño de los archivos de registro, establecer la limpieza automática de archivos antiguos, elegir el formato de los archivos de registro de salida, cambiar el nivel de registro y cambiar estas opciones de configuración de registro sin tener que reiniciar el servidor. Estos archivos de configuración se supervisan cada 60 segundos y cualquier cambio realizado a este archivos se verá reflejado dentro de este intervalo.
El servidor de Rational DOORS continúa dando soporte al anterior estilo de registro que se puede habilitar con conmutadores de línea de mandatos -logfile (-l) (Consulte los conmutadores de línea de mandatos del servidor de base de datos de Rational DOORS.
El archivo de configuración basado en XML que controla la información que se debe registrar en los archivos de registro, archivo de ejemplo 'logging-config.xml', se encuentra ubicado bajo la vía de acceso raíz de DOORS (por ejemplo, C:\Archivos de programa\IBM\Rational\DOORS\9.4). La vía de acceso al archivo de configuración se debería proporcionar en la entrada de registro logxconfig bajo DOORS_Server o mediante la opción de línea de mandatos ‘-x’ o ‘-logxconfig’ seguida por la vía de acceso al archivo de configuración.
El archivo de ejemplo xml logging-config se debe configurar para que incluya una vía de ubicación de carpeta válida en la que generar los archivos de registro.
Por ejemplo:
<param name="file" value="${LOG_FOLDER_LOCATION}/IBM/DOORS/log/SystemError.log" /> se puede cambiar a <param name="file" value="C:/My Server Log/IBM/DOORS/log/SystemError.log" />
El archivo logging-config.xml contiene básicamente dos secciones:
La primera sección contiene una lista de los anexadores donde se proporcionan valores sobre la vía de acceso al archivo de registro, el nivel de registro, el tamaño máximo de archivo, el número máximo de índices de copia y el formato para cada archivo de registro.
Existen 5 modalidades de registro FATAL < ERROR < WARN < INFO < DEBUG (la información que se registrará en cada nivel será toda la información que se registre de dicho nivel o uno inferior).
La segunda sección del registrador en la que se establecen valores en relación a la modalidad de toda la creación del registro y un conjunto de anexadores que se deben habilitar para la creación del registro.
Para inhabilitar la creación del registro, establezca el nivel de prioridad con el valor "off".
En la siguiente tabla se describen los parámetros que se utilizan en el archivo logging-config.xml:
Nombre de sección | Nombre de parámetro | Descripción | Valor |
---|---|---|---|
Parámetros de sección de anexador | |||
appender nombre | Se trata del nombre del anexador que se utilizará más tarde para describir qué anexadores deben habilitarse más tarde. | Cualquier valor. Por ejemplo: SystemOutAppender | |
file | Archivo de registro que se crea con el nombre de archivo especificado bajo la ubicación indicada en este valor de parámetro. | Ubicación accesible en su sistema. | |
append | true: anexador para el archivo mencionado en el parámetro file. false : sobrescribe el archivo mencionado en el parámetro file. | true/false | |
Threshold | Este parámetro establece la modalidad del registro. | off, fatal, error, warn, info, debug | |
Si el umbral se establece en fatal, únicamente registrará información muy grave en el archivo de registro. | |||
Si el umbral se establece en error, únicamente registrará información muy grave y de error en el archivo de registro. | |||
Si el umbral se establece en warn, únicamente registrará información muy grave, de error y de aviso en el archivo de registro. | |||
Si el umbral se establece en info, registrará información muy grave, de error, de aviso y de información en el archivo de registro. | |||
Si el umbral se establece en debug, registra toda la información (muy grave, error, aviso, información y depuración). | |||
Si el umbral se establece en off, se inhabilitará la creación del registro. | |||
MaxFileSize | Este parámetro establece el tamaño máximo del archivo de registro y cuando el archivo de registro alcanza este límite crea un nuevo archivo de registro con un nombre de archivo al que se añade un número que se va incrementando. | Cualquier valor con unidades. Por ejemplo: 1000KB | |
MaxBackupIndex | Este parámetro establece el número máximo de archivos que puede crear el registrador. Cuando alcance este valor, se dirigirá al archivo más antiguo y volverá a grabarlo. | Cualquier valor entero. | |
Patrón de conversión | Este parámetro especifica el formato en que se registra la información en el archivo de registro. | %d{dd MMM yyyy HH:mm:ss:SSS} [%p] %m%n : empieza con una fecha | |
Básicamente incluye el formato fecha hora junto con el tipo de registro [modalidad de registro] y resumen de la información registrada. Existe la posibilidad de cambiar la secuencia dependiendo de cómo desee ver los registros. | [%p] %m%n %d{dd MMM yyyy HH:mm:ss:SSS} : empieza con la modalidad de registro | ||
Parámetros de la sección del registrador | |||
priority | Establece el nivel de modalidad de creación del registro a nivel general. Para inhabilitar la creación del registro establezca este valor en "off". | off, fatal, error, warn, info, debug | |
appender-ref | El valor para ref contiene el nombre de los anexadores que se han definido en las secciones anteriores de anexador. Dependiendo de los anexadores definidos con anterioridad, necesita habilitarlos proporcionando sus nombre para crear el registro. | <appender-ref ref="DOORSConsoleAppender"/> | |
Si desea habilitar varios anexadores, cree varias instancias con el código <appender-ref>. | <appender-ref ref="SystemOutAppender"/> |