Приложение D. Параметры шаблонов системы оповещения

Тексты сообщений (по электронной почте или с использованием Windows Messenger) генерируются компонентом Сервера, именуемым процессором шаблонов, на основе файлов шаблонов.

 

Система оповещений по сети Windows функционирует только на ОС Windows с поддержкой сервиса Windows Messenger (Net Send).

ОС Windows Vista и старше не поддерживают сервис Windows Messenger.

 

Файл шаблона состоит из текста и переменных, заключенных в фигурные скобки. При редактировании файлов шаблонов можно использовать перечисленные ниже переменные.

 

Процессор шаблонов не выполняет рекурсивных подстановок.

 

Переменные записываются в одной из следующих форм:

{<VAR>} – подставить непосредственно значение переменной <VAR>.

{<VAR>:<N>} – первые <N> символов переменной <VAR>.

{<VAR>:<first>:<N>}<N> символов переменной <VAR>, следующих после <first> первых (начиная с <first>+1-го символа), если остаток меньше – дополняется пробелами справа.

{<VAR>:<first>:-<N>}<N> символов переменной <VAR>, следующих после <first> первых (начиная с <first>+1-го символа), если остаток меньше – дополняется пробелами слева.

{<VAR>/<original1>/<replace1>[/<original2>/<replace2>]} – замена указанных символов переменной <VAR> на заданные значения: символы <original1> заменяются на символы <replace1>, при наличии символы <original2> заменяются на символы <replace2> и т.д.

Ограничений для числа пар подстановки не существует.

Форма записи переменных

Переменная

Значение

Выражение

Результат

SYS.TIME

10:35:17:456

{SYS.TIME:5}

10:35

SYS.TIME

10:35:17:456

{SYS.TIME:3:5}

35:17

SYS.TIME

10:35:17:456

{SYS.TIME:3:-12}

°°°35:17:456

SYS.TIME

10:35:17:456

{SYS.TIME:3:12}

35:17:456°°°

SYS.TIME

10:35:17:456

{SYS.TIME/10/99/35/77}

99:77:17:456

Условные обозначения

° - пробельный символ.

Системные переменные:

SYS.TIME — текущее системное время,

SYS.DATE — текущая системная дата,

SYS.DATETIME — текущие системная дата и время,

SYS.VERSION — версия Сервера,

SYS.BUILD — дата сборки Сервера,

SYS.PLATFORM — платформа Сервера,

SYS.PLATFORM.SHORT — краткий вариант SYS.PLATFORM,

SYS.OS — название операционной системы на компьютере с установленным Сервером,

SYS.BRANCH — версия Агентов и Сервера,

SYS.SERVER — название продукта (Dr.Web Enterprise Server).

Переменные окружения имеют те же имена, что и переменные, заданные в окружении, с добавлением префикса ENV. (префикс заканчивается на точку).

Общие переменные сообщений, Агент:

GEN.LoginTime — время подключения станции,

GEN.StationAddress — адрес станции,

GEN.StationID — UUID станции,

GEN.StationName — имя станции.

Общие переменные сообщений, подсистема обновлений Сервера:

GEN.CurrentRevision — текущий идентификатор версии,

GEN.NextRevision — идентификатор обновленной версии,

GEN.Folder — каталог размещения продукта,

GEN.Product — описание продукта.

Переменные сообщений, по сообщениям (для Агента):

Administrator_Authorization_Failed:

MSG.Login — регистрационное имя,

MSG.Address — сетевой адрес Центра Управления;

Approved_Newbie:

MSG.AdminName — имя администратора,

MSG.AdminAddress — адрес Центра Управления;

AutoApproved_Newbie: переменные отсутствуют;

Awaiting_Approval: переменные отсутствуют;

Cannot_Add_Station:

MSG.ID — UUID станции;

Connection_Terminated_Abnormally:

MSG.Reason — причина завершения;

Infection:

MSG.Component — имя компонента,

MSG.RunBy — пользователь, от имени которого запущен компонент,

MSG.ServerTime — время получения события, GMT,

MSG.ObjectName — имя инфицированного объекта,

MSG.ObjectOwner — владелец инфицированного объекта,

MSG.InfectionType — тип инфекции,

MSG.Virus — имя вируса,

MSG.Action — действие, предпринятое при обнаружении;

Installation_Bad:

MSG.Error — сообщение об ошибке;

Installation_OK: переменные отсутствуют;

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

MSG.Used — число станций в базе,

MSG.Licensed — разрешено лицензией;

Low_Var_Free_Space:

MSG.Path путь к каталогу с малым объемом памяти,

MSG.FreeSpace свободное место в байтах,

MSG.FreeInodes число свободных файловых дескрипторов inodes (имеет смысл только для некоторых систем семейства UNIX),

MSG.RequiredSpace необходимый для работы объем свободной памяти,

MSG.RequiredInodes —- необходимое для работы число свободных inodes (имеет смысл только для некоторых систем семейства UNIX);

Near_Max_Stations (отправляется при каждом запуске Сервера в том случае, если Сервер запущен с ключом, лицензирующим меньшее число станций, чем уже подключено к Серверу):

MSG.Usedчисло станций в базе,

MSG.Licensedразрешено лицензией,

MSG.Percent процент свободных лицензий;

Newbie_Not_Allowed: переменные отсутствуют;

Not_Seen_For_A_Long_Time:

MSG.StationName — название станции,

MSG.StationID — UUID станции,

MSG.DaysAgo — количество дней с момента последнего подключения к Серверу,

MSG.LastSeenFrom — адрес, с которого станция в последний раз подключалась к Серверу;

Processing_Error:

MSG.Component — имя компонента,

MSG.RunBy — пользователь, от имени которого запущен компонент,

MSG.ServerTime — время получения события, GMT,

MSG.ObjectName — имя объекта,

MSG.ObjectOwner — владелец объекта,

MSG.Error — сообщение об ошибке;

Rejected_Newbie:

MSG.AdminName — имя администратора,

MSG.AdminAddress — адрес Центра Управления;

Station_Already_Logged_In – отправляется, если станция в настоящее время уже зарегистрирована на этом или другом Сервере:

MSG.ID — UUID станции,

MSG.StationName — имя станции,

MSG.Server — ID Сервера, на котором станция зарегистрирована,

Station_Authorization_Failed:

MSG.ID — UUID станции,

MSG.Rejected — значения rejected — станции отказано в доступе, newbie — сделана попытка перевести станцию в состояние "новичок";

Statistics:

MSG.Component имя компонента,

MSG.ServerTime — время получения события, GMT,

MSG.Scanned — число просканированных объектов,

MSG.Infected — число инфицированных объектов,

MSG.Modifications — число объектов, инфицированных модификациями вирусов,

MSG.Suspicious — число подозрительных объектов,

MSG.Cured — число вылеченных объектов,

MSG.Deleted — число удаленных объектов,

MSG.Renamed — число переименованных объектов,

MSG.Moved — число перемещенных объектов,

MSG.Speed — скорость обработки в Kб/сек;

Too_Many_Stations отправляется, когда новая станция не может зарегистрироваться на Сервере из-за лицензионных ограничений:

MSG.ID — UUID станции,

Unknown_Administrator:

MSG.Login — регистрационное имя,

MSG.Address — сетевой адрес Центра Управления.

Unknown_Station:

MSG.ID — UUID неизвестной станции,

MSG.Rejected — значения rejected — станции отказано в доступе, newbie — сделана попытка перевести станцию в состояние "новичок";

Update_Failed:

MSG.Product — обновляемый продукт,

MSG.ServerTime — время (местное) получения сообщения Сервером;

Update_Wants_Reboot:

MSG.Product — обновляемый продукт,

MSG.ServerTime — время (местное) получения сообщения Сервером.

Переменные сообщений, по сообщениям (для подсистемы обновлений Сервера):

Srv_Repository_Cannot_flush: переменные отсутствуют;

Srv_Repository_UpToDate: переменные отсутствуют;

Srv_Repository_Frozen: переменные отсутствуют;

Srv_Repository_Load_failure:

MSG.Reason — сообщение о причине ошибки;

Srv_Repository_Update:

MSG.AdddedCount — количество добавленных файлов,

MSG.ReplacedCount — количество замененных файлов,

MSG.DeletedCount — количество удаленных файлов,

MSG.Added — список добавленных файлов (каждое наименование на отдельной строке),

MSG.Replaced — список замененных файлов (каждое наименование на отдельной строке),

MSG.Deleted — список удаленных файлов (каждое наименование на отдельной строке).

Srv_Repository_UpdateFailed:

MSG.Error — сообщение об ошибке,

MSG.ExtendedError — подробное описание ошибки.

 

Переменные последнего шаблона не включают файлы, помеченные как "игнорируемые при оповещениях" в конфигурационном файле продукта, см. F1. Синтаксис файла конфигурации .config.

 

Переменные сообщения Сервера о близком окончании срока действия лицензии:

Key_Expiration:

MSG.Expiration — дата окончания лицензии,

MSG.Expired — 1, если срок окончания уже наступил, иначе - 0,

MSG.ObjId — GUID объекта,

MSG.ObjName — имя объекта,

MSG.ObjType объект, использующий заканчивающийся ключ (server/station/group).