UnPoller:UniFi 监控数据导出工具
用 Go 编写的 UniFi 控制器数据采集工具,可把站点、设备与客户端指标导出到 InfluxDB 或 Prometheus。
- 浏览
- 1
- 访问
- 0
- 下载
- 0
- 版本
- v5.9.1
- 平台
- Windows、macOS、Linux
详细介绍
项目简介
UnPoller 是一个用 Go 编写的小型应用,用于采集 UniFi 控制器、站点、设备与客户端的数据,并导出到 InfluxDB;也可以打开端口,以 Prometheus 格式输出这些数据。它同时支持收集 UniFi 的事件、告警、异常与 IDS 数据,这些数据可写入 Loki 或 InfluxDB,或两者都写。
项目附带 13 个 Grafana 仪表板:6 个面向 InfluxDB,7 个面向 Prometheus,在 Grafana 官网 可以搜索到。
主要功能
- Influx 模式:每 30 秒轮询一次 UniFi 控制器获取测量数据,并写入 Influx 数据库。
- Prometheus 模式:程序打开一个 Web 端口,等待 Prometheus 拉取;它把 UniFi Controller API 的数据实时转换成 Prometheus 导出格式。
- 事件与日志采集:自 v2.0.2 起支持 Loki,可收集 UniFi 的事件、告警、异常与 IDS 数据。
- 覆盖多种设备:支持 UniFi 控制器(可安装在 Windows、macOS、FreeBSD、Linux 或 Docker 上)、CloudKey 硬件,以及较新的 Dream Machine。
- 多种系统环境:可在 Windows、macOS、FreeBSD、Linux 或 Docker 中运行,并可用 puppet、chef、saltstack、homebrew 或简单的 bash 脚本管理。
安装与使用
安装与配置说明请见官方文档站:https://unpoller.com。
项目为 macOS、Linux、FreeBSD 和 Docker 提供软件包,在 Windows 上同样可以运行。使用时需要有一个持续运行的 UniFi 控制器,以及 InfluxDB 或 Prometheus,再配合 Grafana 查看图表。
遇到问题可以提交 Issue,或在 GoLift Discord 服务器的 #unpoller 频道求助;也可以参考 Ubiquiti 社区帖子。
注意事项
- 本应用要求 UniFi 控制器始终保持运行。
- 使用前需要自行准备 InfluxDB 或 Prometheus,以及用于展示的 Grafana。
- 项目以 MIT 许可证发布,版权归 David Newhall II 所有(2018-2020)。
本作品整理自 GitHub 开源项目 unpoller/unpoller,原作者 @unpoller,许可证 MIT。中文介绍由 AI 根据项目 README 整理,以原仓库为准。
更新记录
- v5.9.1当前版本
## Changelog * 7ef29ad4cb94a92ba2bf11d40716c0fc45752e0e fix: do not apply slot-specific data plans to other SIMs * df8731dd286695b23a3c0bf931183c50a9989c7f feat: export U5G APN, cellular addressing and data-plan metrics * 4b0fa1e7ab67808b32b1be238568f2264c06159d build: use released UniFi library v6.6.1 * b84bcc7da39db2d6f24801801f4d72a16250810b promunifi: export UAP uplink parent, mesh RSSI/signal and PHY rates
- v5.9.0
改用正式发布的 UniFi 库 v6.6.0;补充对部分 console 系统响应的测试覆盖;修复 inputunifi,使已配置的抓取不受可选指标影响;Prometheus 输出新增 UniFi OS 控制台更新可用性。
评论