Dnsmasq DHCP monitoring with Netdata

Dnsmasq is a lightweight, easy to configure, DNS forwarder and DHCP server.

This module monitors Dnsmasq DHCP leases database.


It produces the following set of charts for every dhcp-range:

  • DHCP Range Allocated Leases in leases
  • DHCP Range Utilization in percentage


Module automatically detects all configured dhcp-ranges reading dnsmasq configuration files.

By default it uses:

  • /var/lib/misc/dnsmasq.leases to read leases.
  • /etc/dnsmasq.conf to detect dhcp-ranges.
  • /etc/dnsmasq.d to find additional configurations.


Edit the go.d/dnsmasq_dhcp.conf configuration file using edit-config from the your agent's config directory, which is typically at /etc/netdata.

cd /etc/netdata # Replace this path with your Netdata config directory
sudo ./edit-config go.d/dnsmasq_dhcp.conf

Here is an example:

- name : dnsmasq_dhcp
leases_path : /var/lib/misc/dnsmasq.leases
conf_path : /etc/dnsmasq.conf
conf_dir : /etc/dnsmasq.d

For all available options please see module configuration file.


Check the module debug output. Run the following command as netdata user:

./go.d.plugin -d -m dnsmasq_dhcp

Last updated on