Skip to content
Export Kea Metrics in the Prometheus Exposition Format
Python
Branch: develop
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
kea_exporter
.gitignore
HISTORY
LICENSE
Pipfile
README.rst
setup.py

README.rst

kea-exporter

Prometheus Exporter for the ISC Kea DHCP Server.

Installation

The latest stable version can be installed from PyPi:

$ pip install kea-exporter

and upgraded with:

$ pip install --upgrade kea-exporter

Features

  • DHCP4 & DHCP6 Metrics (tested against Kea 1.3.0)
  • Querying via control sockets
  • Automatic config reload (through inotify)

Known Limitations

  • Include statements in Kea's configuration file are unsupported

Usage

Usage: kea-exporter [OPTIONS] CONFIG COMMAND [ARGS]...

Options:
  --address TEXT      Specify the address to bind against.
  --port INTEGER      Specify the port on which to listen.
  --interval INTEGER  Specify the metrics update interval in seconds.
  --help              Show this message and exit.

Configure Control Socket

The exporter uses Kea's control socket and the statistic-get-all request. Consult the documentation on how to set up the control socket:

Permissions

Kea Exporter needs to be able to read and write on the socket, hence it's permissions might need to be modified accordingly.

You can’t perform that action at this time.