banshee is under active development: collectors will keep changing, and a version you publish will likely need adjustments. For stable use, wait for version 1.0.0.

Network

banshee/network-collection/network/mikrotik/snmp/routeros/

resources

The processor load and the memory of a MikroTik RouterOS router by SNMP (HOST-RESOURCES-MIB).

  • network
  • snmp
  • mikrotik
  • routeros
  • cpu
  • memory

by banshee1 installation2 versions

Processor and memory of a MikroTik RouterOS router, by SNMP

Returns the load of each processor of a RouterOS router and their average, the size of its memory and the share used. Three watches are offered: the processor saturated, one processor saturated, and the memory saturated.

How it works

RouterOS serves HOST-RESOURCES-MIB, the standard MIB of a host's resources:

  • The load is hrProcessorLoad, one row per processor, in percent over the last minute, as the router averages it. The processors are named cpu0, cpu1… in the agent's order.
  • The memory is the row of hrStorageTable whose type is hrStorageRam, which RouterOS names main memory: its size and its share used.
  • A router that serves no processor, or no memory row, stops the collector as misconfigured.

The hardware health (temperatures, fans, power supplies) is read by network/mikrotik/snmp/health.

The collector only reads: SNMP sends nothing but reads.

Prerequisites

  • SNMP enabled on the router (/snmp set enabled=yes), 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).
  • Versions: RouterOS 6 and 7. It sits under routeros/ because SwitchOS does not serve HOST-RESOURCES-MIB: on a SwitchOS switch, it stops as misconfigured.

Outputs

NameLabelUnitPer instance
cpu-busyAverage load%no
core-busyProcessor load%yes, per processor
memory-totalMemoryMiBno
memory-used-percentMemory used%no

Watches

NameTitleKindDefaultsChecked by default
cpu-highProcessor saturatedabove a threshold, on cpu-busywarning above 80 %, critical above 95 %, for 3 runsyes
core-hotA processor saturatedabove a threshold, on core-busywarning above 95 %, for 3 runsno
memory-highMemory saturatedabove a threshold, on memory-used-percentwarning above 85 %, critical above 95 %, for 3 runsyes

Limits

  • On a router whose packets are handled by one core (a single queue, a single PPPoE session), one processor saturates while the average stays low: check "A processor saturated".
  • The storage of the router (its flash) is not read.
  • That SwitchOS serves no HOST-RESOURCES-MIB is not verified here without a device.