banshee/hardware-collection/hardware/pdu/apc/snmp/
phases
The load state, current, voltage and power of an APC rack PDU and of each of its phases by SNMP.
by banshee0 installations1 version
Published on October 28, 2026. First version.
APC rack PDU, by SNMP (PowerNet-MIB)
Returns, for an APC rack PDU and for each of its phases, the load state the PDU judges against its own thresholds (low, normal, near overload, overload), the current, the voltage and the power drawn. Three watches are offered, each one set on the probe. The outlets of a PDU metered by outlet are read by pdu/apc/snmp/outlets.
Versions
Generic: written for the rPDU2 tables of PowerNet-MIB, which APC's rack PDUs of the second generation and later serve (metered, switched, metered by outlet). The first-generation tables (rPDU) are not read: such a PDU stops the collector misconfigured. One collector serves every PDU that serves rPDU2, so it stays at the common level.
How it works
The collector reads two tables under 1.3.6.1.4.1.318.1.1.26:
| Column | OID | Read as |
|---|---|---|
rPDU2DeviceStatusModule | .4.3.1.2 | the PDU's number in its group: the instance pdu <number> |
rPDU2DeviceStatusLoadState | .4.3.1.4 | load-state of the PDU |
rPDU2DeviceStatusPower | .4.3.1.5 | power of the PDU, in W (the agent counts hundredths of kW) |
rPDU2PhaseStatusModule, rPDU2PhaseStatusNumber | .6.3.1.2, .6.3.1.3 | the instance pdu <number> L<phase> |
rPDU2PhaseStatusLoadState | .6.3.1.4 | load-state of the phase |
rPDU2PhaseStatusCurrent | .6.3.1.5 | current, in A (the agent counts tenths) |
rPDU2PhaseStatusVoltage | .6.3.1.6 | voltage, in V |
rPDU2PhaseStatusPower | .6.3.1.7 | power of the phase, in W (the agent counts hundredths of kW) |
- The load states:
low(1),normal(2),near-overload(3),overload(4);state <number>for another. The PDU judges them against the thresholds set on it, per phase and for the PDU. - PDUs linked in a group (Network Port Sharing) are all read through the one that holds the address, each by its number:
pdu 1,pdu 2 L1. - An agent that serves neither table stops the collector
misconfigured. - The collector only reads: SNMP sends nothing but reads. No outlet is switched.
Prerequisites
- The SNMP agent of the PDU enabled, reachable from the poller (UDP 161), its access restricted to the poller.
- Read-only access, SNMPv2c or SNMPv3, set on the host or one of its folders (
protocol:snmp:*variables).
Outputs
| Name | Label | Unit | Per instance |
|---|---|---|---|
load-state | Load state | — | yes, per PDU or phase |
current | Current | A | yes, per phase |
voltage | Voltage | V | yes, per phase |
power | Power | W | yes, per PDU or phase |
Watches
| Name | Title | Kind | Defaults | Checked by default |
|---|---|---|---|---|
load-state | Near overload or overloaded | state to avoid, on load-state | warning on near-overload, critical on overload | yes |
current | High current | above a threshold, on current | no threshold: it raises nothing until one is set on the probe | no |
missing | PDU or phase missing | expected instances, on load-state | nothing named: it raises nothing until names are set on the probe | no |
load-statefollows the thresholds set on the PDU itself.currentserves a threshold of one's own, the same for every phase: on two feeds of a redundant pair, each phase must stay under half of what its breaker holds, or the other feed trips when one fails.
Limits
- Not checked against a PDU: the OIDs and units are those of PowerNet-MIB as its public copies give it (LibreNMS, Observium, Netdisco, gathered by oidref.com).