В данном разделе приводится описание команд, которые используются для настройки параметров сообщений о предупреждениях, отправляемых по электронной почте.

Предварительное условие - на системе должны быть включены уведомления. Команды приведены в разделе /system/notifier/ - команды управления службой нотификации
В таблице 1 приведено описание параметров службы уведомления по электронной почте.

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

Таблица 1 — Описание параметров сообщений о предупреждениях по электронной почте

ПараметрЗначение по умолчаниюОписание
body_format"Class: CLASS ~nLocation: LOCATION ~nInstance: INSTANCE ~nTime: TIME ~nText: TEXT"Формат тела сообщения
body_limit1000Ограничение количества символов тела сообщения
enabledfalseВключить или выключить уведомления
from_name"ECSS-NO-REPLY"Имя отправителя
subject_format"ALARM (SEVERITY)"Формат темы сообщения
subject_limit50Ограничение количества символов темы сообщения
toне заданоCписок получателей сообщений
to_name"ECSS-SUPPORT"Имя группы получателей сообщений

clean

Команда позволяет сбрасывать значения параметров службы уведомления по электронной почте.

Путь команды:

/cluster/mediator/<CLUSTER>/alarms/notifiers/email/clean

Синтаксис:

clean [<DomainName> [<Field>]] [--force]

Параметры:

<DomainName> —  название домена, для которого настраиваются сообщения;

<Field> —   название параметра, значение которого нужно установить по умолчанию. Опциональный параметр. Если параметр не указывать, то все значения будут установлены по умолчанию. Список параметров приведен в таблице 1.

--force — выполнение команды без запроса подтверждения.

Пример:

admin@mycelium1@ecss1:/$ cluster/mediator/md1/alarms/notifiers/email/clean biysk.local 
[clean] You are going to clean all customized properties in the domain "biysk.local".
Are you sure?: yes/no ?> yes
Properties values successfully restored

[exec at: 16.02.2021 11:10:57, exec time: 2s 614ms, nodes: md1@ecss1 v.3.14.7.585]

info

Команда просмотра текущих настроек службы уведомления по электронной почте.

Путь команды:

/cluster/mediator/<CLUSTER>/alarms/notifiers/email/info

Синтаксис:

info [* | <Domain> [<Field>]]

Параметры:

символ "*" используется для указания всех доменов;

<Domain>  — название домена, для которого настраиваются сообщения;

<Field> —  название параметра, значения приведены в таблице 1:

Пример:

admin@mycelium1@ecss1:/$ cluster/mediator/md1/alarms/notifiers/email/info a.test from_name              
┌─────────┬──────┬─────────────┐
│Property │Domain│    Value    │
├─────────┼──────┼─────────────┤
│from_name│a.test│ECSS-NO-REPLY│
└─────────┴──────┴─────────────┘

[exec at: 16.02.2021 09:03:05, exec time: 26ms, nodes: md1@ecss1 v.3.14.7.585]


admin@mycelium1@ecss1:/$ cluster/mediator/md1/alarms/notifiers/email/info a.test       
┌──────────────┬──────┬────────────────────────────────────────────────────────────────────────────────┐
│   Property   │Domain│                                     Value                                      │
├──────────────┼──────┼────────────────────────────────────────────────────────────────────────────────┤
│body_format   │a.test│Class: %CLASS% ~nLocation: %LOCATION% ~nInstance: %INSTANCE% ~nTime: %TIME% ~nTe│
│              │      │xt: %TEXT%                                                                      │
│body_limit    │a.test│1000                                                                            │
│enabled       │a.test│false                                                                           │
│from_name     │a.test│ECSS-NO-REPLY                                                                   │
│subject_format│a.test│ALARM (%SEVERITY%)                                                              │
│subject_limit │a.test│50                                                                              │
│to            │a.test│["ecss10biysk@mail.ru"]                                                         │
│to_name       │a.test│ECSS-SUPPORT                                                                    │
└──────────────┴──────┴────────────────────────────────────────────────────────────────────────────────┘

[exec at: 16.02.2021 08:46:38, exec time: 31ms, nodes: md1@ecss1 v.3.14.7.585]

send_test_email

Команда используется для отправки тестового email-сообщения.

Путь команды:

/cluster/mediator/<CLUSTER>/alarms/notifiers/email/send_test_email

Синтаксис:

send_test_email

Параметры:

Команда не содержит аргументов.

Пример:

admin@mycelium1@ecss1:/$ cluster/mediator/md1/alarms/notifiers/email/send_test_email                 
Send test alarm successfully

[exec at: 16.02.2021 10:54:00, exec time: 20ms, nodes: md1@ecss1 v.3.14.7.585]
Alarm list changed at 16.02.2021 10:54:01:
    critical: 3                       
    major   : 15       

set

Команда установки значения параметров службы уведомления по электронной почте.

Путь команды:

/cluster/mediator/<CLUSTER>/alarms/notifiers/email/set

Синтаксис:
set * | <DomainName> <Field> <Value>

Параметры:

символ "*" используется для указания всех доменов;

<Domain>  — название домена, для которого настраиваются сообщения;

<Field> —  название параметра, значения приведены в таблице 1;

<VALUE> — значение параметра.

Пример:

admin@mycelium1@ecss1:/$ cluster/mediator/md1/alarms/notifiers/email/set a.test to add ecss10biysk@mail.ru
Property "to" successfully changed from: 
[]
   to
["ecss10biysk@mail.ru"].

[exec at: 16.02.2021 08:45:41, exec time: 86ms, nodes: md1@ecss1 v.3.14.7.585]