5.1. [DKSO 708.1.5] Настройка уведомлений

Страница «Уведомления»

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

Для настройки уведомлений необходимо перейти на страницу Система → Уведомления (Рис. 5.1.1.).

На странице отображается список существующих уведомлений с их основными параметрами и элементами управления:

• Вкл/выкл — чек-бокс для включения/отключения отправки уведомления. По умолчанию — выключено.

• Имя уведомления — название уведомления.

• Событие — источник, который инициирует процесс проверки условий для отправки уведомления.

• Метод — способ доставки уведомления.

• Настройки — кнопка вызова окна настройки уведомления.

• Удалить — кнопка удаления уведомления.

• Дублировать — кнопка для создания копии уведомления. Позволяет быстро создать похожее уведомление с сохранением большинства настроек.

Внимание! Имя уведомления должно быть уникальным. Если два уведомления имеют одинаковые имена, активным считается только первое из них. Остальные с таким же именем игнорируются, даже если условия их срабатывания выполнены.

Создание уведомления

Для создания уведомления нажать кнопку Добавить (Рис. 5.1.1.). Созданное уведомление с параметрами по умолчанию отобразится в списке уведомлений. Для редактирования параметров уведомления нажать кнопку Настройки. Откроется окно настройки уведомления (Рис. 5.1.2.):

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

Общие параметры для всех методов

• Имя уведомления — название уведомления.

• Событие — источник, который инициирует процесс проверки условий для отправки уведомления. Подробнее см. Описание событий.

• Условие — критерий или набор критериев, которые должны быть выполнены для отправки уведомления после регистрации события. Подробнее см. Описание условий.

• Метод — способ доставки уведомления. Подробнее см. Описание методов уведомлений.

• Форма интервалов времени работы уведомлений — форма для настройки интервалов времени, в которые разрешена отправка уведомления. Подробнее см. Интервалы времени работы уведомлений.

Параметры для метода Email

• От — email-адрес отправителя письма. Если не задан — используется адрес отправителя из настроек SMTP-сервера (Система → Настройки SMTP сервера).

• Кому — email-адрес или список email-адресов через запятую, на которые отправляется уведомление.

• Тема — тема письма.

• Подпись — подпись в тексте письма.

• Текст уведомления — текст письма. Поддерживаются переменные для подстановки данных.

Параметры для метода Syslog

• Текст уведомления — текст сообщения, отправляемый на Syslog-сервер. Поддерживаются переменные для подстановки данных. Подробнее см. Переменные для текста уведомлений.

• Префикс — текст, предваряющий основной текст уведомления, отправляемого на Syslog-сервер.

• Уровень — уровень важности сообщения (Severity level) в соответствии со стандартом Syslog.

Параметры для метода SNMP Trap

• Адрес — адрес SNMP-менеджера (IP-адрес или домен), на который будут отправляться уведомления.

• Порт — UDP-порт, на котором работает SNMP-менеджер. Стандартный порт для приёма trap-сообщений — 162.

• OID — числовой идентификатор события (например, .1.3.6.1.4.1.25728.8800.2.5.0), по которому менеджер определяет тип полученного уведомления.

Параметры для метода СМС

• Кому — телефонный номер в международном формате (например, +79123456789) или список телефонных номеров через запятую, на которые отправляется уведомление.

• Текст уведомления — текст смс сообщения. Поддерживаются переменные для подстановки данных. Подробнее см. Переменные для текста уведомлений.

Параметры для метода Webhook

• Адрес — URL или IP-адрес с указанием порта и пути (Endpoint).

• Запрос — HTTP-метод отправки: GET/POST.

После настройки уведомления нажать кнопку Сохранить.

Описание событий

Поддерживаются следующие типы событий:

Описание условий

Условие для отправки уведомления задаётся в виде логического выражения, которое проверяется при наступлении события. Если условие выполняется (результат — истина), уведомление отправляется.

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

• Переменных со специальным синтаксисом: %_имя_переменной_%

• Операторов сравнения: =, !=, >, <, >=, <=, IN

• Логических операторов: AND, OR, NOT

Внимание!

• Операторы AND, OR, NOT, IN не следует писать в смешанном регистре.

• Значение, с которым сравнивается переменная, необходимо писать в кавычках, в том числе числовые значения.

Каждое событие имеет следующие возможные переменные:

Используемые операторы:

Примеры условий

1. Простое условие для события Изменение состояния:

%_source_%="owrt_digital_inputs"

Уведомление отправляется, если значение source равно "owrt_digital_inputs"(событие от модуля входов).

2. Сложное условие с логическими операторами для события Изменение состояния:

(%_source_%="owrt_digital_inputs" OR %_source_%="owrt-digital-outs") AND (%_id_% in {"1","2","3","4"})

Уведомление отправляется, если одновременно выполняются условия:

• source равно "owrt_digital_inputs" или source равно "owrt-digital-outs" (событие от модуля входов или модуля выходов)

• id равно 1, 2, 3 или 4 (входы или выходы с ID от 1 до 4)

3. Сложное условие с логическими операторами для события Изменение состояния:

%_source_%="owrt_pingers" AND %_name_%="Rule" AND %_value_%="0"

Уведомление отправляется, если одновременно выполняются условия:

• source равно "owrt_pingers" (событие от модуля сторожа)

• name равно "Rule" (правило сторожа имеет название “Rule”)

• значение value равно 0 (логическое выражение правила сторожа ложно)

4. Условие с числовыми значениями для события Изменение температуры:

%_value_%>"30"

Уведомление отправляется, если значение value больше 30 (температура превышает 30°C).

5. Условие с числовыми значениями и логическим оператором для события Изменение влажности:

%_value_%<"30" OR %_value_%>="80"

Уведомление отправляется, если значение value меньше 30 (влажность менее 30%) или значение value больше или равно 80 (влажность равна или превышает 80%).

Описание методов уведомления

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

Текст уведомления для методов Email, Syslog, СМС позволяет динамически подставлять данные о событии, которое вызвало отправку уведомления. Например: номер входа, текущее значение, имя датчика и т.д.

Для этого в тексте уведомления используются специальные переменные, которые автоматически заменяются на актуальные значения при отправке.

Доступные переменные:

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

1. Изменение состояния входа.

   • Текст уведомления в настройках:

     CODE

     Реле %_name_% изменило состояние на %_value_%

   • Событие: Реле с именем PWR1 изменило состояние на Выключено

   • Результат в уведомлении:

     CODE

     Реле PWR1 изменило состояние на 0

2. Изменение температуры.

   • Текст уведомления в настройках:

     CODE

     Температура на датчике %_id_% равна %_value_% °C

   • Событие: температура на датчике с ID 3 равна 32°C

   • Результат в уведомлении:

     CODE

     Температура на датчике 3 равна 32 °C

Внимание! В тексте уведомления методом СМС использование кириллицы (русских букв) не поддерживается.

Интервалы времени работы уведомлений

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

По умолчанию для каждого уведомления задан интервал времени отправки с понедельника по воскресенье с 00:00:00 до 23:59:59 (ежедневно, круглосуточно) (Рис. 5.1.3.):

Для добавления интервала чек-боксами отметить дни недели, к которым применяется интервал (например, с понедельника по пятницу), в полях Старт и Стоп выбрать начало и конец временного периода, нажать кнопку Добавить интервал (Рис. 5.1.4.):

Для удаления интервала нажать кнопку X в строке с интервалом (Рис. 5.1.5.):

Внимание! После добавления интервалов времени отправки уведомления необходимо удалить интервал по умолчанию с круглосуточным охватом.

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

1. Настройка уведомления об изменении состояния входа с ID 1-4 или выхода с ID 1-4 методом Email (Рис. 5.1.6.):

Пример уведомления: при изменении состояния бинарного входа с ID 1 на Выключено на указанный email-адрес приходит сообщение с текстом вида (Рис. 5.1.7.):

2. Настройка уведомления о превышении температуры методом Syslog (Рис. 5.1.8.):

Пример уведомления: при повышении температуры более 30°C на датчике с ID 1 на сервер Syslog приходит сообщение вида:

2025-08-21T14:32:48+03:00 NetpingGSM Temperature Alert(Normal): Sensor 1: temperature = 31.9 °C

3. Настройка уведомления о недоступности ресурса методом СМС (Рис. 5.1.9.):

Пример уведомления: при невыполнении правила сторожа с названием FileServer на указанный номер телефона приходит смс-сообщение вида:

FileServer unavailable

4. Настройка уведомления о превышении влажности на датчике с ID 2 методом Webhook (на примере Telegram-бота) (Рис. 5.1.10.):

Пример уведомления: при повышении влажности более 70% на датчике с ID 2 в чат Telegram приходит сообщение вида:

Влажность на датчике 2 больше 70%

5. Настройка уведомления об изменении состояния встроенного реле с ID 5 методом SNMP trap (Рис. 5.1.11.):

Пример уведомления: при включении встроенного реле с ID 5 на указанный SNMP-менеджер приходит SNMP trap сообщение вида:

[OctetString] {"event": "statechanged", "name": "PWR1", "id": "5", "source": "owrt-digital-outs", "value": "1"}