14. [DKSF 70/71.7 IU] Поддержка устройством настраиваемых уведомлений

В web-интерфейсе устройства имеется возможность создания настраиваемых уведомлений (SMS EMail) с произвольным текстом, в который можно включать дополнительно информацию о событии, вызвавшем уведомление. Настраиваемые уведомления работают параллельно со стандартными 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-интерфейса устройства и нажать на строку «кликните сюда для добавления новых данных» (максимум 16 настраиваемых уведомлений):

Появится окно настройки уведомления со следующими параметрами (на скриншоте ниже изображено уже настроенное уведомление от датчика температуры на канале 5).

SMS-уведомление:

HTTP GET-уведомление:

Еmail-уведомление:

Описание датчиков и событий:

При использовании номера канала «любой канал» рекомендуется использовать подстановку с номером канала, чтобы в уведомлении была информация о том, какой именно датчик вызывал это уведомление.
Датчик Событие Описание
Термо 1..8 / любой канал отказ датчика Датчик неисправен или не подключен
ниже нормы Температура опустилась ниже нормы
в норме Температура вернулась в норму
выше нормы Температура поднялась выше нормы
Влажность (отн. влажн-ть) 1..4 / любой канал отказ датчика Датчик неисправен или не подключен
ниже нормы Отн. влажность опустилась ниже нормы
в норме Отн. влажность вернулась в норму
выше нормы Отн. влажность поднялась выше нормы
Влажность (температура) 1..4 / любой канал отказ датчика Датчик неисправен или не подключен
ниже нормы Температуры датчика влажности опустились ниже нормы
в норме Температуры датчика влажности вернулись в норму
выше нормы Температуры датчика влажности поднялись выше нормы
Дым (аналог. ток. петля)  норма Показания в норме
Тревога!

Датчик определил наличие дыма

отказ (обрыв) Обрыв токовой петли
отказ (КЗ) Короткое замыкание токовой петли
обесточен Датчик (токовая петля) обесточен
Аналоговый вход (1W) 1...4 / любой канал отказ 1W Адаптер неисправен или не подключен
ниже нормы

Значение наблюдаемого параметра опустилось ниже нижнего диапазона нормы

норма Значение наблюдаемого параметра вошло в диапазон нормы
выше нормы Значение наблюдаемого параметра поднялось выше верхней границы диапазона нормы
вне раб. диапазона Значение наблюдаемого параметра вышло за пределы рабочего диапазона
Линия IO 1..8 / любой канал Лог.0 Логический уровень линии переключился в 0
Лог.1 Логический уровень линии переключился в 1
Реле Выкл Реле выключилось
Вкл Реле включилось
Сторож сброс Модуль «Сторож» выполнил сброс реле
приостановка Работа модуля приостановлена
возобновление Работа модуля возобновлена
Сигнал 1..4 / любой канал активация Сигнал был активирован логикой. То есть сработало правило логики, выходом которого является «Сигнал 1..4». Подробней о правилах логики и, в частности, сигнале можно прочитать в разделе «13.2. [DKSF 70/71.7 IU] Как пользоваться модулем «Логика»?» 
Мониторинг 220V изм. статуса напряжения Изменение статуса напряжения
изм. статуса частоты Изменение статуса частоты
изм. статуса провалов Изменение статуса провалов
изм. статуса импульсов напряжения Изменение статуса импульсов (пиков) напряжения
GSM SMS не команда Входящее SMS не является командой
SMS с неизв. номера Входящее SMS с неизвестного номера (при условии настройки белых списков номеров). Подробнее о настройке белых списков можно прочитать в разделе «11.2. [DKSF 70/71.7 IU] Мне нужно прописать номер для отправки SMS-уведомлений. Как это сделать?» 

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

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

Произвольные SMS-уведомления. В начале текста настраиваемого SMS-уведомления можно задать до четырех адресатов, указав их номера телефонов в квадратных скобках через запятую. Номера указываются в формате «Код_страныКод_оператораНомер_абонента». Между закрывающей квадратной скобкой и текстом сообщения должен быть пробел. Например, «[+79130000001,+79130000002,+79130000003,+79130000004] Хьюстон, у нас проблема!»

Если не указывать адресатов, то есть в начале текста отсутствуют квадратные скобки, SMS отправится на номера, заданные в настройках на странице «SMS» web-интерфейса устройства и отмеченные галочкой «Нотиф».

HTTP GET Вызываемый URL стороннего сервиса или облачного приложения. Для отправки этих уведомлений используется схема: NetPing--SNMP TRAP --> webhook.netping.ru–HTTP(URL) --> сервер назначения. Поэтому к серверу назначения нужно обращаться по белому адресу и до него должен быть доступ извне.
email Отправка email-уведомления происходит на адреса, заданные на странице «EMAIL». В настраиваемом уведомлении возможно задать тему сообщения в поле «Subj» (возможны подстановки) и текст самого email-сообщения. Адресата задать нельзя, сообщения отправляются адресатам, заданным на странице «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.