Можно установить ограничения на размер файлов протокола, задать автоматическую очистку устаревших файлов, выбрать формат файлов протокола вывода, изменить уровень протокола, а также изменить эти конфигурации протокола без перезапуска сервера. Эти файлы конфигурации отслеживаются с интервалом 60 секунд, все изменения, вносимые в этот файл, будут отражаться в течение этого интервала.
Сервер Rational DOORS по-прежнему поддерживает предыдущие стили регистрации, включить которые можно с помощью переключателей командной строки -logfile (-l) (см. описание переключателей командной строки для сервера базы данных Rational DOORS).
Регистрируемая в файлах протокола информация управляется с помощью файла конфигурации на основе XML; по умолчанию пример файла 'logging-config.xml' находится в корневом каталоге DOORS (например, C:\Program Files\IBM\Rational\DOORS\9.4); путь к файлу конфигурации должен быть предоставлен в записи регистрации logxconfig в каталоге DOORS_Server или его можно получить с помощью опции командной строки ‘-x’ или ‘-logxconfig’, за которой следует путь к файлу конфигурации.
Пример файла logging-config необходимо настроить так, чтобы в него был добавлен допустимый путь к папке, в которой будут сохраняться создаваемые файлы протокола.
Пример:
<param name="file" value="${LOG_FOLDER_LOCATION}/IBM/DOORS/log/SystemError.log" /> можно изменить на <param name="file" value="C:/My Server Log/IBM/DOORS/log/SystemError.log" />
Файл logging-config.xml состоит из двух основных разделов:
В первом разделе содержится список целевых объектов вывода appender с параметрами, задающими путь к файлу протокола, уровень протокола, максимальный размер файла, максимальный индекс резервного копирования а также формат для каждого файла протокола.
Существует 5 режимов протокола: FATAL < ERROR < WARN < INFO < DEBUG (для каждого уровня протокола будет регистрироваться вся информация, относящаяся к тому же или более низкому приоритету).
Во втором разделе находится программа ведения протокола, предоставляющая параметры для всего режима регистрации и набора целевых объектов вывода appender, включаемых для регистрации.
Для выключения регистрации задайте для уровня приоритета значение "off".
В следующей таблице описаны параметры, используемые в файле logging-config.xml:
Имя раздела | Имя параметра | Описание | Значение |
---|---|---|---|
Параметры раздела целевых объектов вывода appender | |||
Имя целевого объекта вывода appender | Это имя объекта appender, с помощью которого в дальнейшем будет описано, какие из всех appender включены. | Любое. Пример: SystemOutAppender | |
file | Файл протокола создается с указанным именем файла и в расположении, указанном в значении этого параметра. | Доступное расположение в вашей системе. | |
append | true: добавить в файл, указанный в параметре file. false: записать с заменой файла, указанного в параметре file | true/false | |
Порог | Этот параметр задает режим протокола. | off, fatal, error, warn, info, debug | |
Если для порога задано значение fatal, то в файле протокола будет регистрироваться только информация об отказе системы. | |||
Если для порога задано значение error, то в файле протокола будет регистрироваться только информация об отказе системы и об ошибке | |||
Если для порога задано значение warn, то в файле протокола будет регистрироваться только информация об отказе системы, об ошибке и о предупреждении | |||
Если для порога задано значение info, то в файле протокола будут регистрироваться сведения об отказе системы, об ошибке, о предупреждении и информационные сообщения | |||
Если в качестве порога задать debug, то будет регистрироваться вся информация: об отказе системы, об ошибке, о предупреждении, информационные сообщения и сведения об отладке | |||
Если в качестве порога задать значение off, регистрация будет выключена | |||
MaxFileSize | Этот параметр позволяет задать максимальный размер файла протокола. По достижении этого предельного значения создается новый файл протокола, причем к имени файла добавляется нарастающий номер | Что-либо с единицей измерения. Пример: 1000KB | |
MaxBackupIndex | Этот параметр позволяет задать максимальное число файлов, создаваемых для программы ведения протокола. По достижении этого значения выполняется переход к самому раннему файлу для записи в него информации с заменой | Любое целое число | |
Шаблон преобразования | Этот параметр задает формат, в котором информация регистрируется в файле протокола. | %d{дд МММ гггг ЧЧ:мм:сс:ССС} [%p] %m%n : сначала дата | |
К основному формату даты и времени добавляется отображение типа протокола [режим протокола] и краткие сведения о регистрируемой информации. Можно изменить порядок в зависимости от способа просмотра протокола. | [%p] %m%n %d{дд МММ гггг ЧЧ:мм:сс:ССС} : сначала режим протокола | ||
Параметры раздела программы ведения протокола | |||
priority | Задает уровень режима ведения протокола для всей регистрации. Для выключения регистрации задайте для этого параметра значение "off" | off, fatal, error, warn, info, debug | |
appender-ref | В значении ref содержится имя целевых объектов вывода appender, определенное ранее в разделах appender. В зависимости от того, какие из всех определенных ранее appender должны быть включены для регистрации, определяются те имена appender, которые необходимо указать | <appender-ref ref="DOORSConsoleAppender"/> | |
Для того чтобы включить несколько объектов appender, следует создать несколько экземпляров тега <appender-ref>. | <appender-ref ref="SystemOutAppender"/> |