title: MikroTik IP Pools
agents: mikrotik
catalog: hw/network/mikrotik
license: GPL
distribution: check_mk
description:
 Usage of the IP pools of a MikroTik RouterOS 6 or 7 device ({/ip/pool})
 as used by the DHCP server, PPP or hotspot.

 Newer RouterOS 7 versions report the total, used and available addresses
 per pool themselves; the check uses these numbers and the agent needs only
 one request. Otherwise the agent counts the used addresses from
 {/ip/pool/used} (the leases themselves are not transferred) and the pool
 size is computed from the ranges (from-to, prefix or single address,
 several separated by commas). If the used addresses cannot be read, or the
 ranges cannot be parsed, the service is {UNKNOWN}.

 Used addresses in percent have upper levels (default {WARN} at 80%,
 {CRIT} at 90%), free addresses optionally lower levels. Levels via the
 rule {MikroTik IP Pools}.

 A configured next pool is shown. The levels apply to this pool only: a
 full pool goes {CRIT} even if new clients still get addresses from its
 next pool. For pools with a next pool, raise or disable the levels if
 that is expected.

 To connect to the MikroTik device a special datasource program is
 used: {MikroTik RouterOS} in Setup > Agents > Other integrations,
 module "IP pools". The module is opt-in, "all" does not include it.

item:
 The name of the pool.

perfdata:
 Used addresses in percent, used and free addresses.

inventory:
 One service per pool.
