Настройка ведения протоколов
Важный аспект любого приложения сервера - ведение протокола. Контроллер агентов
поддерживает ведение протоколов как для отладки, так и для отчетов. Для этого
применяется отдельный файл протокола servicelog.log, который по умолчанию находится в подкаталоге config каталога контроллера агентов. Ведение протоколов можно настроить
Изменение каталога протоколов по умолчанию
В некоторых ситуациях необходимо изменить каталог, в котором по умолчанию
хранится файл протокола. Например, это требуется в системах, где
контроллер агентов установлен в файловой системе "только для чтения".
Для того чтобы изменить каталог, в котором по умолчанию хранится
файл протокола, выполните следующие действия:
- Найдите файл конфигурации serviceconfig.xml. См. связанную задачу.
- Откройте файл в редакторе и найдите в нем элемент <Logging>.
- Укажите новый каталог для хранения протоколов с помощью значение атрибута directory для данного элемента.
Изменение фильтров протокола
Для того чтобы указать, что в файле протокола должны регистрироваться
только сообщения определенного уровня, применяется простой фильтр протокола. Уровни регистрации определены ниже:
- SEVERE: В протокол заносятся только сообщения о неисправимых ошибках.
- CRITICAL: (по умолчанию) В протокол заносятся указанные выше сообщения, а также сообщения, указывающие на нормальное выполнение операций, прерванное ошибкой.
- WARNING: Записывает все отмеченные выше сообщения, а также сообщения о непредвиденных событиях, которые не должны мешать выполнению операции.
- INFORMATION: Записывает все указанные выше, а также сообщения об обычных собятиях, которые могут представлять интерес для пользователя.
- DEBUG: Записывает все указанное выше, а также сообщения, касающиеся подробного потока внутренних операций, используемых для устранения неполадок.
Для изменения фильтров протокола выполните следующие действия:
- В файле serviceconfig.xml найдите элемент <Logging>.
- Измените значение его атрибута level, указав в нем нужный уровень регистрации.
Изменение формата записываемых в протокол сообщений
Можно указать формат сообщений, записываемых в протокол, в виде обычного текста или CBE. Формат записи имеет следующие спецификации:
- CBE: (по умолчанию) Сообщения записываются в протокол с помощью формата событий общего формата. Сюда относится подробная информация о контексте и источнике каждого сообщения. Прочесть эти сообщения проще всего с помощью инструмента чтения протокола CBE.
- Simple: сообщения будут записаны в протокол в формате простого текста.
Для изменения формата записи сообщений в протокол, выполните следующие действия:
- В файле serviceconfig.xml найдите элемент <Logging>.
- Измените значение атрибута формата на один из описанных выше форматов, исходя из своих потребностей.
Связанные задачи
Определение расположения файлов конфигурации
Администрирование контроллера агентов