Отправка любых SMS уведомлений при помощи NetPing из PRTG Network Monitor

Устройства с расширенными возможностями и встроенным GSM модемом: шлюз для отправки и приёма SMS-команд NetPing SMS, устройство удалённого мониторинга датчиков по сети UniPing server solution v3/SMS и устройство удалённого управления розетками электропитания NetPing 8/PWR-220 v3/SMS имеют возможность отправки произвольных SMS-уведомлений при помощи HTTP API. Это нововведение можно применить в работе системы мониторинга PRTG Network Monitor для отправки SMS-уведомлений о наступлении определенных событий на объектах наблюдения. В результате, при организации такой системы SMS-уведомлений в системе мониторинга PRTG Network Monitor можно значительно экономить на альтернативных сервисах рассылки SMS-уведомлений, доступных в интернете.

Требования

Для реализации вышеописанного функционала необходимы:

• шлюз для отправки и приёма SMS-команд NetPing SMS с установленной SIM картой или устройство удалённого мониторинга датчиков UniPing server solution v3/SMS с установленной SIM картой, или устройство удалённого управления розетками электропитания NetPing 8/PWR-220 v3/SMS с установленной SIM картой;
• подготовленный скрипт на PowerShell для отправки произвольных SMS-уведомлений о событиях в системе мониторинга PRTG Network Monitor;
• настроенная система мониторинга PRTG Network Monitor
  Для получения информации по настройке системы PRTG можно обратиться к статье «Пример мониторинга серверной комнаты на основе PRTG и устройств NetPing»)

Настройка PRTG Network Monitor

Для того, чтобы настроить SMS-уведомления в системе мониторинга PRTG при помощи HTTP API, необходимо перейти по вкладке «Setup» в основные настройки системы:

На странице настроек системы PRTG в области «ACCOUNT SETTINGS» нужно зайти в «Notifications». В «Notifications» настраиваются все уведомления:

Для получения доступа к странице «Notifications» система предложит ввести имя пользователя и пароль администратора системы:

После успешной авторизации появится таблица «NOTIFICATIONS», в которую нужно добавить новое уведомление нажатием кнопки «Add new notification»:

На странице настройки нового уведомления «Add notification» указать название уведомления в поле «Notification Name», например, «SMS Notification» и нажать чек-бокс «EXECUTE PROGRAM». В области настройки «EXECUTE PROGRAM» требуется заполнить параметры.

где:
Program File – выбрать исполняемый файл из выпадающего списка (в данном случае скрипт PowerShell для отправки произвольных SMS-уведомлений). PRTG будет запускать этот файл каждый раз при возникновении условий срабатывания для данного уведомления. Для того, чтобы из выпадающего списка выбрать подготовленный заранее скрипт, его нужно разместить по следующему пути: «C:\Program Files (x86)\PRTG Network Monitor\Notifications\EXE». Если система мониторинга PRTG состоит из кластера серверов, то исполняемый файл необходимо скопировать по выше приведенному пути на каждый сервер в кластере. Это предотвратит проблему отправки SMS-уведомлений, когда один или несколько серверов в кластере находятся в неработоспособном состоянии.
Parameter – прописать параметры, которые будут переданы исполняемому файлу при запуске. Для устройств NetPing необходимо указать номер абонента в квадратных скобках и текст SMS через пробел для отправки SMS-уведомления. В тексте SMS допускается использовать системные переменные PRTG Network Monitor. Список всех переменных можно посмотреть здесь.
Timeout – время, через которое работа исполняемого файла прекратится при условии, если процесс выполнения скрипта завис.

После заполнения всех параметров нового уведомления необходимо сохранить настройки нажатием кнопки «Save».

В результате новое уведомление появится в таблице «Notification»:

Чтобы созданное SMS-уведомление работало, его нужно применить к необходимым сенсорам или устройствам в системе PRTG.

Рассмотрим пример применения SMS-уведомления, которое будет срабатывать при пропадании и появлении устройства в локальной сети. Для этого нужно выбрать необходимое устройство в PRTG, которое проверяется на доступность командой «Ping». Выбор производится на странице «Devices»:

На странице «Devices» из списка устройств, настроенных на мониторинг, для примера выберем устройство «Mail Server». Выбор осуществляется нажатием курсора мыши по названию устройства:

Откроется страница «Device Mail Server», в которой перечислены все сенсоры данного устройства. Как видно из скриншота ниже, устройство «Mail Server» настроено только на проверку доступности посредством команды «Ping»:

Для применения созданного уведомления «SMS Notification» необходимо нажать на сенсор «Ping» и перейти на вкладку «Notifications»:

На вкладке «Notifications» настраивается реакция на изменение статуса сенсоров выбранного устройства. Для получения SMS-уведомления при изменении состояния сенсора «Ping» необходимо добавить триггер нажатием кнопки «Add State Trigger» и заполнить соответствующие поля:

где:
1 – условие, при котором будет вызвано уведомление. В этом примере триггер будет активирован, когда сенсор находится в состоянии «Down»;
2 – интервал времени, через который сработает триггер. Этот интервал позволяет избежать ложных срабатываний;
3 – метод отправки уведомлений при срабатывании триггера;
4 – метод отправки уведомлений, когда условие перестает выполняться;
5 – сохранение параметров триггера

Настройка устройств NetPing SMS, UniPing server solution v3/SMS и NetPing 8/PWR-220 v3/SMS

Для отправки SMS-уведомлений в случае примера (то есть при помощи устройств NetPing SMS, UniPing server solution v3/SMS, NetPing 8/PWR-220 v3/SMS, которые выступают в роли SMS гейта) необходимо выполнить всего лишь часть базовой настройки (настроить сетевые параметры для доступа по сети) устройств NetPing SMS, UniPing server solution v3/SMS, NetPing 8/PWR-220 v3/SMS и установить рабочую SIM карту с положительным балансом в разъем встроенного GSM модема. Прочитать про базовую и дополнительную настройку устройств можно в следующей документации:

• NetPing SMS - описание встроенного ПО DKSF 707.2 IU;
• UniPing server solution v3/SMS - описание встроенного ПО DKSF 70.4 IU
• NetPing 8/PWR-220 v3/SMS - описание встроенного ПО DKSF 48.4 IU

Пример скрипта на PowerShell для отправки произвольных SMS-уведомлений о событиях в системе мониторинга PRTG Network Monitor

Ниже представлен код скрипта на PowerShell. Его нужно скопировать в текстовый файл и сохранить с расширением «.ps1» по следующему пути: «C:\Program Files (x86)\PRTG Network Monitor\Notifications\EXE».

$url = "http://192.168.0.100/sendsms.cgi?utf8"
$username = "visor"
$password = "ping"

foreach ($arg in $args)
{
Write-Host "Arg: $arg";
}

$req = [System.Net.WebRequest]::Create($url)
$req.Method = "POST";

$req.Credentials = new-object System.Net.NetworkCredential($username, $password)

$Body = [System.Text.Encoding]::UTF8.GetBytes($arg);

$stream = $req.GetRequestStream();
$stream.Write($Body, 0, $Body.Length);

$stream.Flush();
$stream.Close();

$resp = $req.GetResponse().GetResponseStream()
$resp.Close() 

где:

$url – переменная, в которую задается IP адрес устройства NetPing и скрипт для отправки произвольных SMS-сообщений.
$username – переменная, в которую задается имя пользователя для авторизации на устройстве NetPing.
$password – переменная, в которую задается пароль для авторизации на устройстве NetPing.

Результат

В результате вышеописанных настроек организации отправки SMS-уведомлений о событиях в системе мониторинга PRTG Network Monitor при использовании SMS-гейта на основе устройств NetPing SMS, UniPing server solution v3/SMS или NetPing 8/PWR-220 v3/SMS обслуживающий персонал будет получать SMS-сообщения такого вида:

• Устройство UniPing server solution v3/SMS
• Устройство NetPing SMS