4.6. [DKSF 707.3 IU] Какие SMS-команды и SMS-уведомления поддерживает устройство?

NetPing SMS может принимать различные SMS-команды и отправлять SMS-уведомления при наступлении различных событий. Уведомления рассылаются на телефонные номера, указанные на странице «НАСТРОЙКИ GSM» web-интерфейса устройства.

Формат SMS-команды

Запрос значения SNMP-переменной (SNMP GET запрос):

np snmp variable? password

Установка SNMP-переменной (SNMP SET команда):

np snmp variable=value password

где:

np snmp — префикс команды.

variable — короткое имя SNMP-переменной, заданное на странице «ПЕРЕМЕННЫЕ» web-интерфейса устройства.

value — значение для записи в SNMP-переменную. Поддерживаются только целые числа. Допустимо указание текстового значения из словаря.

password — значение параметра «Community», указанного на странице «НАСТРОЙКИ» web-интерфейса любого устройства NetPing.

Между переменной и знаком «?» не должно быть пробелов, вокруг знака «=» не должно быть пробелов. Текст команды нечувствителен к регистру, можно применять строчные и прописные латинские буквы. Элементы команды разделяются пробелами. Недопустимо использование символов «» (апостроф), «» (кавычка),  «@», «_» (подчеркивание). Включение этих символов может вызвать сбой прошивки. Выполнение команды подтверждается ответным сообщением (см. ниже).

Формат SMS-ответа

Ответ на запрос значения SNMP-переменной:

NP SNMP REPLY variable=value

Ответ на установку SNMP-переменной:

NP SNMP DONE variable=value

где:

variable — короткое имя SNMP-переменной, заданной на странице «ПЕРЕМЕННЫЕ» web-интерфейса устройства;

value — значение SNMP-переменной и его расшифровка из словаря (если применимо).

Примеры ответных сообщений:

NP SNMP DONE heater=off(0)

NP SNMP REPLY t4=28

SMS-сообщения об ошибке

Параметр password в SMS-команде не соответствует значению «Community» на странице «НАСТРОЙКИ» web-интерфейса устройства NetPing. Пароль проверяется с учетом регистра:

NP SNMP ERR Wrong password, access denied


<переменная> отсутствует в таблице SNMP-переменных на странице «ПЕРЕМЕННЫЕ» web-интерфейса устройства:

NP SNMP ERR Unknown variable '<переменная>'


<переменная> ссылается на хост, отсутствующий в таблице хостов (агентов) на странице «АГЕНТЫ» web-интерфейса устройства:

NP SNMP ERR Unknown agent '<хост>' for var '<переменная>'


Устройство не смогло получить IP-адрес агента по его доменному имени <fqdn>:

NP SNMP ERR DNS failed for '<fqdn>'

Получение IP-адреса не завершено, невозможно, или DNS-сервер не знает такого хоста.

Процедура определения IP-адресов для доменного имени запускается при сохранении любых изменений в таблице хостов (агентов) на странице «АГЕНТЫ» web-интерфейса устройства. То есть IP-адреса определяются заранее для всех вписанных в таблицу хостов и хранятся «про запас». Повторный запрос производится по окончании периода жизни записи в кеше DNS.


Нет ответа от <fqdn_or_ip> после трех попыток выполнить SNMP-операцию. Тайм-аут выполнения SNMP-операции — 2 секунды:

NP SNMP ERR No reply for '<переменная>' from '<fqdn_or_ip>'


Поле <ошибка snmp> выставляется на основе кода ошибки из SNMP reply PDU:

NP SNMP ERR Reply '<ошибка snmp>’ for ‘<исходная операция>’

Поле <ошибка snmp> может иметь вид:

  • Too big data — слишком большой запрос, нет ресурсов для его обработки;
  • No such OID 'id' — у агента нет такого OID;
  • Bad value — значение не может быть записано в OID, либо не соответствует тип или размер;
  • Read only — агент отказал в записи;
  • Unknown error — другие ошибки.

Например:

NP SNMP ERR Reply ‘Read only’ for ‘temp4=25’


Ошибка возникает при попытке прочитать нецелочисленное значение. На данный момент можно читать только целочисленные переменные:

NP SNMP ERR Non-integer value returned for ‘<переменная>’

где:

<переменная> — короткое имя переменной, указанное в SMS-команде.


<значение>, указанное в SMS-команде variable=value, не может быть проинтерпретировано как целое число, и не удалось найти соответствия этому значению в словаре для переменной, если было задано текстовое значение:

NP SNMP ERR Bad value '<значение>' in sms

Поименованные значения (словарь) задаются в таблице переменных на странице «ПЕРЕМЕННЫЕ» web-интерфейса устройства.

Пример словаря:

flip(-1), off(0), on(1), unknown(255)


Ошибка при разборе команды устройством. Наиболее вероятно, неправильный текст исходной команды:

NP WRONG CMD: "исходная команда"

где:

Исходная команда — текст исходной SMS-команды, полностью заключенный в кавычки.

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

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

np_name (q) информация 

где:

np_name — имя устройства для идентификации SMS-сообщений. Задается на странице «НАСТРОЙКИ» web-интерфейса устройства. Если имя устройства не задано, то применяется имя «NETPING».

 последовательный номер сообщений. Номер энергонезависим — не обнуляется при отключении питания. Служит для регистрации пропущенных (потерянных) сообщений.

Информация — информационная часть SMS-уведомлений.

Информационная часть SMS-уведомлений

Сообщение о потере и восстановлении связи проверяемого узла в сети (смотреть модуль «Пингер» на странице «НАСТРОЙКИ GSM» web-интерфейса устройства):

PINGER STATUS: OK (IP/HOST)

PINGER STATUS: FAILED (IP/HOST)