SNMP Monitoring Guide

1 SNMP Overview

PWX-12-4422 has a built-in SNMPv2c agent (lwIP stack) running on the ESP32 communication module. The agent allows NMS systems to read live UPS data and receive trap notifications about events — without cloud, without any additional software.

2 SNMP Agent Configuration

SNMP is configured via the built-in UPS web management. Open a browser, enter the UPS IP address, and navigate to Settings → SNMP.

SNMP Settings Parameters

3 OID Reference

Complete list of SNMP objects implemented in the PWX-12-4422. RW = read-write (SET supported), RO = read-only (GET only).

System Group — Standard MIB-II

Output Ports — Enterprise Table

Battery

AC Input

Temperature

4 Trap Events

Traps are asynchronous push notifications that the UPS sends to the configured server (UDP port 162) immediately when an event occurs — without waiting for an NMS poll. Traps are sent as SNMPv2c TRAP PDUs (SNMP_GENTRAP_ENTERPRISE_SPECIFIC type).

5 Command Examples — net-snmp

Examples use net-snmp tools (Linux/macOS: apt install snmp, Windows: net-snmp installer). Replace the UPS IP with the actual device address.

Basic GET requests

snmpget -v2c -c public 192.168.1.100 1.3.6.1.2.1.1.5.0
# Output:
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
# Response: 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=on

Walk — traversing the full tree

snmpwalk -v2c -c public 192.168.1.100 1.3.6.1.4.1.62751
# Output includes all output ports, battery, temperatures...

snmpwalk -v2c -c public 192.168.1.100 1.3.6.1.4.1.62751.1.1
# Sample output:
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
# Returns sysDescr, sysUpTime, sysContact, sysName, sysLocation

Catching trap notifications (testing)

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

6 NMS Integration

PWX-12-4422 is compatible with any NMS supporting SNMPv2c. Below are steps for the most popular platforms.

Telegraf configuration (example)

# 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 File

Standardised MIB file in SMIv2 format (RFC 2578). Defines the full OID tree 1.3.6.1.4.1.62751, trap notifications and conformance groups. Compatible with RFC 1628 (UPS-MIB) conventions.

MIB file installation

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/

MIB file content — OID tree structure

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