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.


Did you find this document helpful?

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

Last updated on