Данный сервис используется для своевременного информирования технического персонала о возникновении предупреждений в системе ECSS-10.

Служба сообщает о том, где возникло предупреждение, и указывает степень ее приоритета.

Понятия, определения

  • SMTP (Simple Mail Transfer Protocol) — широко используемый сетевой протокол, предназначенный для передачи электронной почты в сетях TCP/IP.
  • SSL (Secure Sockets Layer) — криптографический протокол, который обеспечивает безопасность связи.
  • TLS (Transport Layer Security) — криптографический протокол, обеспечивающий защищённую передачу данных между узлами в сети Интернет.

Настройка службы отправки предупреждений по электронной почте и jabber

Данный раздел является руководством по процессу конфигурирования службы отправки предупреждений на электронную почту (далее email) и jabber.
Настройка выполняется через интерфейс командной строки CLI (CoCon).

Описание системных команд приведено в разделах:

Описание команд уровня виртуальной АТС:

Настройка параметров подключения к серверу электронной почты

Установка адреса сервера электронной почты

  • для администратора системы:
    /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" приходит письмо:

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//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-е сообщение).

Для сбора и отправки предупреждений для всей системы используются команды:

Порядок настройки такой же.

Настройка службы отправки предупреждений по 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Дополнительная информация.