banshee/network-collection/network/mikrotik/snmp/
poe
Power over Ethernet on a MikroTik RouterOS or SwitchOS device by SNMP: the state, power, voltage and current of each port.
by banshee1 installation2 versions
v2Latest
Published on October 28, 2026. One naming convention across collections; documentation completed.
Power over Ethernet of a MikroTik device, by SNMP
Returns, for each PoE port of a MikroTik router or switch, its PoE state, and, while it powers a device, the power it delivers, its voltage and its current; and the power delivered by the whole device. Four watches are offered: a PoE fault, a device unpowered, the power budget, and a port missing.
Versions
RouterOS 6 and 7, and SwitchOS, on a device with PoE out. The table is the same on both.
How it works
The collector reads mtxrPOETable (MIKROTIK-MIB), one row per PoE port, named by its interface name (ether2).
- The state is
mtxrPOEStatusin words:disabled,waiting-for-load(nothing to power),powered-on, and the faultsoverload,short-circuit,voltage-too-low,current-too-low,power-reset,voltage-too-high,controller-error,controller-upgrade,poe-in-detected,no-valid-psu,controller-init,low-voltage-too-low. - The power and the voltage are in tenths, which the collector divides; the current is in mA. They are returned for a port
powered-ononly. - The total power is the sum of the power of the ports
powered-on. - A device that serves no PoE port stops the collector as misconfigured.
The collector only reads: SNMP sends nothing but reads.
Prerequisites
- SNMP enabled on the device, 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 |
|---|---|---|---|
status | PoE state | — | yes, per port |
power | Power delivered | W | yes, per port |
voltage | Voltage | V | yes, per port |
current | Current | mA | yes, per port |
total-power | Total power delivered | W | no |
Watches
| Name | Title | Kind | Defaults | Checked by default |
|---|---|---|---|---|
fault | PoE fault | state to avoid, on status | warning on voltage-too-low, current-too-low, low-voltage-too-low, power-reset; critical on overload, short-circuit, voltage-too-high, controller-error, no-valid-psu | yes |
unpowered | Device unpowered | state to avoid, on status | warning on waiting-for-load | no: choose the ports in the selection first |
budget | Power budget | above a threshold, on total-power | no threshold: the budget depends on the model and its power supply | no |
missing | PoE port missing | expected instances, on status | no port named: it raises nothing until names are set on the probe | no |
Limits
- "Device unpowered" raises on every port without a device: check it once the selection keeps the ports where a camera or an access point is expected.
- The state words follow MIKROTIK-MIB; which ones a given model reports is not verified here without a device.