Monitoring cez SNMP

1 Prehľad SNMP

PWX-12-4422 obsahuje vstavaného SNMP v2c agenta (lwIP stack) bežiaceho na komunikačnom module ESP32. Agent umožňuje monitorovacím systémom (NMS) čítať live dáta UPS a prijímať trap notifikácie o udalostiach — bez potreby cloudu, bez akéhokoľvek ďalšieho softvéru.

2 Konfigurácia SNMP agenta

SNMP sa nastavuje cez vstavaný webový manažment UPS zariadenia. Otvorte prehliadač, zadajte IP adresu UPS a prejdite na Settings → SNMP.

Parametre SNMP nastavení

3 OID referencia

Kompletný zoznam SNMP objektov implementovaných v zariadení PWX-12-4422. RW = čítanie aj zápis (SET), RO = len čítanie (GET).

System Group — štandardný MIB-II

Výstupné porty — Enterprise tabuľka

Batéria

AC vstup

Teplota

4 Trap udalosti

Traps sú asynchrónne push notifikácie ktoré UPS odosiela na nakonfigurovaný server (UDP port 162) okamžite pri udalosti — bez čakania na poll zo strany NMS. Traps sa odosielajú ako SNMPv2c TRAP PDU (typ SNMP_GENTRAP_ENTERPRISE_SPECIFIC).

5 Príkazy — net-snmp

Príklady používajú nástroje net-snmp (Linux/macOS: apt install snmp, Windows: net-snmp installer). IP adresu UPS nahraďte skutočnou adresou zariadenia.

Základné GET požiadavky

snmpget -v2c -c public 192.168.1.100 1.3.6.1.2.1.1.5.0
# Výstup:
SNMPv2-MIB::sysName.0 = STRING: UPS-ServerRoom-A

snmpget -v2c -c public 192.168.1.100 1.3.6.1.2.1.1.3.0
SNMPv2-MIB::sysUpTime.0 = Timeticks: (123456789) 14 days, 6:53:27.89

snmpget -v2c -c public 192.168.1.100 1.3.6.1.4.1.62751.1.1.1.3.0
# Odpoveď: 4810 = 48.10 V
iso.3.6.1.4.1.62751.1.1.1.3.0 = INTEGER: 4810

snmpget -v2c -c public 192.168.1.100 1.3.6.1.4.1.62751.1.1.1.5.0
iso.3.6.1.4.1.62751.1.1.1.5.0 = INTEGER: 1   # 1=ZAP

Walk — prechádzanie celého stromu

snmpwalk -v2c -c public 192.168.1.100 1.3.6.1.4.1.62751
# Výstup obsahuje všetky výstupné porty, batériu, teploty...

snmpwalk -v2c -c public 192.168.1.100 1.3.6.1.4.1.62751.1.1
# Prikla výstupu:
iso.3.6.1.4.1.62751.1.1.1.2.0 = STRING: "Router"
iso.3.6.1.4.1.62751.1.1.1.2.1 = STRING: "Switch A"
iso.3.6.1.4.1.62751.1.1.1.2.2 = STRING: "IP Camera 1"
...
iso.3.6.1.4.1.62751.1.1.1.3.0 = INTEGER: 4810
iso.3.6.1.4.1.62751.1.1.1.3.1 = INTEGER: 4808
...

snmpwalk -v2c -c public 192.168.1.100 system
# Vráti sysDescr, sysUpTime, sysContact, sysName, sysLocation

Zachytenie trap notifikácie (testovanie)

# Linux / macOS
snmptrapd -f -Lo -c /etc/snmp/snmptrapd.conf
# alebo jednoduché zachytenie bez konfigurácie:
snmptrapd -f -Lo -On

6 Integrácia s NMS systémami

PWX-12-4422 je kompatibilný s každým NMS systémom ktorý podporuje SNMPv2c. Nižšie sú kroky pre najpopulárnejšie platformy.

Telegraf konfigurácia (príklad)

# telegraf.conf — SNMP input plugin pre PWX-12-4422
[[inputs.snmp]]
  agents = ["udp://192.168.1.100:161"]
  version = 2
  community = "public"

  [[inputs.snmp.field]]
    name = "uptime"
    oid = "1.3.6.1.2.1.1.3.0"

  [[inputs.snmp.field]]
    name = "board_temp"
    oid = "1.3.6.1.4.1.62751.1.3.1"

  [[inputs.snmp.table]]
    name = "psx_outputs"
    oid = "1.3.6.1.4.1.62751.1.1"
    [[inputs.snmp.table.field]]
      name = "description"
      oid = "1.3.6.1.4.1.62751.1.1.1.2"
      is_tag = true
    [[inputs.snmp.table.field]]
      name = "voltage"
      oid = "1.3.6.1.4.1.62751.1.1.1.3"
    [[inputs.snmp.table.field]]
      name = "current"
      oid = "1.3.6.1.4.1.62751.1.1.1.4"
    [[inputs.snmp.table.field]]
      name = "status"
      oid = "1.3.6.1.4.1.62751.1.1.1.5"

7 MIB súbor

Štandardizovaný MIB súbor vo formáte SMIv2 (RFC 2578). Definuje celý OID strom 1.3.6.1.4.1.62751, trap notifikácie a conformance groups. Kompatibilný s RFC 1628 (UPS-MIB) konvenciami.

Inštalácia MIB súboru

sudo cp POWERSENTRIX-UPS-MIB.mib /usr/share/snmp/mibs/
# Overenie — zoznam OIDov:
snmptranslate -Pu -m POWERSENTRIX-UPS-MIB -IR psxOutputVoltage
POWERSENTRIX-UPS-MIB::psxOutputVoltage

# Walk s popiskami miesto číselných OIDov:
snmpwalk -v2c -c public -m POWERSENTRIX-UPS-MIB 192.168.1.100 powerSentrix

# Nahranie cez GUI:
Administration → General → Other → SNMP MIBs → Import

# Alebo cez filesystem (Zabbix 6+):
cp POWERSENTRIX-UPS-MIB.mib /usr/share/snmp/mibs/

Obsah MIB súboru — štruktúra OID stromu

enterprises.62751  (powerSentrix)
├── .1  psxObjects
│   ├── .1  psxOutputs
│   │   └── .1  psxOutputTable [INDEX: psxOutputIndex 0–11]
│   │       ├── .1.1.N  psxOutputIndex       — Integer32 (0–11)
│   │       ├── .1.2.N  psxOutputDescription — DisplayString (RW)
│   │       ├── .1.3.N  psxOutputVoltage     — Integer32 (0.01 V)
│   │       ├── .1.4.N  psxOutputCurrent     — Integer32 (mA)
│   │       └── .1.5.N  psxOutputStatus      — on(1) | off(2)
│   ├── .2  psxSystem
│   │   ├── .1  psxSysUptime               — TimeTicks
│   │   ├── .2  psxComFirmwareVersion       — DisplayString
│   │   ├── .3  psxMainFirmwareVersion      — DisplayString
│   │   ├── .4  psxSerialNumber             — DisplayString
│   │   └── .5  psxModelName               — DisplayString
│   ├── .3  psxTemperature
│   │   ├── .1  psxBoardTemperature         — Integer32 (°C)
│   │   └── .2  psxMcuTemperature           — Integer32 (°C)
│   ├── .4  psxBattery
│   │   ├── .1  psxBatteryVoltage           — Integer32 (0.01 V)
│   │   ├── .2  psxBatteryCount             — Integer32
│   │   ├── .3  psxBatteryCapacity          — Integer32 (0.1 Ah)
│   │   ├── .4  psxBatteryStatus            — ENUM (RFC 1628)
│   │   ├── .5  psxBatteryMainVoltage       — Integer32 (0.01 V)
│   │   └── .6  psxBatteryLoadVoltage       — Integer32 (0.01 V)
│   └── .5  psxInput
│       ├── .1  psxInputVoltage             — Integer32 (0.01 V)
│       └── .2  psxInputSource              — ENUM (RFC 1628)
├── .2  psxTraps
│   └── .0  psxTrapPrefix
│       ├── .1  psxPowerSourceChanged       — NOTIFICATION
│       ├── .2  psxInputVoltageTrap         — NOTIFICATION
│       ├── .3  psxHighTemperatureTrap      — NOTIFICATION
│       ├── .4  psxOutputStateChanged       — NOTIFICATION
│       └── .5  psxGenericEventTrap         — NOTIFICATION
└── .3  psxConformance
    ├── .1  psxCompliances
    └── .2  psxGroups