Настройка службы отправки предупреждений по электронной почте и jabber
Данный раздел является руководством по процессу конфигурирования службы отправки предупреждений на электронную почту (далее email) и jabber.
Настройка выполняется через интерфейс командной строки CLI (CoCon).
Описание системных команд приведено в разделах:
- /system/notifier/ - команды управления оповещениями по email и jabber на уровне системы
- /cluster/mediator/<MEDIATOR>/alarms/notifiers- команды для настройки параметров предупреждений по email
- /cluster/mediator/<MEDIATOR>/alarms/notifiers/jabber/ - команды для настройки параметров предупреждений по Jabber
Описание команд уровня виртуальной АТС:
- /domain/<DOMAIN>/notifier/ - команды управления настройками службы уведомлений по электронной почте или Jabber
- /domain/<DOMAIN>/alarms/notifiers/email/ - команды настройки параметров предупреждений, отправляемых по email
- /domain/<DOMAIN>/alarms/notifiers/jabber/ - команды настройки параметров предупреждений, отправляемых по Jabber
Настройка параметров подключения к серверу электронной почты
Установка адреса сервера электронной почты
- для администратора системы:
/system/notifier/set <DOMAIN> email_server <VALUE>
- для оператора виртуальной АТС:
/domain/<DOMAIN>/notifier/set email_server <VALUE>
где
<DOMAIN> - имя виртуальной АТС;
<VALUE> - название хоста или IP-адрес SMTP-сервера.
Пример
Установка параметров для сервера mail.eltex-co.ru с авторизацией:
admin@mycelium1@ecss1:/$ domain/biysk.local/notifier/set email_server mail.eltex-co.ru Property "email_server" successfully changed from: smtp.mail.ru to mail.eltex-co.ru. [exec at: 28.05.2019 08:46:17, exec time: 280ms, nodes: core1@ecss1
Установка порта сервера электронной почты
- для администратора системы:
/system/notifier/set <DOMAIN> email_port <VALUE>
- для оператора виртуальной АТС:
/domain/<DOMAIN>/notifier/set email_port <VALUE>
где
<DOMAIN> - имя виртуальной АТС;
<VALUE> - транспортный порт SMTP-сервера.
Пример
Настройка порта:
admin@mycelium1@ecss1:/$ domain/biysk.local/notifier/set email_port 13030 Property "email_port" successfully changed from: 465 to 13030. [exec at: 28.05.2019 08:01:59, exec time: 267ms, nodes: core1@ecss1
Установка криптографического протокола TLS, SSL.:
- для администратора системы:
/system/notifier/set <DOMAIN> email_protection_connection <VALUE>
- для оператора виртуальной АТС:
/domain/<DOMAIN>/notifier/set email_protection_connection <VALUE>
где
<DOMAIN> - имя виртуальной АТС;
<VALUE> - назначаемый протокол, принимает значения:
- ssl_tls - защита соединения по протоколу SSL/TLS;
- starttls - защита соединения STARTTLS;
- none - не использовать защищенное соединение.
Пример
Включение поддержки STARTTLS:
admin@mycelium1@ecss1:/$ domain/biysk.local/notifier/set email_protection_connection starttls Property "email_protection_connection" successfully changed from: ssl_tls to starttls. [exec at: 28.05.2019 08:11:12, exec time: 224ms, nodes: core1@ecss2
Установка имени пользователя для доступа к SMTP-серверу.
- для администратора системы:
/system/notifier/set <DOMAIN> email_username <VALUE>
- для оператора виртуальной АТС:
/domain/<DOMAIN>/notifier/set email_username <VALUE>
где
<DOMAIN> - имя виртуальной АТС;
<VALUE> - имя пользователя для подключение к электронной почте.
Пример
Установка имени пользователя для авторизации:
admin@mycelium1@ecss1:/$ domain/biysk.local/notifier/set email_username bsktest Property "email_username" successfully changed from: ecss10biysk@mail.ru to bsktest. [exec at: 28.05.2019 08:15:27, exec time: 288ms, nodes: md1@ecss1
Установка пароля для доступа к SMTP-серверу.
- для администратора системы:
/system/notifier/set <DOMAIN> email_password <VALUE>
- для оператора виртуальной АТС:
/domain/<DOMAIN>/notifier/set email_password <VALUE>
где
<DOMAIN> - имя виртуальной АТС;
<VALUE> - пароль для авторизации на SMTP-сервере.
Пример
Установка пароля для авторизации:
admin@mycelium1@ecss1:/$ domain/biysk.local/notifier/set email_password eltexPasswd Property "email_password" successfully changed from: bsk4SSW to eltexPasswd. [exec at: 28.05.2019 08:13:28, exec time: 284ms, nodes: core1@ecss1
Настройка формата писем, отправляемых службой
Установка адреса электронной почты отправителя.
- для администратора системы:
/system/notifier/set <DOMAIN> email <VALUE>
- для оператора виртуальной АТС:
/domain/<DOMAIN>/notifier/set email <VALUE>
где
<DOMAIN> - имя виртуальной АТС;
<VALUE> - адрес электронной почты отправителя.
Пример:
Установка адреса отправителя:
admin@mycelium1@ecss1:/$ domain/biysk.local/notifier/set email noreply@mail.eltex-co.ru Property "email" successfully changed from: noreply@eltex.loc to noreply@mail.eltex-co.ru. [exec at: 28.05.2019 08:48:11, exec time: 253ms, nodes: core1@ecss1
Настройка формата для темы почтового сообщения.
- для администратора системы:
/cluster/mediator/<CLUSTER>/alarms/notifiers/email/set <DOMAIN> subject_format <VALUE>
- для оператора виртуальной АТС:
/domain/<DOMAIN>/alarms/notifiers/email/set subject_format <VALUE>
где
<CLUSTER> - имя кластера с ролью MEDIATOR;<DOMAIN> - имя виртуальной АТС;
<VALUE> - формат темы сообщения, принимает значения:
- %CLASS% - класс предупреждения;
- %LOCATION% - место возникновения предупреждения;
- %INSTANCE% - экземпляр класса предупреждения;
- %SEVERITY% - важность предупреждения;
- %CAUSE% - причина предупреждения;
- %TEXT% - описание предупреждения;
- %TYPE% - тип предупреждения;
- %TIME% - время предупреждения.
Пример
Настройка формата для темы почтового сообщения:
admin@mycelium1@ecss1:/$ /cluster/mediator/md1/alarms/notifiers/email/set * subject_format ECSS1-ALARM (%SEVERITY%) Property "subject_format" successfully changed from: ALARM (%SEVERITY%) to ECSS1-ALARM (%SEVERITY%). [exec at: 28.05.2019 08:49:16, exec time: 156ms, nodes: md1@ecss2
Настройка формата содержимого почтового сообщения.
- для администратора системы:
/cluster/mediator/<CLUSTER>/alarms/notifiers/email/set <DOMAIN> body_format <VALUE>
- для оператора виртуальной АТС:
/domain/<DOMAIN>/alarms/notifiers/email/set body_format <VALUE>
где
<CLUSTER> - имя кластера с ролью MEDIATOR;
<DOMAIN> - имя виртуальной АТС;
<VALUE> - формат тела сообщения, принимает значения:
- %CLASS% - класс предупреждения;
- %LOCATION% - место возникновения предупреждения;
- %INSTANCE% - экземпляр класса предупреждения;
- %SEVERITY% - важность предупреждения;
- %CAUSE% - причина предупреждения;
- %TEXT% - описание предупреждения;
- %TYPE% - тип предупреждения;
- %TIME% - время предупреждения.
В теле сообщения поддерживаются спецсимволы \n, ~n, для перевода на новую строку.
Пример
Настройка формата содержимого почтового сообщения:
admin@mycelium1@ecss1:/$ cluster/mediator/md1/alarms/notifiers/email/set * body_format "Class: %CLASS% ~nLocation: %LOCATION% ~nInstance: %INSTANCE% ~nCause: %CAUSE% ~nType: %TYPE% ~nTime: %TIME% ~nText: %TEXT%" Property "body_format" successfully changed from: "Class: %CLASS% ~nLocation: %LOCATION% ~nInstance: %INSTANCE% ~nTime: %TIME% ~nText: %TEXT%" to "Class: %CLASS% ~nLocation: %LOCATION% ~nInstance: %INSTANCE% ~nCause: %CAUSE% ~nType: %TYPE% ~nTime: %TIME% ~nText: %TEXT%". [exec at: 28.05.2019 09:05:38, exec time: 154ms, nodes: md1@ecss1
Установка ограничения на длину темы почтового сообщения.
- для администратора системы:
/cluster/mediator/<CLUSTER>/alarms/notifiers/email/set <DOMAIN> subject_limit <VALUE>
- для оператора виртуальной АТС:
/domain/<DOMAIN>/alarms/notifiers/email/set subject_limit <VALUE>
где
<CLUSTER> - имя кластера с ролью MEDIATOR;
<DOMAIN> - имя виртуальной АТС;
<VALUE> - максимальное количество символов, которое может содержать тема сообщения.
Пример
Установка ограничения на длину темы сообщения:
admin@mycelium1@ecss1:/$ /cluster/mediator/md1/alarms/notifiers/email/set * subject_limit 40 Property "subject_limit" successfully changed from: 50 to 40. [exec at: 28.05.2019 09:07:04, exec time: 162ms, nodes: md1@ecss1
Установка ограничения на длину тела почтового сообщения.
- для администратора системы:
/cluster/mediator/<CLUSTER>/alarms/notifiers/email/set <DOMAIN> body_limit <VALUE>
- для оператора виртуальной АТС:
/domain/<DOMAIN>/alarms/notifiers/email/set body_limit <VALUE>
где
<CLUSTER> - имя кластера с ролью MEDIATOR;
<DOMAIN> - имя виртуальной АТС;
<VALUE> - максимальное количество символов, которое может содержать тело сообщения.
Пример
Установка ограничения на длину тела сообщения:
admin@mycelium1@ecss1:/$ /cluster/mediator/md1/alarms/notifiers/email/set * body_limit 1200 Property "body_limit" successfully changed from: 1000 to 1200. [exec at: 28.05.2019 09:08:04, exec time: 139ms, nodes: md1@ecss1
Настройка получателей уведомлений
Добавление получателя уведомлений.
- для администратора системы:
/cluster/mediator/<CLUSTER>/alarms/notifiers/email/set <DOMAIN> to add <name1@domain1>
- для оператора виртуальной АТС:
/domain/<DOMAIN>/alarms/notifiers/email/set to add <name1@domain1>
где
<CLUSTER> - имя кластера с ролью MEDIATOR;
<DOMAIN> - имя виртуальной АТС;
<name1@domain1> - адрес электронной почты получателя уведомлений.
Пример
Добавление получателей уведомлений(добавляется по одному адресу):
admin@mycelium1@ecss1:/$ /cluster/mediator/md1/alarms/notifiers/email/set biysk.local to add asz@sibnet.ru Property "to" successfully changed from: [] to ["asz@sibnet.ru"]. [exec at: 28.05.2019 09:19:52, exec time: 137ms, nodes: md1@ecss2
Удаление получателя уведомлений.
- для администратора системы:
/cluster/mediator/<CLUSTER>/alarms/notifiers/email/set <DOMAIN> to remove <name1@domain1>
- для оператора виртуальной АТС:
/domain/<DOMAIN>/alarms/notifiers/email/set to remove <name1@domain1>
где
<CLUSTER> - имя кластера с ролью MEDIATOR;
<DOMAIN> - имя виртуальной АТС;
<name1@domain1> - адрес электронной почты получателя уведомлений.
Пример
Удаление получателей уведомлений(по одному адресу):
admin@mycelium1@ecss1:/$ /cluster/mediator/md1/alarms/notifiers/email/set biysk.local to remove asz@sibnet.ru Property "to" successfully changed from: ["asz@sibnet.ru","test@eltex-co.ru"] to ["test@eltex-co.ru"]. [exec at: 28.05.2019 09:22:35, exec time: 138ms, nodes: md1@ecss2
Просмотр настроек, сброс настроек к заводским и пример содержимого отправляемого письма
Просмотреть текущие настройки для подключения к серверу:
/domain/<DOMAIN>/notifier/info
/system/notifier/info [* | <DOMAIN> [<Field>]]
где
<DOMAIN> - имя виртуальной АТС.
Пример
admin@mycelium1@ecss1:/$ domain/biysk.local/notifier/info ┌───────────────────────────┬───────────┬────────────────────────┐ │ Property │ Domain │ Value │ ├───────────────────────────┼───────────┼────────────────────────┤ │email │biysk.local│noreply@mail.eltex-co.ru│ │email_buffer_limit │biysk.local│50 │ │email_enable │biysk.local│false │ │email_password │biysk.local│eltexPasswd │ │email_port │biysk.local│13030 │ │email_protection_connection│biysk.local│starttls │ │email_resend_count_max │biysk.local│5 │ │email_resend_timer │biysk.local│30 │ │email_server │biysk.local│mail.eltex-co.ru │ │email_username │biysk.local│bsktest │ │jabber_buffer_limit │biysk.local│50 │ │jabber_enable │biysk.local│false │ │jabber_password │biysk.local│ylperon │ │jabber_port │biysk.local│5222 │ │jabber_reconnect_timer │biysk.local│10 │ │jabber_version │biysk.local│0.0 │ │jid │biysk.local│ecss-10@jabber.eltex.loc│ └───────────────────────────┴───────────┴────────────────────────┘ [exec at: 28.05.2019 09:46:43, exec time: 13ms, nodes: md1@ecss2
Просмотр настроек параметров уведомлений:
- для администратора системы:
/cluster/mediator/<CLUSTER>/alarms/notifiers/email/info
- для оператора виртуальной АТС:
/domain/<DOMAIN>/alarms/notifiers/email/info
где
<CLUSTER> - имя кластера с ролью MEDIATOR;
<DOMAIN> - имя виртуальной АТС.
Пример
admin@mycelium1@ecss1:/$ domain/biysk.local/alarms/notifiers/email/info ┌──────────────┬───────────┬────────────────────────────────────────────────────────────────────────────────┐ │ Property │ Domain │ Value │ ├──────────────┼───────────┼────────────────────────────────────────────────────────────────────────────────┤ │body_format │biysk.local│Class: %CLASS% ~nLocation: %LOCATION% ~nInstance: %INSTANCE% ~nTime: %TIME% ~nTe│ │ │ │xt: %TEXT% │ │body_limit │biysk.local│1000 │ │enabled │biysk.local│true │ │from_name │biysk.local│ECSS-NO-REPLY │ │subject_format│biysk.local│ALARM (%SEVERITY%) │ │subject_limit │biysk.local│50 │ │to │biysk.local│["asz@sibnet.ru"] │ │to_name │biysk.local│ECSS-SUPPORT │ └──────────────┴───────────┴────────────────────────────────────────────────────────────────────────────────┘ [exec at: 28.05.2019 09:53:02, exec time: 16ms, nodes: md1@ecss2
Пример получаемого письма:
Пользователю "asz@sibnet.ru" приходит письмо:
From ECSS-NO-REPLY<ecss10biysk@mail.ru> Subject ECSS1-ALARM (critical) To ECSS-SUPPORT<asz@sibnet.ru>
Class: ecss::pa::sip::user Location: sip1@ecss2 Instance: altke Time: 24/05/2019 15:06:30 Text: Connection with gateway is lost
Сброс настроек:
- для администратора системы:
/cluster/mediator/<CLUSTER>/alarms/notifiers/email/clean <DOMAIN> [<KEY>]
/system/notifiers/email/clean <DOMAIN> [<KEY>]
- для оператора виртуальной АТС:
/domain/<DOMAIN>/alarms/notifiers/email/clean [<KEY>]
/domain/<DOMAIN>/notifier/clean [<KEY>]
где
<CLUSTER> - имя кластера с ролью MEDIATOR;
<DOMAIN> - имя виртуальной АТС;
<КEY> - название параметра, для которого выполняется сброс настроек, опциональный параметр. Если параметр не указывать, то все настройки будут удалены.
Пример
Сброс настроек формата тела сообщения:
admin@mycelium1@ecss1:/$ cluster/mediator/md1/alarms/notifiers/email/clean * body_format Property body_format values successfully restored [exec at: 28.05.2019 09:50:28, exec time: 139ms, nodes: md1@ecss1
Настройка глобальных параметров администратором системы
Для установки интервала отправки уведомлений на электронную почту задается значение "alarmNotifyInterval" в минутах, по умолчанию установлено 5 минут. В течение заданного периода времени будет осуществляться кэширование сообщений о предупреждениях в системе. По истечении интервала отправляется последняя авария с самым большим severity. Затем считается, что аварий не было и заново повторяем описанный выше алгоритс.
/cluster/mediator/<CLUSTER>/properties/rpss/set <DOMAIN> alarmNotifyInterval <VALUE>
где
<CLUSTER> - имя кластера с ролью MEDIATOR;
<DOMAIN> - имя виртуальной АТС;
<NODE> - имя ноды;
<VALUE> - интервал отправки уведомлений на электронную почту, в минутах.
Пример
Установить интервал отправки уведомлений на электронную почту в 3 минуты:
admin@mycelium1@ecss1:/$ /cluster/mediator/md1/properties/rpss/set * alarmNotifyInterval 3 Property "alarmNotifyInterval" successfully changed from: 5 to 3. [exec at: 28.05.2019 10:02:11, exec time: 273ms, nodes: md1@ecss2
Для установки размера кэш процесса, осуществляющего рассылку уведомлений, установите значение "alarmNotifyCacheSize", по умолчанию установлено 30. Параметр "alarmNotifyCacheSize" определяет количество одновременно обрабатываемых сообщений о предупреждениях в системе.
/cluster/mediator/<CLUSTER>/properties/rpss/set <NODE> alarmNotifyCacheSize <VALUE>
где
<CLUSTER> - имя кластера с ролью MEDIATOR;
<DOMAIN> - имя виртуальной АТС;
<NODE> - имя ноды;
<VALUE> - количество одновременно обрабатываемых сообщений о предупреждениях в системе.
Пример
Установить количество одновременно обрабатываемых сообщений о предупреждениях для всех кластеров - 64:
admin@mycelium1@ecss1:/$ cluster/mediator/md1/properties/rpss/set md1@ecss1 alarmNotifyCacheSize 64 Property "alarmNotifyCacheSize" successfully changed from: 30 to 64. [exec at: 28.05.2019 21:54:44, exec time: 336ms, nodes: md1@ecss1
Просмотр информации о глобальных параметрах:
admin@mycelium1@ecss1:/$ cluster/mediator/md1/properties/rpss/info ┌────────────────────────┬────┬───────────────────────────┐ │ Property │Node│ Value │ ├────────────────────────┼────┼───────────────────────────┤ │alarmNotifyCacheSize │ │30 │ │alarmNotifyInterval │ │5 │ │alarmPanel │ │undefined │ │alarmPanelSignals │ │undefined │ │collectInterval │ │10 │ │collectProcPriority │ │normal │ │dbConnections │ │name: "stat_db" │ │ │ │provider: "mysql" │ │ │ │database: "ecss_statistics"│ │ │ │user: "statistics" │ │ │ │password: "statistics" │ │ │ │host: "192.168.1.71" │ │ │ │port: 3306 │ │ │ │addInfo: [] │ │defaultAlarmRowLimit │ │25 │ │exportEmptyReports │ │false │ │exportProcPriority │ │normal │ │parallelExportStatistics│ │false │ │snmpAgentEnable │ │false │ │statProcessingCount │ │5 │ │maxClearedAlarms │ │10000 │ └────────────────────────┴────┴───────────────────────────┘ [exec at: 28.05.2019 10:01:26, exec time: 12ms, nodes: md1@ecss1]
Активация службы администратором системы
После настройки выполняется включение отправки уведомлений:
/cluster/mediator/<CLUSTER>/alarms/notifiers/email/set enabled true
и разрешение отправки:
/domain/<DOMAIN>/notifier/email_enable true
/system/notifier/set <DOMAIN> email_enable true
где
<CLUSTER> - имя кластера с ролью MEDIATOR;
<DOMAIN> - имя виртуальной АТС;
Пример
admin@mycelium1@ecss1:/$ cluster/mediator/md1/alarms/notifiers/email/set biysk.local enabled true Property "enabled" successfully changed from: false to true. [exec at: 28.05.2019 10:07:53, exec time: 153ms, nodes: md1@ecss2
Уведомления по Jabber
Команды настройки уведомлений по Jabber для администратора системы аналогичны и приведены в справочнике команд CLI - /cluster/mediator/<MEDIATOR>/alarms/notifiers/jabber/ - команды для настройки параметров предупреждений по Jabber.
Для администратора виртуальной АТС - /domain/<DOMAIN>/alarms/notifiers/jabber/ - команды настройки параметров предупреждений, отправляемых по Jabber
Пример пошаговой настройки отправки уведомлений об авариях на email
Рассмотрим настройку уведомлений на примере для администратора виртуальной АТС.
Исходные данные:
| Параметр | Значение |
|---|---|
| SMTP-сервер | smtp.mail.ru |
| Порт | 465 |
| Имя пользователя | ecss10biysk@mail.ru |
| Пароль | ssw4Mail |
| Защита соединения | SSL/TLS |
| Получатели сообщения | asz@sibnet.ru |
| Шаблон темы сообщения | ALARM (%SEVERITY%) - %INSTANCE% |
| Шаблон содержимого сообщения | "Class: %CLASS% ~nLocation: %LOCATION% ~nInstance: %INSTANCE% ~nCause: %CAUSE% ~nType: %TYPE% ~nTime: %TIME% ~nText: %TEXT%" |
| Имя отправителя | ECSS-NO-REPLY |
| Имя получателя | ECSS-BSK |
| Имя виртуальной АТС | biysk.local |
Настройка
Прописываем доступ к SMTP-серверу:
Сервер
admin@mycelium1@ecss1:/domain/biysk.local$ cd /domain/biysk.local/notifier/ admin@mycelium1@ecss1:/domain/biysk.local/notifier$ ./set email_server smtp.mail.ru Property "email_server" successfully changed from: notifier.smtp.ecss to smtp.mail.ru. [exec at: 28.05.2019 11:51:56, exec time: 235ms, nodes: core1@ecss1]
Порт
admin@mycelium1@ecss1:/domain/biysk.local/notifier$ ./set email_port 465 Property "email_port" successfully changed from: default (25) to 465. [exec at: 28.05.2019 11:53:50, exec time: 255ms, nodes: md1@ecss2]
Адрес
admin@mycelium1@ecss1:/domain/biysk.local/notifier$ ./set email ecss10biysk@mail.ru Property "email" successfully changed from: noreply@eltex.loc to ecss10biysk@mail.ru. [exec at: 28.05.2019 11:55:43, exec time: 290ms, nodes: core1@ecss2]
Логин
admin@mycelium1@ecss1:/domain/biysk.local/notifier$ ./set email_username ecss10biysk@mail.ru Property "email_username" successfully changed from: noreply@eltex.loc to ecss10biysk@mail.ru. [exec at: 28.05.2019 11:57:42, exec time: 252ms, nodes: md1@ecss1]
Пароль
admin@mycelium1@ecss1:/domain/biysk.local/notifier$ ./set email_password ssw4Mail Property "email_password" successfully changed from: ylperon to ssw4Mounts. [exec at: 28.05.2019 11:57:42, exec time: 467ms, nodes: core1@ecss1]
Защита
admin@mycelium1@ecss1:/domain/biysk.local/notifier$ ./set email_protection_connection ssl_tls Property "email_protection_connection" successfully changed from: none to ssl_tls. [exec at: 28.05.2019 11:57:43, exec time: 425ms, nodes: md1@ecss2]
Включить нотификацию
admin@mycelium1@ecss1:/domain/biysk.local/notifier$ ./set email_enable true Property "email_enable" successfully changed from: false to true. [exec at: 28.05.2019 11:58:27, exec time: 283ms, nodes: core1@ecss1]
Имя отправителя
admin@mycelium1@ecss1:/$ domain/biysk.local/alarms/notifiers/email/set from_name ECSS-NO-REPLY Property "from_name" successfully changed from: ECSS-NO-REPLY to ECSS-NO-REPLY. [exec at: 28.05.2019 12:03:29, exec time: 152ms, nodes: md1@ecss1]
Получатель
admin@mycelium1@ecss1:/$ domain/biysk.local/alarms/notifiers/email/set to_name ECSS-BSK Property "to_name" successfully changed from: ECSS-SUPPORT to ECSS-BSK. [exec at: 28.05.2019 12:04:45, exec time: 151ms, nodes: md1@ecss1] admin@mycelium1@ecss1:/$ domain/biysk.local/alarms/notifiers/email/set to add asz@sibnet.ru Property "to" successfully changed from: [] to ["asz@sibnet.ru"]. [exec at: 28.05.2019 12:05:03, exec time: 170ms, nodes: md1@ecss1]
Настройка темы
admin@mycelium1@ecss1:/$ domain/biysk.local/alarms/notifiers/email/set subject_format ALARM (%SEVERITY%) - %INSTANCE% Property "subject_format" successfully changed from: ALARM (%SEVERITY%) to ALARM (%SEVERITY%) - %INSTANCE%. [exec at: 28.05.2019 12:07:27, exec time: 162ms, nodes: md1@ecss1]
Настройка тела сообщения
admin@mycelium1@ecss1:/$ domain/biysk.local/alarms/notifiers/email/set body_format "Class: %CLASS% ~nLocation: %LOCATION% ~nInstance: %INSTANCE% ~nCause: %CAUSE% ~nType: %TYPE% ~nTime: %TIME% ~nText: %TEXT%" Property "body_format" successfully changed from: Class: %CLASS% ~nLocation: %LOCATION% ~nInstance: %INSTANCE% ~nTime: %TIME% ~nText: %TEXT% to "Class: %CLASS% ~nLocation: %LOCATION% ~nInstance: %INSTANCE% ~nCause: %CAUSE% ~nType: %TYPE% ~nTime: %TIME% ~nText: %TEXT%". [exec at: 28.05.2019 12:08:04, exec time: 149ms, nodes: md1@ecss2]
Включить уведомления об авариях
admin@mycelium1@ecss1:/$ domain/biysk.local/alarms/notifiers/email/set enabled true Property "enabled" successfully changed from: false to true. [exec at: 28.05.2019 12:40:42, exec time: 136ms, nodes: md1@ecss1]
Проверяем настройки
admin@mycelium1@ecss1:/$ domain/biysk.local/notifier/info ┌───────────────────────────┬───────────┬────────────────────────┐ │ Property │ Domain │ Value │ ├───────────────────────────┼───────────┼────────────────────────┤ │email │biysk.local│ecss10biysk@mail.ru │ │email_buffer_limit │biysk.local│50 │ │email_enable │biysk.local│true │ │email_password │biysk.local│ssw4Mail │ │email_port │biysk.local│465 │ │email_protection_connection│biysk.local│ssl_tls │ │email_resend_count_max │biysk.local│5 │ │email_resend_timer │biysk.local│30 │ │email_server │biysk.local│smtp.mail.ru │ │email_username │biysk.local│ecss10biysk@mail.ru │ │jabber_buffer_limit │biysk.local│50 │ │jabber_enable │biysk.local│false │ │jabber_password │biysk.local│ylperon │ │jabber_port │biysk.local│5222 │ │jabber_reconnect_timer │biysk.local│10 │ │jabber_version │biysk.local│0.0 │ │jid │biysk.local│ecss-10@jabber.eltex.loc│ └───────────────────────────┴───────────┴────────────────────────┘ [exec at: 28.05.2019 12:40:04, exec time: 14ms, nodes: core1@ecss1]
admin@mycelium1@ecss1:/$ domain/biysk.local/alarms/notifiers/email/info ┌──────────────┬───────────┬────────────────────────────────────────────────────────────────────────────────┐ │ Property │ Domain │ Value │ ├──────────────┼───────────┼────────────────────────────────────────────────────────────────────────────────┤ │body_format │biysk.local│"Class: %CLASS% ~nLocation: %LOCATION% ~nInstance: %INSTANCE% ~nCause: %CAUSE% ~│ │ │ │nType: %TYPE% ~nTime: %TIME% ~nText: %TEXT%" │ │body_limit │biysk.local│1000 │ │enabled │biysk.local│true │ │from_name │biysk.local│ECSS-NO-REPLY │ │subject_format│biysk.local│ALARM (%SEVERITY%) - %INSTANCE% │ │subject_limit │biysk.local│50 │ │to │biysk.local│["asz@sibnet.ru"] │ │to_name │biysk.local│ECSS-BSK │ └──────────────┴───────────┴────────────────────────────────────────────────────────────────────────────────┘ [exec at: 28.05.2019 12:45:05, exec time: 23ms, nodes: md1@ecss2]
Отправка тестового сообщения
admin@mycelium1@ecss1:/$ domain/biysk.local/alarms/notifiers/email/send_test_email Send test alarm successfully [exec at: 28.05.2019 12:53:03, exec time: 33ms, nodes: md1@ecss1]
Генерация тестовой аварии
admin@mycelium1@ecss1:/$ domain/biysk.local/alarms/generate-alarm biysk test_alarm major noChange equipmentAlarm lowTemperatue test alarm msg
Alarm was sent.
[exec at: 28.05.2019 12:55:51, exec time: 12ms, nodes: md1@ecss1]
Alarm list changed at 28.05.2019 12:55:52:
critical: 4
major : 1
Выше был приведен пример настройки отправки уведомлений об авариях для определенного домена.
Примечание: при недоступности jabber-сервера ошибки пишутся в лог медиатора(каждое 10-е сообщение).
Для сбора и отправки предупреждений для всей системы используются команды:
- /system/notifier/ - команды управления оповещениями по email и jabber на уровне системы
- /cluster/mediator/<MEDIATOR>/alarms/notifiers- команды для настройки параметров предупреждений по email
- /cluster/mediator/<MEDIATOR>/alarms/notifiers/jabber/ - команды для настройки параметров предупреждений по Jabber
Порядок настройки такой же.