mirror of
https://codeberg.org/icewind/wifi-prometheus-exporter.git
synced 2026-06-03 16:44:11 +02:00
add basic readme
This commit is contained in:
parent
5f5cdf8aa0
commit
319c613f4b
1 changed files with 20 additions and 0 deletions
20
README.md
Normal file
20
README.md
Normal file
|
|
@ -0,0 +1,20 @@
|
||||||
|
# wifi-prometheus-exporter
|
||||||
|
|
||||||
|
Export list of mac addresses connected to wifi.
|
||||||
|
|
||||||
|
Connects to the router or access point over ssh and export the connected wifi
|
||||||
|
clients as prometheus metrics and ( optionally) MQTT for home assistant.
|
||||||
|
|
||||||
|
## Requirements
|
||||||
|
|
||||||
|
A router or access point that can be accessed over ssh and uses iwd.
|
||||||
|
|
||||||
|
Tested with OpenWrt
|
||||||
|
|
||||||
|
## Usage
|
||||||
|
|
||||||
|
- Create a config file as shown in the [example](./config.sample.toml)
|
||||||
|
- Run `wifi-prometheus-exporter <path to config>`
|
||||||
|
- Scrape the exported metrics on the configured port at `/metrics`
|
||||||
|
- If MQTT is in use and home assistant is setup with MQTT integration, the wifi
|
||||||
|
clients should be automatically added.
|
||||||
Loading…
Add table
Add a link
Reference in a new issue