9. [DKSF 5440] Поддержка устройством настраиваемых уведомлений
В web-интерфейсе устройства имеется возможность создания SMS-уведомлений с произвольным текстом (только для устройств NetPing 4/PWR-220 v8.1/GSM, NetPing 4/PWR-220 v8.2/GSM), в который можно включать дополнительно информацию о событии, вызвавшем уведомление. Настраиваемые уведомления работают параллельно со стандартными SMS- и email-уведомлениями с фиксированным текстом.
Кроме отправки SMS и email, настраиваемые уведомления позволяют сформировать HTTP GET-запрос, предназначенный дли интеграции NetPing с облачными сервисами. Например, с сервисом автоматизации Zapier.com или ifttt.com, что позволяет выполнить множество действий при получении соответствующих уведомлений. Более детально о том, какие возможности предоставляет Zapier.com, можно изучить по ссылке https://zapier.com/zapbook/webhook/ , а iftt.com по ссылке https://ifttt.com/discover .
NetPing не содержит HTTP/HTTPS клиента, и для выполнения запроса он обращается к проприетарному облачному сервису webhook.netping.ru. Он прозрачный, никак не запоминает и не накапливает прошедшую через него информацию. Доступен для любого устройства NetPing и не требует никакой предварительной авторизации и настройки.
Следует учитывать, что запросы к вызываемому сервису приходят из интернета, поэтому указывать нужно внешний адрес сервиса, а не адрес локальной сети.
Для создания настраиваемого уведомления необходимо зайти на страницу «УВЕДОМЛЕНИЯ» web-интерфейса устройства (Рис. 9.1.) и нажать на строку «кликните сюда для добавления новых данных» (максимум 16 настраиваемых уведомлений):
Рис. 9.1. Страница УВЕДОМЛЕНИЯ web-интерфейса устройства NetPing
Появится окно настройки уведомления со следующими параметрами (полный список параметров зависит от выбранного метода уведомления):
Вкл уведомление ― чекбокс включающий и отключающий уведомление, по умолчанию: вкл.
Датчик ― тип датчика и его номер/канал в выпадающем списке.
Событие ― триггер, по которому отправляется уведомление. Поддерживает мультивыбор.
Метод уведомления ― канал уведомления: E-mail, SMS, HTTP GET.
To ― адрес получателя письма, только для выбранного метода уведомления: e-mail. Подставляется автоматически, задаётся на странице E-MAIL web-интерфейса устройства. Более подробно описано в разделе «3.9. [DKSF 5440] Как получать уведомления и отчеты по электронной почте» данного руководства .
Subj ― тема отправляемого письма, только для выбранного метода уведомления: e-mail.
Текст/URL ― текст отправляемого уведомления. Правила составления текстов приведены ниже.
Примеры настроенных уведомлений от датчика температуры на канале 1:
SMS-уведомление (Рис. 9.2.):
Рис. 9.2. Пример настроенного SMS-уведомления от датчика температуры в web-интерфейсе устройства NetPing
HTTP GET-уведомление (Рис. 9.3.):
Рис. 9.3. Пример настроенного HTTP GET-уведомления от датчика температуры в web-интерфейсе устройства NetPing
Еmail-уведомление (Рис. 9.4.):
Рис. 9.4. Пример настроенного Еmail-уведомления от датчика температуры в web-интерфейсе устройства NetPing
Описание датчиков и событий
При использовании параметра «любой канал» рекомендуется использовать подстановку с номером канала, чтобы в уведомлении была информация о том, какой именно датчик вызывал это уведомление.
Датчик | Событие | Описание |
|---|---|---|
Термо 1...6 / любой канал | отказ датчика | Датчик неисправен или не подключен |
ниже нормы | Температура опустилась ниже нормы | |
в норме | Температура вернулась в норму | |
выше нормы | Температура поднялась выше нормы | |
Влажность (отн. влажн-ть) 1...4 / любой канал | отказ датчика | Датчик неисправен или не подключен |
ниже нормы | Отн. влажность опустилась ниже нормы | |
в норме | Отн. влажность вернулась в норму | |
выше нормы | Отн. влажность поднялась выше нормы | |
Влажность (температура) 1...4 / любой канал | отказ датчика | Датчик неисправен или не подключен |
ниже нормы | Температуры датчика влажности опустились ниже нормы | |
в норме | Температуры датчика влажности вернулись в норму | |
выше нормы | Температуры датчика влажности поднялись выше нормы | |
Линия IO 1...6 / любой канал | лог.0 | Логический уровень входа выбранной линии ввода-вывода переключился в 0 или в 1 |
лог.1 | ||
Реле 1...4 / любой канал | Выкл | Реле выключилось |
Вкл | Реле включилось | |
Сторож 1...4 / любой канал | сброс | Модуль «Сторож» выполнил сброс реле |
приостановка | Работа модуля «Сторож» приостановлена | |
возобновление | Работа модуля «Сторож» возобновлена | |
Сигнал 1...4 / любой канал | активация | Сигнал был активирован логикой. То есть сработало правило логики, выходом которого является «Сигнал 1...4». Подробней о правилах логики и, в частности, сигнале можно прочитать в разделе «8.2. [DKSF 5440] Как пользоваться модулем «Логика» данного документа |
Мониторинг 220V 1...3 / любой канал | изм. статуса напряжения | Напряжение вне пределов установленной нормы (подробнее в разделе «4.4. [DKSF 5440] Работа с датчиками качества электропитания» данного документа) |
изм. статуса частоты | Частота вне пределов установленной нормы (подробнее в разделе «4.4. [DKSF 5440] Работа с датчиками качества электропитания» данного документа) | |
изм. статуса провалов | Изменение статуса провалов напряжения (подробнее в разделе «4.4. [DKSF 5440] Работа с датчиками качества электропитания» данного документа) | |
изм. статуса импульсов напряжения | Изменение текущего статуса импульсов напряжения (подробнее в разделе «4.4. [DKSF 5440] Работа с датчиками качества электропитания» данного документа) | |
GSM | SMS не команда | Входящее SMS не является командой |
SMS с неизв. номера | Входящее SMS с неизвестного номера (при условии настройки белых списков номеров). Подробнее о настройке белых списков можно прочитать в разделе «10.2. [DKSF 5440] Как прописать номер для отправки SMS-уведомлений» данного документа |
Описание методов уведомления
Метод уведомления | Описание |
|---|---|
SMS | Произвольные SMS-уведомления. В начале текста настраиваемого SMS-уведомления можно задать до четырех адресатов, указав их номера телефонов в квадратных скобках через запятую. Номера указываются в формате «Код_страныКод_оператораНомер_абонента». Между закрывающей квадратной скобкой и текстом сообщения должен быть пробел. Например, «[+79130000001,+79130000002,+79130000003,+79130000004] Хьюстон, у нас проблема!» Если не указывать адресатов, то есть в начале текста отсутствуют квадратные скобки, SMS отправится на номера, заданные в настройках на странице SMS web-интерфейса устройства и отмеченные галочкой «Вкл». |
HTTP GET | Вызываемый URL стороннего сервиса или облачного приложения. Для отправки этих уведомлений используется схема: NetPing--SNMP TRAP --> webhook.netping.ru–HTTP(URL) --> сервер назначения. Поэтому к серверу назначения нужно обращаться по белому адресу и до него должен быть доступ извне. |
Отправка email-уведомления происходит на адреса, заданные на странице EMAIL web-интерфейса устройства. В настраиваемом уведомлении возможно задать тему сообщения в поле Subj (возможны подстановки) и текст самого email-сообщения. |
В текст настраиваемого уведомления можно включить информацию из ветки NetPing MIB, относящегося к датчику, IO-линии или реле, вызвавшему событие. Формат: {N}, где N — компонент SNMP OID, стоящий перед индексом датчика.
Например, текст SMS-уведомления «{6} - {3} ({4}°C - {5}°C), {2}°C» для датчика температуры включает следующую информацию из ветки NetPing MIB дерева:
Подстановка | Полный OID переменной из NetPing MIB | Имя переменной из NetPing MIB | Описание |
|---|---|---|---|
{6} | .1.3.6.1.4.1.25728.8800.1.1.6.n | npThermoMemo | Памятка термодатчика, где n — номер датчика 1...8. |
{3} | .1.3.6.1.4.1.25728.8800.1.1.3.n | npThermoStatus | Статус термодатчика, где n — номер датчика. |
{4} | .1.3.6.1.4.1.25728.8800.1.1.4.n | npThermoLow | Нижняя граница диапазона нормальных значений температуры, где n — номер датчика. |
{5} | .1.3.6.1.4.1.25728.8800.1.1.5.n | npThermoHigh | Верхняя граница диапазона нормальных значений температуры, где n — номер датчика. |
{2} | .1.3.6.1.4.1.25728.8800.1.1.2.n | npThermoValue | Текущая температура на термодатчике, где n — номер датчика. |
Дополнительно
В тексте SMS в настраиваемых уведомлениях по событиям от GSM (SMS не команда и SMS с неизв. номера) можно использовать следующие подстановки:
{11} — номер телефона отправителя.
{12} — текст SMS в кодировке 1251.
{13} — текст SMS в кодировке UTF8.