Настройка файла регистрации сервера базы данных Rational DOORS

В Rational DOORS 9.5 обеспечивается возможность лучшего управления файлами регистрации сервера.

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

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

Регистрируемая в файлах протокола информация управляется с помощью файла конфигурации на основе XML; по умолчанию пример файла 'logging-config.xml' находится в корневом каталоге DOORS (например, C:\Program Files\IBM\Rational\DOORS\9.5); путь к файлу конфигурации должен быть представлен в записи 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

Файл 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"/>

Комментарии