Управление системой информирования о предупреждениях
Данный сервис используется для своевременного информирования технического персонала о возникновении предупреждений в системе ECSS-10.
Служба сообщает о том, где возникло предупреждение, и указывает степень ее приоритета.
Понятия, определения
- SMTP (Simple Mail Transfer Protocol) — широко используемый сетевой протокол, предназначенный для передачи электронной почты в сетях TCP/IP.
- SSL (Secure Sockets Layer) — криптографический протокол, который обеспечивает безопасность связи.
- TLS (Transport Layer Security) — криптографический протокол, обеспечивающий защищённую передачу данных между узлами в сети Интернет.
Настройка службы отправки предупреждений по электронной почте и jabber
Данный раздел является руководством по процессу конфигурирования службы отправки предупреждений на электронную почту (далее email) и jabber.
Настройка выполняется через интерфейс командной строки CLI (CoCon).
Описание системных команд приведено в разделах:
- /system/notifier/ — команды управления оповещениями по email и jabber на уровне системы
- /cluster/mediator/<MEDIATOR>/alarms/notifiers — команды для настройки параметров предупреждений по email
- /cluster/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
Разрешение почтовых сервисов на отправку сообщений
В случае использовании таких почтовых сервисов как gmail, yandex и т.д. может возникнуть проблема с аутентификацией. Ecss10 notifier для таких сервисов является не безопасным приложением.
Ошибка проявляется следующим образом:
Для сервера smtp.yandex.ru
admin@[mycelium1@eltex#ECSS-D-MECHANIC]:/$ domain/test.domain/notifier/send_test_msg email yopet70424@shackvine.com privchedel Error: connection "smtp.yandex.ru" refused with "503 5.5.4 Error: send AUTH command first. 1645512330-aOaTNwc7bV-jUHmK81a\r\n" [exec at: 22.02.2022 13:45:30, exec time: 620ms, nodes: core1@eltex v.3.14.11.79]
Для сервера smtp.gmail.com
admin@[mycelium1@eltex#ECSS-D-MECHANIC]:/$ domain/test.domain/notifier/send_test_msg email yopet70424@shackvine.com privchedel Error: connection "smtp.gmail.com" refused with "530-5.7.0 Authentication Required. Learn more at\r\n530 5.7.0 https://support.google.com/mail/?p=WantAuthError w10sm1295324lfu.200 - gsmtp\r\n" [exec at: 22.02.2022 13:49:08, exec time: 980ms, nodes: core1@eltex v.3.14.11.79]
Для того, чтобы отправка сообщений работала требуется отредактировать настройки вашего почтового сервиса - дать разрешение для небезопасных приложений.
Во всех почтовых сервисах эти настройки располагаются в разных местах. Если вы не смогли найти их самостоятельно обратитесь в сервисный центр.
Для всех типов таких сервисов настоятельно рекомендуем использовать email_protection_connection ssl.
Настройка формата писем, отправляемых службой
Установка адреса электронной почты отправителя
- для администратора системы:
/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/
Для администратора виртуальной АТС — /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/
/alarms/notifiers/jabber/ — команды для настройки параметров предупреждений по Jabber
Порядок настройки такой же.
Настройка службы отправки предупреждений по SMS
Для отправки сообщений о предупреждениях по SMS необходимо, чтобы предварительно была настроена служба передачи предупреждений по электронной почте (описание по настройке приведено выше).
Услуга «e-mail to SMS» позволяет абонентам принимать электронную почту (e-mail) на мобильный телефон в виде SMS-сообщений. При подключении услуги «e-mail to SMS» автоматически предоставляется персональный электронный почтовый ящик.
Адрес почтового ящика будет зависеть от мобильного оператора (например, 7xxxххххххх@sms.mtslife.ru,7xxxxxxxxxx@sms.beemail.ru и другие, где ххххxxxxxx — 10 цифр номера мобильного телефона в федеральном формате).
После подключения услуги у мобильного оператора в настройках почтового ящика, на который отправляются уведомления от системы ECSS-10, необходимо настроить фильтр.
Фильтр используется для пересылки писем, которые поступают с адреса электронной почты отправителя, на мобильный почтовый адрес.
Настройка адреса отправителя описана в разделе Настройка службы отправки предупреждений по электронной почте и jabber, пункт Настройка формата писем, отправляемых службой (шаг 1. Установка адреса электронной почты отправителя).
Мобильный почтовый адрес будет получен в SMS-сообщении при подключении услуги у оператора.
Описание структуры сообщений о предупреждениях
В данном разделе приведено описание структуры сообщений о предупреждениях.
Таблица 1 — Описание структуры сообщения о предупреждении
Поле | Описание |
---|---|
ID | Уникальный идентификатор предупреждения. Служебная информация. |
Class | Класс предупреждения. Описывается в виде: Класс::Подкласс1::...::ПодклассN. Примеры: ecss::pa::sip::user ecss::cluster::core::cp HW::Disks ecss::cluster ecss::cluster::node ecss::oasys::mnesia ecss::pa::megaco::gateway |
Instance | Экземпляр класса предупреждения. Пример: идентификатор call-process, название кластера, название шлюза. |
Location | Местоположение подсистемы, которая сгенерировала предупреждение: название подсистемы, название кластера, название хоста. |
User | Имя пользователя, выставившего/сбросившего предупреждение. Системные предупреждения выставляются и сбрасываются от имени "[system]". |
Date | Дата и время возникновения предупреждения. |
Cleared | Дата и время сброса предупреждения. |
Cause | Тип причины предупреждения. Возможные значения: - communicationsSubsystemFailure — коммуникации; - configurationOrCustomizationError — конфигурация; - outOfService — вывод из обслуживания; - softwareError — программная ошибка; - storageCapacityProblem — система хранения; - other — другая причина (не была отнесена к выше перечисленным). |
Type | Тип предупреждения. Допустимые значения: - communicationsAlarm — предупреждение, связанное с коммуникациями; - qualityOfServiceAlarm — предупреждение, связанное с качеством сервиса; - processingErrorAlarm — предупреждение, связанное с обработкой; - equipmentAlarm — предупреждение, связанное с оборудованием; - environmentalAlarm — предупреждение, связанное с окружением; - integrityViolation — предупреждение, связанное с неконсистентной информацией; - operationalViolation — предупреждение, связанное с некорректной работой; - physicalViolation — предупреждение, связанное с физическими нарушениями (например, выход оборудования из строя); - securityServiceOrMechanismViolation — предупреждение, связанное с безопасностью (например, несанкционированный доступ); - timeDomainViolation — предупреждение, связанное с возникновением несвоевременных или запрещенных событий; - other — другая (не была отнесена к выше перечисленным). |
Problems | В текущей версии ПО не используется. |
Severity | Уровень важности предупреждения. Допустимые значения: - cleared — предупреждение сброшено; - indeterminate — уровень предупреждения не определен; - critical — критическое предупреждение; - major — важный уровень предупреждения; - minor — незначительный уровень предупреждения; - warning — предупреждение. |
BackedupStatus | В текущей версии ПО не используется. |
BackupObject | В текущей версии ПО не используется. |
Trend | Тенденция изменения важности предупреждения. Допустимые значения: - noChange — без изменений; - lessSevere — уменьшение важности; - moreSevere — увеличение важности. |
Threshold | В текущей версии ПО не используется. |
NotificationIdentifier | В текущей версии ПО не используется. |
CorrelatedNotifications | В текущей версии ПО не используется. |
StateChangeDefinition | В текущей версии ПО не используется. |
MonitoredAttributes | В текущей версии ПО не используется. |
ProposedRepairActions | Предполагаемые действия для исправления предупреждения. В текущей версии ПО не используется. |
Message | Сообщение о предупреждении. |
AdditionalInformation | Дополнительная информация. |