跳转到主要内容

以Prometheus Exposition格式导出Kea指标

项目描述

GitHub license GitHub tag (latest SemVer) PyPI - Version PyPI - Downloads

kea-exporter

ISC Kea DHCP服务器的Prometheus导出器。

从v0.4.0开始,需要Kea >=1.3.0,因为配置(特别是子网信息)将从控制套接字读取。

安装

Package versions via repology.org

可以从PyPi始终安装最新稳定版本

$ pip install kea-exporter

和升级

$ pip install --upgrade kea-exporter

Docker

提供Docker镜像,可以通过环境变量进行配置,请参阅使用部分

$ docker pull ghcr.io/mweinelt/kea-exporter

特性

  • DHCP4 & DHCP6指标(针对Kea 2.4.1进行了测试)

  • 通过控制套接字或http api进行配置和统计

当前不可用

  • 自动配置重新加载(通过inotify)

已知限制

以下功能尚未支持,欢迎提供帮助。

  • 共享网络

  • 自定义子网标识符

使用方法

将一个或多个Unix域套接字路径或HTTP控制代理URL传递给kea-exporter可执行文件。所有其他选项都是可选的。

Usage: python -m kea_exporter [OPTIONS] TARGETS...

Options:
  -a, --address TEXT      Address that the exporter binds to.
  -p, --port INTEGER      Port that the exporter binds to.
  -i, --interval INTEGER  Minimal interval between two queries to Kea in
                          seconds.
  --client-cert PATH      Path to client certificate used to in HTTP requests
  --client-key PATH       Path to client key used in HTTP requests
  --version               Show the version and exit.
  --help                  Show this message and exit.

您也可以使用环境变量配置导出器

export ADDRESS="0.0.0.0"
export PORT="9547"
export INTERVAL="7.5"
export TARGETS="http://router.example.com:8000"
export CLIENT_CERT="/etc/kea-exporter/client.crt"
export CLIENT_KEY="/etc/kea-exporter/client.key"

配置控制套接字

导出器使用Kea的控制套接字来请求配置和统计信息。请参阅有关如何设置控制套接字的文档

HTTPS

如果您需要在Kea实例上验证自签名证书,可以将REQUESTS_CA_BUNDLE环境变量设置为CA路径。

权限

Kea导出器需要能够读取和写入套接字,因此其权限可能需要相应修改。

Grafana仪表板

此导出器的仪表板可在https://grafana.org.cn/grafana/dashboards/12688找到。

项目详情


下载文件

下载适用于您平台的文件。如果您不确定选择哪个,请了解有关安装包的更多信息。

源分布

kea_exporter-0.7.0.tar.gz (9.6 kB 查看哈希值)

上传时间

构建分布

kea_exporter-0.7.0-py3-none-any.whl (10.3 kB 查看哈希值)

上传时间 Python 3

支持者

AWSAWS 云计算和安全赞助商 DatadogDatadog 监控 FastlyFastly CDN GoogleGoogle 下载分析 MicrosoftMicrosoft PSF赞助商 PingdomPingdom 监控 SentrySentry 错误日志 StatusPageStatusPage 状态页