Приложение 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).