Skip to main content

Export Kea Metrics in the Prometheus Exposition Format

Project description

Prometheus Exporter for the ISC Kea DHCP Server.

From v0.4.0 on Kea >=1.3.0 is required, as the configuration, specifically subnet information, will be read from the control socket.

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.6.0)
  • Configuration and statistics via control socket

Currently not working:

  • Automatic config reload (through inotify)

Known Limitations

The following features are not supported yet, help is welcome.

  • HTTP REST API (as a means to query a Kea instance)
  • Shared Networks
  • Custom Subnet Identifiers

Usage

Usage: kea-exporter [OPTIONS] SOCKETS...

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.
  --version           Show the version and exit.
  --help              Show this message and exit.

Configure Control Socket

The exporter uses Kea’s control socket to request both configuration and statistics. 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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for kea-exporter, version 0.4.1
Filename, size File type Python version Upload date Hashes
Filename, size kea_exporter-0.4.1-py3-none-any.whl (6.8 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size kea-exporter-0.4.1.tar.gz (5.1 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page