Skip to main content

ISC DHCP monitoring with Netdata

Monitors the leases database to show all active leases for given pools.

Requirements#

  • dhcpd leases file MUST BE readable by Netdata
  • pools MUST BE in CIDR format
  • python-ipaddress package is needed in Python2

It produces:

  1. Pools utilization Aggregate chart for all pools.

    • utilization in percent
  2. Total leases

    • leases (overall number of leases for all pools)
  3. Active leases for every pools

    • leases (number of active leases in pool)

Configuration#

Edit the python.d/isc_dhcpd.conf configuration file using edit-config from the Netdata config directory, which is typically at /etc/netdata.

cd /etc/netdata # Replace this path with your Netdata config directory, if different
sudo ./edit-config python.d/isc_dhcpd.conf

Sample:

local:
leases_path: '/var/lib/dhcp/dhcpd.leases'
pools:
office: '192.168.2.0/24' # name(dimension): pool in CIDR format
wifi: '192.168.3.10-192.168.3.20' # name(dimension): pool in IP Range format
192.168.4.0/24: '192.168.4.0/24' # name(dimension): pool in CIDR format
wifi-guest: '192.168.5.0/24 192.168.6.10-192.168.6.20' # name(dimension): pool in CIDR + IP Range format

The module will not work If no configuration is given.


Reach out

If you need help after reading this doc, search our community forum for an answer. There's a good chance someone else has already found a solution to the same issue.

Documentation

Community