Данный сервис используется для своевременного информирования технического персонала о возникновении предупреждений в системе 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

Настройка формата писем, отправляемых службой

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

для администратора системы:
/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-е сообщение).

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

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

Настройка службы отправки предупреждений по 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, необходимо настроить фильтр.
Фильтр используется для пересылки писем, которые поступают с адреса электронной почты отправителя, на мобильный почтовый адрес.

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