SNMP і Zabbix
Для кого:Монтажник
MiRCA відповідає на запити SNMP v1/v2c. Дерево OID однакове для будь-якого протоколу, тож один підхід до моніторингу працює з будь-якою BMS чи інвертором. Для Zabbix є готові шаблони.
Налаштування на MiRCA
Section titled “Налаштування на MiRCA”Config → SNMP:
- Answer SNMP requests — увімкнути чи вимкнути SNMP. За замовчуванням увімкнено;
- Read community — спільнота для читання, за замовчуванням
public; - Write community — за замовчуванням
private.
Зміни перезавантажують MiRCA. Якщо MiRCA доступна з інших мереж, замініть спільноти на свої.

Перевірка без Zabbix
Section titled “Перевірка без Zabbix”snmpbulkwalk -v2c -c public <ip> .1.3.6.1.4.1.2021.13.16.4.2 # усе дерево портівsnmpget -v2c -c public <ip> .1.3.6.1.4.1.2021.13.16.4.2.1.1 # протокол Port 1<ip> — Ethernet-адреса MiRCA. Повний перелік OID — у довіднику SNMP.
Zabbix
Section titled “Zabbix”Шаблони для Zabbix 5.2 (імпортуються й у новіші версії). На кожен протокол є два шаблони: для Port 1 і для Port 2. Плюс шаблон MiRCA Device: назва, версія прошивки, температура плати, «немає даних SNMP».
Завантажити шаблони:
- mirca_all.xml — усі шаблони в одному файлі;
- окремо: MiRCA Device, JK BMS Modbus, JK BMS parallel bus, JK BMS 4G-GPS, JBD BMS, PACE BMS, Deye inverter Modbus, Victron VE.Bus, Serial capture.
-
Configuration → Templates → Import, файл
mirca_all.xml. Шаблони потраплять у групуTemplates/MiRCAразом із value maps. -
Вузол: додайте SNMP-інтерфейс з Ethernet-адресою MiRCA, версія SNMPv2, community
{$SNMP_COMMUNITY}. Значення макросу — Read community з налаштувань MiRCA (за замовчуваннямpublic). -
Шаблони: прив’яжіть до вузла MiRCA Device і по одному шаблону на кожен задіяний порт, відповідно до протоколу порту. Наприклад:
MiRCA Port 1 JK BMS parallel bus+MiRCA Port 2 Deye inverter Modbus. На вимкнений порт шаблон не потрібен.
Якщо протокол порту не збігається з шаблоном, з’явиться попередження «Port N: protocol is not … (template does not match port settings)».
Що є в шаблонах
Section titled “Що є в шаблонах”- Стан порту: протокол, на зв’язку, секунди від останньої відповіді. Проблема «Port N: … not responding», якщо пристрій мовчить довше за
{$MIRCA.OFFLINE.TIME}. - BMS: напруга, струм, SOC, цикли, ємність, кожна комірка й датчик (знаходяться автоматично), тривоги. Проблеми: низький і критичний SOC, недонапруга й перенапруга комірки, температура, перегрів MOSFET, тривоги BMS назвами.
- Паралельна група JK: підсумок групи й кожна батарея окремо.
- Deye: усі 52 показники, стан, коди помилок F01–F64 з назвами, відключення мережі, низький SOC, перегрів.
- Victron VE.Bus: DC напруга й струм, частота AC, коефіцієнт потужності.
Макроси
Section titled “Макроси”Пороги задаються макросами на вузлі. Щоб задати поріг лише для одного порту, додайте контекст: {$MIRCA.SOC.WARN:"p2"} діє тільки на Port 2.
| Макрос | За замовчуванням | Що задає |
|---|---|---|
{$MIRCA.INTERVAL} |
30s | Інтервал опитування живих значень |
{$MIRCA.INTERVAL.SLOW} |
5m | Інтервал для ємності, циклів, лічильників енергії |
{$MIRCA.OFFLINE.TIME} |
5m | Скільки пристрій на порту може мовчати |
{$MIRCA.NODATA.TIME} |
5m | Скільки MiRCA може не відповідати на SNMP |
{$MIRCA.SOC.WARN} / {$MIRCA.SOC.CRIT} |
20 / 10 | SOC, % |
{$MIRCA.CELL.UV} / {$MIRCA.CELL.OV} |
2.9 / 3.65 | Напруга комірки, В (для LiFePO4) |
{$MIRCA.TEMP.MIN} / {$MIRCA.TEMP.MAX} |
0 / 50 | Датчики температури батареї, °C |
{$MIRCA.MOS.TEMP.MAX} |
80 | Температура MOSFET JK, °C |
{$MIRCA.JK.ALARM.MASK} |
7602175 | Які біти тривог JK створюють проблему: усі, крім «GPS disconnected» і «Change the authorization password» |
{$MIRCA.DEYE.TEMP.MAX} |
75 | Радіатор і DC-трансформатор Deye, °C |
{$MIRCA.DEYE.GRID.EXPECTED} |
1 | 0 — автономна система, без проблеми «grid disconnected» |
{$MIRCA.AC.FREQ.MIN} / {$MIRCA.AC.FREQ.MAX} |
49 / 51 | Частота AC для VE.Bus, Гц |
{$MIRCA.DC.VOLTAGE.MIN} / {$MIRCA.DC.VOLTAGE.MAX} |
0 / 0 | DC напруга VE.Bus, В; 0 — перевірку вимкнено |
{$MIRCA.BOARD.TEMP.MAX} |
60 | Температура плати MiRCA, °C |
Для інших хімій батарей змініть пороги комірок, наприклад для NMC: {$MIRCA.CELL.UV} = 3.0, {$MIRCA.CELL.OV} = 4.2.
Автоматичне виявлення
Section titled “Автоматичне виявлення”- Комірки й датчики температури знаходяться раз на годину. Беруться ті, значення яких не 0, тож пристрій має бути на зв’язку під час першого виявлення. Якщо він тоді мовчав, запустіть правило вручну (Execute now).
- Батареї паралельної групи знаходяться раз на 10 хвилин. Нова батарея з’являється після найближчого виявлення.
- Елементи комірок, датчиків і батарей, які зникли, видаляються через 7 днів.
Коли пристрій на порту не на зв’язку, MiRCA віддає 0 для всіх його значень. Тому проблеми за значеннями виникають лише тоді, коли пристрій на зв’язку, а мовчання ловить окрема проблема «not responding».
Відповідь MiRCA не перевищує 1360 байт, тож SNMP проходить і через VPN-тунелі.