SNMP шаблоны используются для диагностики устройств по заданным в шаблоне параметрам. Шаблоны находятся в каталоге Abills/modules/Equipment/snmp_tpl, имеют расширение .snmp и используют синтаксис JSON.
Пример шаблона
// test SNMP temlate { // основная секция шаблона // описание устройства "DEVICE":"test device", //поддерживает ли FDB "FDB":"1", //Режим FDB "FDB_MODE":"", //Игнорировать порт FDB "FDB_IGNORE_PORTS":"20", //Основная секция мониторинга устройства "info" : { // идентификатор показателя "SYSTEM_NAME" : { //Отображаемое Название показателя "NAME" : "System name", //OID опроса. Можно указывать несколько значений через запятую "OIDS" : ".1.3.6.1.2.1.1.5.0", // Пропустить результат через парсер. Например, int2byte преобразует байты в читабельный вид "PARSER" : "" }, "UPTIME" : { "NAME" : "Uptime", "OIDS" : ".1.3.6.1.2.1.1.3.0", "PARSER" : "" } }, //Секция статистики портов //данные по индексу привязываются к порту устройства и выводятся при отображении информации по портам "ports" : { "PORTMULTTX" : { "NAME" : "Multicast TX", "OIDS" : ".1.3.6.1.2.1.31.1.1.1.4", "PARSER" : "int2byte" }, "PORTMULTRX" : { "NAME" : "Multicast RX", "OIDS" : ".1.3.6.1.2.1.31.1.1.1.2", "PARSER" : "int2byte" } } }
Используется несколько основных секций
- Основная
- Секция информации (info)
- Секция статистики по оборудованию (stats)
- Секция информации по портам (ports)
Преобразователи (парсеры) данных
int2byte | Число преобразовать в байты |
---|---|
bin2mac | Бинарное значение преобразовать в MAC (xx:xx:xx:xx:xx:xx) |
Параметры
FDB_EXPR | Выражения обработки FDB |
---|---|
ARP | OID для получения ARP-таблицы |
ARP_PARSER | Имя функции, которая приведёт полученные по SNMP данные в стандартный вид. Сейчас существуют две таких функции: snmp_hash (стандартная), gcom_snmp_hash (для GCOM) |
PORT VLAN MAC_HEX ONT_MAC_DEC
Пример использования
"FDB_EXPR" : "%%d\.(%%d+%%.%%d+%%.%%d+%%.%%d+%%.%%d+%%.%%d+):(.+)|PORT,ONT_MAC_DEC,MAC_HEX",
Изменения шаблонов
Шаблоны можно менять с помощью веб формы
Настройка>Оборудование>SNMP Шаблоны
При нажатии на можно добавить свой кастомный шаблон
Или изменить старый. Если появляется ошибка в изменении шаблона необходимо выполнить команду в консоли, где "xxxx.snmp" названия файла
chown -R www-data:www-data /usr/abills/Abills/modules/Equipment/snmp_tpl/xxxx.snmp
После обновления все стандартные шаблоны будут перезаписаны!
Если выдает ошибку Неверный формат файла, значит в файле находятся комментарии, которые можно удалить вручную.