Ubiquiti UniFi + zabbix

[sadman]

В связи с моим запоздалым обновлением контроллера до релиза 5.10.x, я произвел ревизию шаблонов и обнаружил, что Ubiquiti продолжает бесчинствовать, не только вводя новые метрики, но и меняя названия, а так же места расположения старых.

Посему пришлось подправить исходный код Miner и Proxy, произведя v1.3.7.

В них добавились новые объекты, к которым привязаны метрики:
- uap_vap_table для данных по виртуальным точкам доступа (их образует каждая WLAN-сеть, объявленная в сайте). В них перекочевали некоторые метрики, которые ранее были общими для всей UAP. Таким образом можно получить статистику по срезу UAP+WLAN. LLD поддерживается;
- uap_vwire_vap_table для получения имён физических приёмо-передатчиков на точке доступа (например так разделены 2.4GHz и 5GHz модули). Некоторые метрики так же разъехались из корня JSON по разным подмассивам и субобъектам. LLD поддерживается;
- fw_update для получения некоторых метрик, связанных с доступной на сайте Ubiquiti актуальной версией контроллера и готовностью его к обновлению;
- wdg_health - позволяет вытащить метрики, которые передаются в виджет Health;
- wdg_switch - то же самое, но, видимо для виджета USW (у меня его нет, проверить догадку не могу).

Обновления доступны, как и прежде, по адресу https://github.com/zbx-sadman

Так, как Ubiquiti, по всей видимости, останавливаться не собирается и будет далее корёжить своё API, поддержка шаблонов в актуальном состоянии для каждого релиза и подрелиза представляется для фриварного проекта достаточно бессмысленной затеей. Поэтому, по мере обнаружения чего-то интересного, я буду просто добавлять в шаблон новые элементы данных, не удаляя старых. Решение оставить их или удалить в своём экземпляре - за вами, пользователями.

Так же советую после обновления на новый релиз контроллера посматривать в JSON-ы, которые он отдаёт и самостоятельно формировать интересующие элементы данных. Среди них попадаются интересные, например объект anomalies_bar_chart или radio_table_stats.

[sadman]

Небольшое дополнение, приведшее к выпуску v1.3.8:

JSON, пересылаемый в Zabbix отныне выдаётся в Pretty-формате (впрочем, можно вернуть и прежний - в одну строку) - см. опцию командной строки "-j" UniFi Miner-а и директиву "JsonOutput" конфигурационного файла UniFi Proxy.

Кроме того, что это красиво, данный вывод обходит (теоретически), ограничение Zabbix в 65кб на строку, оканчивающуюся LF (newlne, EOL). Т.е., потенциально, в мониторинг через LLD можно запихать гораздо больше объектов, чем ранее. История вопроса в этом issue.

Если кому-то интересно, то нашёл старое видео, демонстрирующее процесс установки/Настройки Miner: #1 https://yadi.sk/i/tUHDA7AvwgyZ5Q и #2 https://yadi.sk/i/aymxaYl4IYNQTg

[Konstantin Semenov]

Добрый день.
Тема ещё жива? Попробовал вчера установить и настроить работу Unifi Controller v7 + Miner 1.4.0 с соотв. шаблоном (unifi_miner/experimental at master · zbx-sadman/unifi_miner · GitHub). Результат вот какой:
На самом контроллере скрипт работает и отдаёт данные:

/home/user/unifi_miner# ./unifi_miner.pl -a raw -o wlan -s default -k "*"
[
   {
      "bss_transition" : true,
      "site_id" : "64957d094612e52457284ac3",
      "dtim_6e" : 3,
      "wlan_bands" : [
         "2g",
         "5g"
      ],
      "mac_filter_policy" : "allow",
      "wpa3_transition" : false,
      "wep_idx" : 1,
      "setting_preference" : "manual",
      "mac_filter_enabled" : false,
      "wpa_mode" : "wpa2",
      "name" : "TEST",
      "wpa3_support" : false,
      "group_rekey" : 3600,
      "usergroup_id" : "64957d0e4612e52457284adb",
      "ap_group_ids" : [
         "64957d0e4612e52457284adf"
      ],
      "x_iapp_key" : "578d803fd1686594cc6dd39067648285",
      "bc_filter_list" : [],
      "mac_filter_list" : [],
      "enabled" : true,
      "pmf_cipher" : "auto",
      "iapp_enabled" : true,
      "minrate_na_data_rate_kbps" : 6000,
      "minrate_setting_preference" : "manual",
      "dtim_mode" : "default",
      "dtim_ng" : 1,
      "radius_das_enabled" : false,
      "minrate_ng_enabled" : true,
      "wlan_band" : "both",
      "bc_filter_enabled" : false,
      "pmf_mode" : "disabled",
      "hotspot2conf_enabled" : false,
      "auth_cache" : true,
      "security" : "wpapsk",
      "x_passphrase" : "xxxxxxxxxxx",
      "dtim_na" : 3,
      "minrate_ng_data_rate_kbps" : 1000,
      "networkconf_id" : "64957d0e4612e52457284ada",
      "schedule_enabled" : false,
      "name_combine_enabled" : true,
      "wpa_enc" : "ccmp",
      "_id" : "64957f9b4612e52457284ae9"
   }
]

Со стороны Zabbix-сервера (версия 6.4.1) автообнаружение сработало, но данные не приходят, ошибка вот такая:

 Special characters "\, ', ", `, *, ?, [, ], {, }, ~, $, !, &, ;, (, ), <, >, |, #, @, 0x0a" are not allowed in the parameters​

При запросе данных из консоли Zabbix-Server данные отдаются, но всё время с результатом 0:

zabbix_get -s UNIFI-IP -k unifi.proxy[get,sysinfo,default,version]
0
​

Если у кого-то есть опыт настройки Unifi Controller v7 + Miner - буду признателен за любую наводку в решении проблемы.