Настройка логирования (debug.conf)

Все логи ispmanager пишутся в каталог /usr/local/mgr5/var. При достижении максимального размера (по умолчанию 100Мб) содержимое лога перемещается в каталог /usr/local/mgr5/var/logs и пакуется в архив. К имени файла добавляется суффикс — дата и время создания, а также порядковый номер (на случай, если за секунду лог будет перемещён более одного раза). Оригинальный файл при этом обрезается и первой строкой в него записывается имя только что созданного архива.

Ispmanager позволяет гибко настраивать детализацию логов. Все настройки записываются в файл /usr/local/mgr5/etc/debug.conf. Он может содержать комментарии (все, что идёт после символа #), глобальные настройки (начинаются с префикса SET), и настройки детализации для отдельных модулей.

Из глобальных настроек доступны:

max_log_size — максимальный размер лога в байтах, при превышении которого он будет перемещен в каталог /usr/local/mgr5/var/logs;
color — использовать или не использовать цветные логи. Возможные значения on/off, по умолчанию — on;
storage — возможные значения:
- file — записывать лог в файл;
- console — выводить содержимое лога в stdout.

Примеры:

SET color=off # отключить цветные логи
SET mgrctl.max_log_size=1048576 # установить максимальный размер лога /var/mgrctl.log в один мегабайт

Настройка детализации имеет следующий формат:

<имя лога>[.<имя модуля>] <уровень детализации> [дополнительные условия]

Пояснения

<имя лога> — имя файла в каталоге /usr/local/mgr5/var. Как правило, совпадает с именем бинарника, который этот файл пишет.

<имя модуля> — различные компоненты библиотек libmgr или libispapi. Имеют различные внутренние имена.

<уровень детализации> — уровень детализации целое число в диапазоне от 1 (замечания) до 9 (максимально возможная детализация). Например, для отладки взаимодействия панели с внешними сервисами может быть полезно выставить максимальный уровень детализации для модуля rpc.

<дополнительные условия> — иногда бывает полезно поднять уровень детализации для определенных запросов. Например, вы можете потребовать писать детальную информацию только для запросов, приходящих от определенного пользователя или с определенного IP-адреса. Условия можно указать только для логов панелей управления. На данный момент в условиях можно использовать следующие значения: realuser, user, level, ip, action, id, displayname, realdisplayname.

Примеры:

* 6 # установить для всех модулей всех логов уровень детализации 6
mgrctl.* 5 # установить для mgrctl.log уровень детализации 5
ispmgr.* 9 ip=192.168.1.1 # установить для core.log уровень детализации 9, но только для запросов приходящих с адреса 192.168.1.1
ispmgr.* 9 user~test # установить для core.log уровень детализации 9, но только для запросов приходящих от пользователей в имени которых содержится подстрока test

При наличии нескольких конкурирующих правил те, в которых указано имя модуля, имеют приоритет над общими. В случае нескольких правил для определенного модуля — будет применено правило с максимальным уровнем детализации.

Настройки логирования читаются при старте приложения. Можно заставить панель перечитать настройки, послав ей сигнал HUP.

Уровни логирования:

# 1 - замечания;

# 2 - критические ошибки;

# 3 - ошибки;

# 4 - предупреждения;

# 5 - информация о запросах;

# 6 - расширенная информация;

# 7 - сообщения удаленных сервисов;

# 8 - трассировка кода;

# 9 - отладочная информация.

Ispmanager 6 lite, pro, host

Настройка логирования (debug.conf)