Самостоятельно расширить NET SNMP можно несколькими способами

Создание сабагента AgentX (AgentX subagent)

Subagent это независимое приложение которое осуществляет обработку специфических параметров и предоставляет их SNMP агенту по протоколу AgentX (RFC 2741). Многие производители программного обеспечения, распространяют сабагент в комплекте со своим ПО, например Sybase предоставляет SQL Server SNMP Subagent вместе со своим сервером БД. Если сабагента нет, его можно создать самому. Проще всего сделать это с помощью библиотеки libnetsnmpagent (AgentX Library). Сгенерировать скелет агента можно с помощью программы mib2c, для этого надо иметь MIB файл, описывающий параметры которые нам предстоит мониторить. В состав пакета net-snmp входит скрипт net-snmp-config. Этот скрипт, запущенный с параметром –compile-subagent, позволяет легко скомпилировать вашу программу-сабагент.

% net-snmp-config --compile-subagent mysubagent nstAgentSubagentObject.c
generating the tmporary code file: netsnmptmp.12259.c
checking for init_nstAgentSubagentObject in nstAgentSubagentObject.c
init_nstAgentSubagentObject(void)
running: gcc  -Dlinux -I. -I/usr/local/include -o nstAgentSubagentObject
 netsnmptmp.12259.c  nstAgentSubagentObject.c -L/usr/local/lib
 -lnetsnmpagent -lnetsnmphelpers -lnetsnmpmibs -lnetsnmp
netsnmptmp.12259.c: In function `main':
netsnmptmp.12259.c:26: warning: implicit declaration
 of function `init_nstAgentSubagentObject'
removing the tmporary code file: netsnmptmp.12259.c
subagent program nstAgentSubagentObject created

В результате компиляции получится программа mysubagent. Эту программу следует запускать после старта snmpd. Для того что бы включить поддержку протокола AgentX в snmpd.conf следует добавить строку «master agentx». Функционал сабагента, можно вынести в отдельную программу, а можно сделать частью вашей программы, как сделано, например, в Asterisk. Модуль, выполняющий функции сабагента в Asterisk, называется res_snmp.

Создание модуля DLO (Dynamically Loadable Object)

Другой вариант расширения net-snmp – написание модуля, который будет динамически подгружаться во время запуска snmpd. Данный подход имеет свои преимущества и недостатки. К преимуществам можно отнести: доступность всего API snmpd внутри модуля, возможность использовать общие конфигурационные файлы, отсутствие необходимости следить за порядком запуска приложений (сначала snmpd, затем сабагент). Самый явный недостаток – ошибки в модуле могут скомпрометировать весь сервис snmpd.

Модуль DLO это программа, скомпилированная как разделяемый объект (SO). Существует ряд требований, которые должна удовлетворять данная программа. В программе должны присутствовать функции:

void init_nstAgentPluginObject (void);

и обратная ей

void deinit_nstAgentPluginObject (void);

Эти функции вызываются автоматически после загрузки и перед выгрузкой модуля. nstAgentPluginObject – это имя загружаемого модуля, будет различаться от модуля к модулю. Загрузить модуль можно двумя способами: через командную строку -

snmpd -f -L -DnstAgentPluginObject,dlmod

Или же с помощью специальной записи в snmpd.conf

dlmod nstAgentPluginObject /path/to/nstAgentPluginObject.so

Здесь второе поле – имя модуля. Для того что бы snmpd мог загрузить модуль, имя модуля должно быть корректным (совпадать с именами функций init_ и deinit_)

Расширение SNMPD с помощью скриптов

Пожалуй, самый распространённый способ представления собственных данных через snmpd – расширение с помощью скриптов. Для подключения скрипта к snmpd, в файл snmpd.conf необходимо добавить следующую строку:

pass .1.3.6.1.4.1.2021.255 /bin/sh /usr/local/bin/passtest

Данная строка состоит из 3х полей. 1 поле – ключевое слово «pass», оно указывает snmpd на то, что все запросы, адресованные к веткам входящим в указанное дерево, передавать внешней программе. 2ое поле позволяет указать дерево, контроль над которым мы передаём. 3е поле, это программа и её параметры. Внешняя программа может быть написана на любом языке – это не имеет никакого значения. Единственное требование, предъявляемое к программе, – возможность принимать параметры из командной строки, и выводить результаты на стандартный вывод в определённом формате. SNMPd передает программе 2 параметра, 1ый может принимать значения «-s» или «-n». Параметр «-s» означает, что никаких действий предпринимать не надо, параметр «-n» говорит о том, что за ним следует запрашиваемый OID. Рассмотрим логику работы и формат вывода на примере shell скрипта passtest, распространяемого вместе с net-snmp.

#!/bin/sh -f
 
PATH=$path:/bin:/usr/bin:/usr/ucb
 
PLACE=".1.3.6.1.4.1.2021.255"
REQ="$2"
 
if [ "$1" = "-s" ]; then
  echo $* >> /tmp/passtest.log
  exit 0
fi
 
if [ "$1" = "-n" ]; then
  case "$REQ" in
    $PLACE)      RET=$PLACE.1 ;;
    $PLACE.1)    RET=$PLACE.2.1 ;;
    $PLACE.2.1)  RET=$PLACE.2.2 ;;
    $PLACE.2.2)  RET=$PLACE.3 ;;
    $PLACE.3)    RET=$PLACE.4 ;;
    $PLACE.4)    RET=$PLACE.5 ;;
    $PLACE.5)    RET=$PLACE.6 ;;
    *)           exit 0 ;;
  esac
else
  case "$REQ" in
    $PLACE)    exit 0 ;;
    *)         RET=$REQ ;;
  esac
fi
 
echo "$RET"
case "$RET" in
  $PLACE.1) echo "string"; echo "life the universe and everything"; exit 0 ;;
  $PLACE.2.1) echo "integer"; echo "42"; exit 0 ;;
  $PLACE.2.2) echo "objectid"; echo ".1.3.6.1.4.42.42.42"; exit 0 ;;
  $PLACE.3) echo "timeticks"; echo "363136200"; exit 0 ;;
  $PLACE.4) echo "ipaddress"; echo "127.0.0.1" ;;
  $PLACE.5) echo "counter"; echo "42"; exit 0 ;;
  $PLACE.6) echo "gauge"; echo "42"; exit 0 ;;
  *) echo "string"; echo "ack... $RET $REQ"; exit 0 ;;
esac

Пример работы данного скрипта:

# /usr/local/bin/passtest -n .1.3.6.1.4.1.2021.255.1
.1.3.6.1.4.1.2021.255.2.1
integer
42

Вывод скрипта, ожидаемый snmpd, состоит из 3х строк. Первая строка содержит следующий OID, причём она может содержать несуществующий, главное, что бы не зацикливалась. Вторая строка содержит тип возвращаемого значения, в нашем случае это integer (целое число), а всего возможно 7 типов: string, objectid, integer, timeticks, ipaddress, counter и gauge. Третья строка содержит значение, возвращенное для OID указанного при запуске скрипта. Расширение NET-SNMP с помощью внешних программ и директивы pass – самый простой и быстрый способ. Однако не стоит забывать об эффективности, для каждого отдельного OID, SNMPd вызовет указанный скрипт, такой подход может быть неприемлем для высоконагруженных систем.

• Tutorial: Writing a Subagent
• Understanding the sub-agent
• Tutorial: Writing a Dynamically Loadable Object

В общем случае система мониторинга состоит из 3х частей: сбор данных, обработка и уведомления. К слову, Nagios использует именно это концепцию, дополняя её разнообразными удобствами (визуальное отображение, расписания и т.д.). Уведомление по электронной почте, первое, что приходит в голову, однако оно не всегда оперативное. Самым оперативным уведомлением на сегодня является SMS сообщение. Отправку SMS сообщений можно организовать «на коленке» с помощью мобильного телефона подключенного к серверу.

Большинство телефонов представляют собой модем, к которому можно подключиться через интерфейс RS-232 (COM порт). Основным отличием мобильного телефона от обычного модема является поддержка расширенных AT команд. Эти команды используются для управления функциями специфичными для мобильного телефона, например, приёмом и отправкой коротких сообщений (SMS).

Традиционно считается, что для отправки SMS с ПК лучше всего подходят мобильные телефоны Siemens. Для реализации мобильных уведомлений, я запасся несколькими моделями: парочкой ME45 и одним A50. Первая неудача с телефонами Siemens ждала меня на этапе подсоединения к ПК. Оказывается, не все дата-кабели одинаковые.

Вот, этот например, определялся телефоном как гарнитура, и имел большое количество распаянных контактов внутри. Однако соединение по RS-232 установить с таким кабелем невозможно. Конечно, нельзя исключать, что мне попался бракованный экземпляр, но, как говорится, осадок то остался.

А вот так выглядит правильный дата-кабель доработанный мной. GND, RX, TX – все что нужно для работы по RS-232. Однако после доработки кабеля всплыла вторая проблема с телефонами Siemens. Все аппараты, имевшиеся у меня, выключались вскоре после того как аккумулятор был полностью заряжен. Т.е. их невозможно было эксплуатировать постоянно подключенными к сети. Вероятно это такой способ защиты аккумуляторов. Списать это на случайность не получится при всём желании.

В принципе, на этом можно было и остановить некрофильские эксперименты с аппаратурой фирмы Siemens, однако совесть потребовала идти до конца. Как я уже писал выше, для приёма и отправки текстовых сообщений через GSM модем используется специальный набор AT команд. Подробней об этом наборе можно почитать здесь. В общем случае отправка SMS выглядит вот так:

# picocom /dev/ttyS0
AT
OK
AT+CMGF=1
OK
AT+CMGS="+85291234567"
It is easy to send text messages.^Z

Если телефон поддерживает текстовый режим отправки SMS, или вот так:

# picocom /dev/ttyS0
AT
OK
AT+CMGS=42
07915892000000F0
01000B9158922143
65F7000021493A28
3D0795C3F33C88FE
06CDCB6E32885EC6
D341EDF27C1E3E97
E72E^Z

- если текстовый режим телефоном не поддерживается. Для активации текстового режима используется команда AT+CMGF=1, чтобы узнать, какие режимы поддерживаются Вашим телефоном, следует выполнить команду AT+CMGF=?.

Как вы уже догадались, третья проблема с телефонами Siemens заключалась в том, что ни один из имевшихся телефонов не поддерживал текстовый режим. Работая с PDU режимом Вы вынуждены генерировать сложную структуру содержащую в себе множество разнообразных параметров. Для работы с данной структурой Вам придётся либо изобрести велосипед и написать собственное API либо воспользоваться одной из существующих библиотек/программ (gsmlib, xgsmlib, Gammu и т.д.). Лучшим вариантом, на мой взгляд, является программа Gnokii

Намучавшись с сименсами, я решил опробовать устройство, которое изначально было бы рассчитано на постоянное использование в паре с ПК. Выбор мой пал на GSM/GPRS модем Teleofis RX201 (USB EDGE).

Приобрел я этот девайс за 3700 рублей, дороговато, по сравнению с рекламируемыми GPRS модемами от БиЛайн/Мегафон/МТС. По заверениям производителя (ООО КБ «Телеофис»), устройство произведено в России – мелочь, а приятно.

При подключении к ПК с linux, устройство определяется как «USB FTDI Serial Converter». Соответствующий модуль (ftdi_sio) автоматически создаёт файл устройства /dev/ttyUSBN. Этот файл вы можете использовать для связи с модемом, с помощью вашего любимого терминала (например picocom). Хочу обратить внимание на то, что устройство RX201 по умолчанию рассчитано на скорость 460800 кб/сек. Драйвер, идущий с Fedora 10 (ftdi_sio: v1.4.3) такую скорость не поддерживает. Что бы понизить скорость на модеме, к нему необходимо подключиться из альтернативной ОС и выполнить команду AT+IPR=115200&W.

Модем Teleofis RX201 отлично подружился с программой gnokii. Для отсылки sms с помощью gnokii сперва необходимо изменить конфигурационный файл /etc/gnokiirc. Вот пример рабочего конфига:

[global]
port = /dev/ttyUSB0
model = AT
initlength = default
connection = serial
use_locking = no
serial_baudrate = 115200

Обратите внимание на параметр use_locking, если Вы собираетесь рассылать SMS из Nagios, следует использовать use_locking = yes, что бы избежать конфликтов при рассылке уведомлений нескольким адресатам. Отправляется SMS очень просто:

echo 'ya sms-ko !' | gnokii --sendsms +79260000000

Вот и всё! SMS с текстом ‘ya sms-ko !’ будет отправлена на номер +79260000000.

Модем Teleofis RX201 работает уже почти месяц. В среднем в сутки отправляется около 10 сообщений. Никаких претензий и нареканий за этот небольшой срок не возникло, однако настораживает наличие модели Teleofis RX201-R единственное отличие которой – встроенный таймер перезагрузки.

• Nagios
• Short Message Service / SMS Tutorial
• Gnokii
• ООО КБ «Телеофис»