Протокол сообщений приложения в IBM Rational DOORS

В IBM® Rational DOORS с помощью сообщений приложения можно управлять протоколами диагностики с целью устранения неполадок.

В версии 9.4 были добавлены средства ведения протоколов на основе служб протоколов Apache log4cxx. Можно установить ограничения на размер файлов протокола, задать автоматическую очистку устаревших файлов, выбрать формат файлов протокола вывода, изменить уровень протокола, а также изменить эти конфигурации протокола без перезапуска сервера. Файл конфигурации отслеживается каждые 60 секунд для обнаружения изменений.

Предусмотрены следующие режимы ведения протоколов (в порядке убывания уровня подробности): Debug, Info, Warn, Error и Fatal. На каждом уровне регистрируется информация со всех более высоких уровней. Например, на уровне Warn регистрируется информация для уровней Warn, Error и Fatal.

Сервер базы данных Rational DOORS поддерживает более ранний режим ведения протоколов, который можно включить с помощью параметра -logfile. Дополнительная информация приведена в разделе Параметры командной строки сервера базы данных.

Информация, передаваемая в файлы протоколов, управляется файлом конфигурации XML. Существуют следующие файлы конфигурации:

По умолчанию эти файлы расположены в корневом каталоге Rational DOORS; например, C:\Program Files\IBM\Rational\DOORS\9.версия.

Файл конфигурации .xml

Параметры, управляющие ведением протокола сообщений приложения, расположены в двух разделах файла конфигурации:
  • Параметры объектов Appender, которые задают путь к файлу протокола, уровень протокола, максимальный размер файла, максимальный индекс резервного копирования, а также формат для каждого файла протокола.
  • Параметры функции ведения протоколов управляют всем режимом регистрации и набором целевых объектов вывода appender, включаемых для регистрации.
Табл. 1. Параметры Appender
Имя Описание Значение
Имя целевого объекта вывода 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{дд МММ гггг ЧЧ:мм:сс:ССС}
Табл. 2. Параметры функции ведения протоколов
Имя параметра Описание Значение
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"/>

Комментарии