mirror of
https://codeberg.org/icewind/wifi-prometheus-exporter.git
synced 2026-06-03 08:34:25 +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