Агент SNMP
Контроллер как источник SNMP
Иногда нужно получать какие-то параметры из контроллера по SNMP, например, значения топиков. Для реализации требуется установить и настроить на контроллере агента SNMP.
Решение базируется на демоне snmpd, который разрабатывается и поддерживается открытым сообществом. Здесь даны общие рекомендации, подробную информацию ищите в официальной документации (англ). Перед началом установки убедитесь что правильно и полностью понимаете содержимое документации https://manpages.debian.org/unstable/snmpd/snmpd.conf.5.en.html
Установка и предварительная настройка пакетов
Обновите источники и установите пакеты snmp
и snmpd
:
apt update && apt-get install snmp snmpd -y
Отредактируйте основной файл конфигурации демона:
nano /etc/snmp/snmpd.conf
В секцию # ACCESS CONTROL
допишите строчки:
view systemonly included .1.3.6.1.4.1.2021.8
view systemonly included .1.3.6.1.4.1.2021.9
А в конец файла допишите ссылки на скрипты:
extend .1.3.6.1.4.1.2021.8 tt /var/lib/snmp/mqtt-snmp.sh
pass .1.3.6.1.4.1.2021.9 /var/lib/snmp/mqtt-snmp_pass.sh
Дополнительную информацио о параметрах конфигурационного файла можно в документации snmpd
Добавление скрипта
Неактуально в текущем виде для релизов 2304 и новее, сервис snmpd запускается от "Debian-snmp". Требуется коррекция прав.
Отредактируйте скрипт /var/lib/snmp/mqtt-snmp.sh
nano /var/lib/snmp/mqtt-snmp.sh
И приведите его к виду:
#!/bin/sh
echo "mosquitto topics"
# voltage Vout
echo $(/usr/bin/mosquitto_sub -C 1 -t "/devices/wb-adc/controls/5Vout" 2>/dev/null)
# voltage Vin
echo $(/usr/bin/mosquitto_sub -C 1 -t "/devices/wb-adc/controls/Vin" 2>/dev/null)
OID'ы отдаваемые этим скриптом могут иметь тип только STRING
Для демонстрации вывода других типов служит второй:
nano /var/lib/snmp/mqtt-snmp_pass.sh
Содержимое:
#!/bin/sh -f
echo .1.3.6.1.4.1.2021.9.1
echo integer
/bin/systemctl is-active wb-mqtt-serial > /dev/null && echo 1 || echo 0
Скрипт возвращает INTEGER:1 если сервис wb-mqtt-serial запущен и 0 если нет.
Установите права:
chmod a+rx /var/lib/snmp/mqtt-snmp.sh
chmod a+rx /var/lib/snmp/mqtt-snmp_pass.sh
Теперь добавляем в этот скрипт нужные топики, или создаем несколько скриптов с разными наборами. Если вы создаете несколько скриптов, не забудьте дописать ссылки на них в конец файла /etc/snmp/snmpd.conf
.
После сохранения изменений в скрипте, перезапустите демон snmpd
:
systemctl restart snmpd && systemctl status snmpd
Можно протестировать:
snmpwalk -On -v2c -c public 127.0.0.1 1.3.6.1.4.1.2021.8.4
и второй:
snmpwalk -On -v2c -c public 127.0.0.1 1.3.6.1.4.1.2021.9