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 настраиваемых уведомлений):

Настраиваемые HTTP GET и SMS-уведомления в UniPing server solution v3SMS

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

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

Настраиваемые SMS-уведомления в UniPing server solution v3v4SMS

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

Настраиваемые HTTP GET уведомления в UniPing server solution v3v4SMS

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

Настраиваемые E-Mail-уведомления в UniPing server solution v3v4SMS

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

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

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

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

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

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

GSMSMS не командаВходящее 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.nnpThermoMemoПамятка термодатчикагде n  номер датчика 1..8.
{3}.1.3.6.1.4.1.25728.8800.1.1.3.nnpThermoStatusСтатус термодатчикагде 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.nnpThermoHighВерхняя граница диапазона нормальных значений температурыгде 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.