log_mgr set

Команда log_mgr set предназначена для изменения настройки уровня протоколирования всех событий, не включенных в группы, уровня протоколирования группы событий, задания группы событий и др.
Для выполнения опций: set -e требуются права root.

Синтаксис

log_mgr [-T timeout] set –l log_level

log_mgr [-T timeout] set –e [msg_group_file [-f]]

-T timeout

время ожидания ответа от vpnsvc сервиса. Допустимые значения – 10..36000 секунд, 0 – бесконечное время ожидания. Значение по умолчанию – 600 секунд.

-l log_level

установить уровень протоколирования всех событий, не включенных в группы событий. Имеет одно из возможных значений:

emerg  – аварийные сообщения,

alert – тревожные сообщения,

crit – критические сообщения,

err – сообщения об ошибках,

warning  – предупреждения,

notice – извещения,

info  – информационные сообщения,

debug  – отладочные сообщения.

–e

отменить установленный уровень протоколирования для группы событий (настройка сохраняется до перезапуска сервиса).

–e msg_group_file

установить уровень протоколирования для группы событий, перечисленных в файле msg_group_file (настройка сохраняется до перезапуска сервиса), msg_group_file – путь до файла msg_grpXXX.ini, в котором можно задать группу событий и уровень протоколирования для нее.

-f

(force) указание этой опции разрешает изменять файл с группой событий. По умолчанию опция не задана и изменение файла не допускается.

Значение по умолчанию

Значение по умолчанию отсутствует.

Рекомендации по использованию

1.    Задание общего уровня протоколирования всех событий, не включенных в группы, выполняется командой, например:

log_mgr set –l log_level

2.    Продукт поставляется с пятью предустановленными файлами, в которых указаны группы событий и уровень протоколирования для этих событий. Эти файлы созданы для совместимости с продуктом версии 3.1 и 3.11:

     msg_grpLDAP.ini – задан уровень протоколирования и идентификаторы событий, связанных с доступом к LDAP-серверу

     msg_grpSYSTEM.ini – задан уровень протоколирования и идентификаторы системных событий

     msg_grpPOLICY.ini – задан уровень лога и идентификаторы событий, связанных с применением политики безопасности протоколирования

     msg_grpCERTS.ini – задан уровень протоколирования и идентификаторы событий, связанных с сертификатами

     msg_grpKERNEL.ini – задан уровень протоколирования и идентификаторы событий, связанных с правилами фильтрации.

Для установки уровня протоколирования для группы событий, указанных в файле с заданным уровнем, обязательно выполните команду с опцией -f (например, для LDAP):

log_mgr set –e msg_grpLDAP.ini –f

Если отредактировать файл msg_grpLDAP.ini (или не редактировать) и повторно запустить команду без опции –f, то будет выдано сообщение об ошибке, так как редактирование указанного файла не допускается (опция –f разрешает редактирование).

Установленная настройка сохраняется до перезапуска сервиса. После перезапуска сервиса протоколирование этих событий будет происходить по общему уровню протоколирования.

Для сохранения настроек для группы событий после перезапуска сервиса, выполните команду:

log_mgr save

3.    Для отмены всех установленных ранее уровней протоколирования для всех групп событий, выполните команду:

log_mgr set e

Настройка сохраняется до перезапуска сервиса. Для сохранения настроек после перезапуска сервиса, выполните команду: log_mgr save. 

4.    Для задания группы событий, для которых требуется протоколирование, и уровня протоколирования для них, необходимо создать файл, состоящий из секций вида:

[LOGLEVEL.<LEVEL>]

<MSG_ID1>

<MSG_ID2>

!........

где

<LEVEL>   уровень протоколирования событий в группе

<MSG_ID> идентификатор события (сообщения)

!......        строка, начинающаяся с символа ‘!’, является комментарием. Допустимы пустые строки.

Таких секций в файле может быть несколько. Все события (сообщения) перечислены в файле s_log.ini из состава продукта. Каждое событие в файле имеет два эквивалентных представления – текстовое и в виде индекса (8 шестнадцатеричных цифр), например,

[MSG_ID_PRODUCT_START]

INDEX   = 0x03090001

Рекомендуется использовать текстовое представление, однако индекс может быть удобнее, если уже имеется файл, в котором сообщение содержит индекс.

Пример такого файла –msg_groupDEMO1.ini:

[LOGLEVEL.DEBUG]

!          сообщение PRODUCT_START задано его индексом:

03090001

!          сообщение PRODUCT_STOP задано его текстовым представлением:

PRODUCT_STOP

Каждое событие имеет свой фиксированный уровень важности (severity), указанный в файле s_log.ini. Severity может принимать значения (в порядке уменьшения важности) – emerg, alert, crit, err, warning, notice, info, debug. Событие, которому соответствует фиксированный уровень важности, протоколируется только в том случае, если его уровень важности не меньше заданного уровня протоколирования Level для группы.

Если в группу включены события с разными уровнями важности, то для того, чтобы выполнялось протоколирование по всем этим событиям, проще всего указать для группы Level=debug.

При установке Level=emerg блокируется протоколирование почти всех событий в группе, кроме имеющих уровень важности emerg.

Если необходимо изменить уровень важности для отдельного события, указанного в файле /opt/VPNagent/etc/s_log.ini рекомендуется не редактировать указанный файл, а создать файл типа  msg_XXX.ini  и уже в нем задать нужный уровень важности события.

Если необходимо изменить список событий в предустановленных файлах, то рекомендуется не редактировать предустановленные файлы, а скопировать подходящий из них, например, msg_groupMY.ini и уже его отредактировать с новым именем. А для исходного предустановленного файла применить команду отмены уровня протоколирования для группы событий:

log_mgr set –e msg_groupMY.ini

Пример

Например, для изменения фиксированного уровня протоколирования сообщения MSG_ID_AUDIT_SHOW_NEW_LSP с INFO на ERR, создаем в директории /opt/VPNagent/etc/ файл msg_LSPSHOW.ini, содержащий строки:

[LOGLEVEL.ERR]

MSG_ID_AUDIT_SHOW_NEW_LSP

Далее выполняем команды:

log_mgr set -e msg_LSPSHOW.ini

log_mgr save

При установке уровня протоколирования следует помнить, что самый высокий уровень детализации дает параметр 'debug', а самый низкий – параметр 'emerg'.

Пример

Пример выполнения команды log_mgr set: 

log_mgr set -l warning

Default log level is set successfully

5.    Существует группа сообщений (), протоколирование которых производит vpnlogsvc. Для таких сообщений описанный выше способ изменения фиксированного уровня протоколирования не работает: внесение изменений надо производить непосредственным редактированием файла s_log.ini, который располагается в каталоге Продукта (по умолчанию – /opt/VPNagent/etc/).

Информация, содержащаяся в файле s_log.ini имеет вид:

[ <MSG_ID mnemonic> ]

<Russian(Русские) UTF-8 comment lines for User's Manual>

SEVERITY  = EMERG | ALERT | CRIT | ERR | WARNING | NOTICE | INFO | DEBUG

INDEX     = 0x<module index><MSG_ID subindex 0001..ffff>

TMPL      = <message template>

NONBLOCKABLE = TRUE | FALSE

где

<MSG_ID mnemonic> –  текстовое представление идентификатора события, состоящее из заглавных латинских букв и знаков «_» и обязательно содержащее префикс "MSG_ID_"

<Russian(Русские) UTF-8 comment lines for User's Manual> строки, начинающиеся с символов "!!!", содержат описание или комментарии к событию

SEVERITY уровень важности протоколируемых событий.

INDEX – индекс сообщения, содержащий <module index> = 0001 | 0002 | 0003 | 0010 | 0020 | 0029 | 0032 | 005B | 0065 | 006F | 0072 | 0073 | 007F | 0079 | 0309 | 1000 | 0820..0820  | 0850..085C и <MSG_ID subindex> = 0001..ffff

TMPL шаблон сообщения

NONBLOCKABLE   опциональный атрибут, установка которого в “TRUE” гарантирует вывод сообщения при любых изменениях уровней важности (LogLevel) протоколируемых событий и изменениях параметров используемого syslog сервера. Т.е., если значение равно “TRUE”, то вывод сообщения не зависит от установленного общего уровня протоколирования. Значение по умолчанию – “FALSE”, т.е. вывод сообщения подчиняется общему установленному уровню аудита.

Пример отображения информации о протоколируемом событии в файле s_log.ini

[MSG_ID_LOG_SET_PARTICULAR_LOGLEVELS]

!!! Нефильтруемое сообщение об установке уровней важности некоторым сообщениям.

!!! Выдается при каждом их изменении и в начале сессии VPN Сервиса.

SEVERITY= INFO

INDEX   = 0x00020003

TMPL    = Some particular log levels are set

NONBLOCKABLE = TRUE

Пример редактирования файла s_log.ini

Например, для изменения уровня важности (severity) события, имеющего ID 0029000E, с INFO на DEBUG, необходимо открыть текстовый файл /opt/VPNagent/etc/s_log.ini  и найти раздел со строкой:

INDEX = 0x0029000E 

В данном разделе нужно изменить значение атрибута SEVERITY на необходимое:

SEVERITY = DEBUG 

Также, если для данного сообщения значение атрибута NONBLOCKABLE равно TRUE, то необходимо выставить его в FALSE:

NONBLOCKABLE = FALSE 

После сохранения файла s_log.ini необходимо пересчитать его контрольную сумму, используя утилиту integr_mgr calc:

integr_mgr calc –f s_log.ini

Перезапустите службы S-Terra VPN Service (vpnsvc) и S-Terra Firewall log service (vpnlogsvc).

 

Внимание!

Атрибут NONBLOCKABLE имеет значение TRUE лишь для групп событий, имеющих ID с 08530001 до 0853000A (раздел Installer for Unix) и с 00020001 до 00020005 (раздел Log), согласно Таблице 3 документа «Приложение А». При этом, изменение его на FALSE для событий из раздела Installer for Unix невозможно.

Полный список сообщений, изменение уровня важности (severity) которых происходит только путем внесения изменений в файл s_log.ini, представлен в таблице:

Таблица 7

MSG ID

Текстовое представление

Раздел

Уровень

00290001

MSG_ID_ON_IPSM_LOG_MID_FW_TCP_STATS_TRAIL

Firewall

INFO

00290002

MSG_ID_ON_IPSM_LOG_MID_FW_TCP_HCONN_ALERT

Firewall

WARNING

00290003

MSG_ID_ON_IPSM_LOG_MID_FW_TCP_HCONN_ALERT_OFF

Firewall

WARNING

00290004

MSG_ID_ON_IPSM_LOG_MID_FW_FTP_PORT_PRIV_PORT

Firewall

WARNING

00290005

MSG_ID_ON_IPSM_LOG_MID_FW_FTP_PASV_PRIV_PORT

Firewall

WARNING

00290006

MSG_ID_ON_IPSM_LOG_MID_FW_FTP_PORT_NOTAUTH

Firewall

WARNING

00290007

MSG_ID_ON_IPSM_LOG_MID_FW_FTP_PASV_NOTAUTH

Firewall

WARNING

00290008

MSG_ID_ON_IPSM_LOG_OTHERS

Firewall

DEBUG

00290009

MSG_ID_KLOGLIB_INIT_NO_MEMORY

Firewall

DEBUG

0029000A

MSG_ID_KLOGLIB_INIT_CANT_ATTACH

Firewall

DEBUG

0029000B

MSG_ID_KLOGLIB_INIT_CANT_SET_FILTER

Firewall

DEBUG

0029000C

MSG_ID_KLOGLIB_INIT_MISSED_ALERT_PACKETS

Firewall

WARNING

0029000D

MSG_ID_KLOGLIB_INIT_MISSED_PACKETS

Firewall

WARNING

0029000E

MSG_ID_KLOGLIB_INIT_PRINT_SUMMARY

Firewall

INFO

03090202

MSG_ID_LOGSRV_SET_SETTINGS_FAIL

<MAIN_APPLICATION>

WARNING

03090203

MSG_ID_LOGSRV_START

<MAIN_APPLICATION>

INFO

03090204

MSG_ID_LOGSRV_STOP

<MAIN_APPLICATION>

INFO