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

domain/test_domain/notifier/set email_server mail.eltex-co.ru
Property "email_server" successfully changed from: 
nitifier.smtp.ecss
   to
mail.eltex-co.ru

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

для администратора системы:
/system/notifier/set <DOMAIN> email_port <VALUE>

для оператора виртуальной АТС:
/domain/<DOMAIN>/notifier/set email_port <VALUE>

где

<DOMAIN> — имя виртуальной АТС;
<VALUE> — транспортный порт SMTP-сервера.

Пример

Настройка порта:

/$ domain/biysk.local/notifier/set email_port 13030    
Property "email_port" successfully changed from: 
465
   to
13030

Установка криптографического протокола 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:

/$ domain/biysk.local/notifier/set email_protection_connection starttls 
Property "email_protection_connection" successfully changed from: 
ssl_tls
   to
starttls

Установка имени пользователя для доступа к SMTP-серверу

для администратора системы:
/system/notifier/set <DOMAIN> email_username <VALUE>

для оператора виртуальной АТС:
/domain/<DOMAIN>/notifier/set email_username <VALUE>

где

<DOMAIN> — имя виртуальной АТС;
<VALUE> — имя пользователя для подключение к электронной почте.

Пример

Установка имени пользователя для авторизации:

/$ domain/biysk.local/notifier/set email_username bsktest
Property "email_username" successfully changed from: 
ecss10biysk@mail.ru
   to
bsktest

Установка пароля для доступа к SMTP-серверу

для администратора системы:
/system/notifier/set <DOMAIN> email_password <VALUE>

для оператора виртуальной АТС:
/domain/<DOMAIN>/notifier/set email_password <VALUE>

где

<DOMAIN> — имя виртуальной АТС;
<VALUE> — пароль для авторизации на SMTP-сервере.

Пример

Установка пароля для авторизации:

/$ domain/biysk.local/notifier/set email_password eltexPasswd
Property "email_password" successfully changed from:
bsk4SSW
to
eltexPasswd

Разрешение почтовых сервисов на отправку сообщений

В случае использовании таких почтовых сервисов как 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

/$ 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"

Для того, чтобы отправка сообщений работала требуется отредактировать настройки вашего почтового сервиса - дать разрешение для небезопасных приложений.

Во всех почтовых сервисах эти настройки располагаются в разных местах. Если вы не смогли найти их самостоятельно обратитесь в сервисный центр.

Для всех типов таких сервисов настоятельно рекомендуем использовать email_protection_connection ssl.

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

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

для администратора системы:
/system/notifier/set <DOMAIN> email <VALUE>

для оператора виртуальной АТС:
/domain/<DOMAIN>/notifier/set email <VALUE>

где

<DOMAIN> — имя виртуальной АТС;
<VALUE> — адрес электронной почты отправителя.

Пример:

Установка адреса отправителя:

/$ 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

Настройка формата для темы почтового сообщения

для администратора системы:
/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% — время предупреждения.

Пример

Настройка формата для темы почтового сообщения:

/$ /cluster/mediator/md1/alarms/notifiers/email/set * subject_format ECSS1-ALARM (%SEVERITY%)
Property "subject_format" successfully changed from: 
ALARM (%SEVERITY%)
   to
ECSS1-ALARM (%SEVERITY%)

Настройка формата содержимого почтового сообщения

для администратора системы:
/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, для перевода на новую строку.

Пример

Настройка формата содержимого почтового сообщения:

/$ 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%"

Установка ограничения на длину темы почтового сообщения

для администратора системы:
/cluster/mediator/<CLUSTER>/alarms/notifiers/email/set <DOMAIN> subject_limit <VALUE>

для оператора виртуальной АТС:
/domain/<DOMAIN>/alarms/notifiers/email/set subject_limit <VALUE>

где

<CLUSTER> — имя кластера с ролью MEDIATOR;
<DOMAIN> — имя виртуальной АТС;
<VALUE> — максимальное количество символов, которое может содержать тема сообщения.

Пример

Установка ограничения на длину темы сообщения:

/$ /cluster/mediator/md1/alarms/notifiers/email/set * subject_limit 40
Property "subject_limit" successfully changed from: 
50
   to
40

Установка ограничения на длину тела почтового сообщения

для администратора системы:
/cluster/mediator/<CLUSTER>/alarms/notifiers/email/set <DOMAIN> body_limit <VALUE>

для оператора виртуальной АТС:
/domain/<DOMAIN>/alarms/notifiers/email/set body_limit <VALUE>

где

<CLUSTER> — имя кластера с ролью MEDIATOR;
<DOMAIN> — имя виртуальной АТС;
<VALUE> — максимальное количество символов, которое может содержать тело сообщения.

Пример

Установка ограничения на длину тела сообщения:

/$ /cluster/mediator/md1/alarms/notifiers/email/set * body_limit 1200
Property "body_limit" successfully changed from: 
1000
   to
1200

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

Добавление получателя уведомлений

для администратора системы:
/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> — адрес электронной почты получателя уведомлений.

Пример

Добавление получателей уведомлений(добавляется по одному адресу):

/cluster/mediator/md1/alarms/notifiers/email/set biysk.local to add asz@sibnet.ru                    
Property "to" successfully changed from: 
[]
   to
["asz@sibnet.ru"]

Удаление получателя уведомлений

для администратора системы:
/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> — адрес электронной почты получателя уведомлений.

Пример

Удаление получателей уведомлений(по одному адресу):

/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"]

Просмотр настроек, сброс настроек к заводским и пример содержимого отправляемого письма

Просмотреть текущие настройки для подключения к серверу:

/domain/<DOMAIN>/notifier/info

/system/notifier/info [* | <DOMAIN> [<Field>]]

где

<DOMAIN> — имя виртуальной АТС.

Пример

/$ 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│
└───────────────────────────┴───────────┴────────────────────────┘

Просмотр настроек параметров уведомлений:

для администратора системы:
/cluster/mediator/<CLUSTER>/alarms/notifiers/email/info

для оператора виртуальной АТС:
/domain/<DOMAIN>/alarms/notifiers/email/info

где

<CLUSTER> — имя кластера с ролью MEDIATOR;
<DOMAIN> — имя виртуальной АТС.

Пример

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                                                                    │
└──────────────┴───────────┴────────────────────────────────────────────────────────────────────────────────┘

Пример получаемого письма:

Пользователю "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> — название параметра, для которого выполняется сброс настроек, опциональный параметр. Если параметр не указывать, то все настройки будут удалены.

Пример

Сброс настроек формата тела сообщения:

/$ cluster/mediator/md1/alarms/notifiers/email/clean * body_format    
Property body_format values successfully restored

Настройка глобальных параметров администратором системы

Для установки интервала отправки уведомлений на электронную почту задается значение "alarmNotifyInterval" в минутах, по умолчанию установлено 5 минут. В течение заданного периода времени будет осуществляться кэширование сообщений о предупреждениях в системе. По истечении интервала отправляется последняя авария с самым большим severity. Затем считается, что аварий не было и заново повторяем описанный выше алгоритм.

/cluster/mediator/<CLUSTER>/properties/rpss/set <DOMAIN> alarmNotifyInterval <VALUE>

где

<CLUSTER> — имя кластера с ролью MEDIATOR;
<DOMAIN> — имя виртуальной АТС;
<NODE> — имя ноды;
<VALUE> — интервал отправки уведомлений на электронную почту, в минутах.

Пример

Установить интервал отправки уведомлений на электронную почту в 3 минуты:

/$ cluster/mediator/md1/properties/rpss/set * alarmNotifyInterval 3
Property "alarmNotifyInterval" successfully changed from: 
5
   to
3

Для установки размера кэш процесса, осуществляющего рассылку уведомлений, установите значение "alarmNotifyCacheSize", по умолчанию установлено 30. Параметр "alarmNotifyCacheSize" определяет количество одновременно обрабатываемых сообщений о предупреждениях в системе.

/cluster/mediator/<CLUSTER>/properties/rpss/set <NODE> alarmNotifyCacheSize <VALUE>

где

<CLUSTER> — имя кластера с ролью MEDIATOR;
<DOMAIN> — имя виртуальной АТС;
<NODE> — имя ноды;
<VALUE> — количество одновременно обрабатываемых сообщений о предупреждениях в системе.

Пример

Установить количество одновременно обрабатываемых сообщений о предупреждениях для всех кластеров — 64:

/$ cluster/mediator/md1/properties/rpss/set md1@ecss1 alarmNotifyCacheSize 64
Property "alarmNotifyCacheSize" successfully changed from: 
30
   to
64

Просмотр информации о глобальных параметрах:

/$ cluster/mediator/md1/properties/rpss/info     
┌────────────────────────┬────┬─────────┐
│        Property        │Node│  Value  │
├────────────────────────┼────┼─────────┤
│alarmNotifyCacheSize    │    │30       │
│alarmNotifyInterval     │    │5        │
│alarmPanel              │    │undefined│
│alarmPanelSignals       │    │undefined│
│collectInterval         │    │10       │
│collectProcPriority     │    │normal   │
│dbConnections           │    │         │
│defaultAlarmRowLimit    │    │25       │
│exportEmptyReports      │    │false    │
│exportProcPriority      │    │normal   │
│maxClearedAlarms        │    │10000    │
│parallelExportStatistics│    │false    │
│snmpAgentEnable         │    │false    │
│statProcessingCount     │    │5        │
└────────────────────────┴────┴─────────┘

Активация службы администратором системы

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

/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> — имя виртуальной АТС;

Пример

/$ cluster/mediator/md1/alarms/notifiers/email/set biysk.local enabled true 
Property "enabled" successfully changed from: 
false
   to
true

Уведомления по 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-серверу:

Сервер

/domain/biysk.local$ cd /domain/biysk.local/notifier/
/domain/biysk.local/notifier$ ./set email_server smtp.mail.ru
Property "email_server" successfully changed from: 
notifier.smtp.ecss
   to
smtp.mail.ru

Порт

/domain/biysk.local/notifier$ ./set email_port 465
Property "email_port" successfully changed from: 
default (25)
   to
465

Адрес

/domain/biysk.local/notifier$ ./set email ecss10biysk@mail.ru
Property "email" successfully changed from: 
noreply@eltex.loc
   to
ecss10biysk@mail.ru

Логин

/domain/biysk.local/notifier$ ./set email_username ecss10biysk@mail.ru
Property "email_username" successfully changed from: 
noreply@eltex.loc
   to
ecss10biysk@mail.ru

Пароль

/domain/biysk.local/notifier$ ./set email_password ssw4Mail
Property "email_password" successfully changed from:
ylperon
to
ssw4Mounts

Защита

/domain/biysk.local/notifier$ ./set email_protection_connection ssl_tls
Property "email_protection_connection" successfully changed from:
none
to
ssl_tls

Включить нотификацию

/domain/biysk.local/notifier$ ./set email_enable true
Property "email_enable" successfully changed from:
false
to
true

Имя отправителя

/$ 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

Получатель

/$ 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"]

Настройка темы

/$ domain/biysk.local/alarms/notifiers/email/set subject_format ALARM (%SEVERITY%) - %INSTANCE%
Property "subject_format" successfully changed from: 
ALARM (%SEVERITY%)
   to
ALARM (%SEVERITY%) - %INSTANCE%

Настройка тела сообщения

/$ 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%"

Включить уведомления об авариях

/$ domain/biysk.local/alarms/notifiers/email/set enabled true 
Property "enabled" successfully changed from: 
false
   to
true

Проверяем настройки

/$ 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│
└───────────────────────────┴───────────┴────────────────────────┘

/$ 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                                                                        │
└──────────────┴───────────┴────────────────────────────────────────────────────────────────────────────────┘

Отправка тестового сообщения

/$ domain/biysk.local/alarms/notifiers/email/send_test_email                                                                       
Send test alarm successfully

Генерация тестовой аварии

/$ domain/biysk.local/alarms/generate-alarm biysk test_alarm major noChange equipmentAlarm lowTemperatue test alarm msg
Alarm was sent.

Выше был приведен пример настройки отправки уведомлений об авариях для определенного домена.

Примечание: при недоступности 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	Дополнительная информация.