В версии 9.4 были добавлены средства ведения протоколов на основе служб протоколов Apache log4cxx. Можно установить ограничения на размер файлов протокола, задать автоматическую очистку устаревших файлов, выбрать формат файлов протокола вывода, изменить уровень протокола, а также изменить эти конфигурации протокола без перезапуска сервера. Файл конфигурации отслеживается каждые 60 секунд для обнаружения изменений.
Предусмотрены следующие режимы ведения протоколов (в порядке убывания уровня подробности): Debug, Info, Warn, Error и Fatal. На каждом уровне регистрируется информация со всех более высоких уровней. Например, на уровне Warn регистрируется информация для уровней Warn, Error и Fatal.
Сервер базы данных Rational DOORS поддерживает более ранний режим ведения протоколов, который можно включить с помощью параметра -logfile. Дополнительная информация приведена в разделе Параметры командной строки сервера базы данных.
По умолчанию эти файлы расположены в корневом каталоге Rational DOORS; например, C:\Program Files\IBM\Rational\DOORS\9.версия.
Имя | Описание | Значение |
Имя целевого объекта вывода appender | Задает имя объекта appender, применяемого для описания активных объектов appender. | Любое значение; например, SystemOutAppender |
file | Задает имя и расположение файла протокола. | Доступное расположение в системе; например, C:\IBM\DOORS\log\SystemError.log |
append | Если для этого параметра указано значение true, то информация добавляется в файл, указанный в параметре file. Если для этого параметра указано значение false, то файл, указанный в параметре file перезаписываются. | true или false |
Порог | Этот параметр задает режим протокола. | off, fatal, error, warn, info, debug |
Если для порога задано значение fatal, то в файле протокола будет регистрироваться только информация об отказе системы. | fatal | |
Если для порога задано значение error, то в файле протокола будет регистрироваться информация об отказе системы и сообщения об ошибках. | error | |
Если для порога задано значение warn, то в файле протокола будет регистрироваться информация об отказе системы, предупреждения и сообщения об ошибках. | warn | |
Если для порога задано значение info, то в файле протокола будет регистрироваться информация об отказе системы, предупреждения, сообщения об ошибках и информационные сообщения. | info | |
Если для порога задано значение debug, то в файле протокола будет регистрироваться вся информация. | debug | |
Если для порога задано значение off, то ведения протокола выключено. | off | |
MaxFileSize | Этот параметр задает максимальный размер файла протокола. После достижения максимального размера создается новый файл протокола. Имя нового файла содержит порядковый номер. | Любое значение; например, 1000 КБ |
MaxBackupIndex | Этот параметр позволяет задать максимальное число файлов, создаваемых для программы ведения протокола. При достижении этого значения выполняется переход к самому раннему файлу с заменой. | Любое целое число |
Шаблон преобразования | Этот параметр задает формат, в котором информация регистрируется в файле протокола. Можно указать дату и время, режим протокола и обзор регистрируемой информации. При необходимости последовательность можно изменить. | Это значение начинается с даты: %d{дд МММ гггг ЧЧ:мм:сс:ССС} [%p] %m%n |
Это значение начинается с режима протокола: [%p] %m%n %d{дд МММ гггг ЧЧ:мм:сс:ССС} |
Имя параметра | Описание | Значение |
priority | Этот параметр задает уровень режима ведения протокола для всех протоколов. Значение по умолчанию: "all". Для выключения протоколов задайте для этого параметра значение "off" | all, debug error, fatal, info, off, warn |
appender-ref | Содержит имена объектов appender из раздела appender. Укажите имена объектов appender, применяемых для ведения протоколов. | <appender-ref ref="DOORSConsoleAppender"/> |
Для того чтобы включить несколько объектов appender, следует создать несколько экземпляров тега <appender-ref>. | <appender-ref ref="SystemOutAppender"/> |