Prometheus exporter for MeshCore repeaters, read over the mesh: a companion (USB, BLE, or a companion identity in openHop over TCP) logs in to each repeater, asks for status and telemetry with direct packets and serves battery, temperature/humidity, noise floor, RSSI/SNR, packet counters, airtime and uptime on :9200/metrics. - meshcore_exporter.py: command line, MC_* environment or a TOML file with a password per repeater; --check reads every repeater once and exits; interval 1 h (min 15 min); a failed repeater is retried once after 3 min; contacts fetched once per round. - dashboards/: the Grafana dashboard, generated from generate.py (datasource, job and the rate window are variables; TX drawn above zero, RX below). - stack/: Docker Compose with Prometheus and Grafana provisioned, for a USB companion, or on the host network for openHop on the same machine. - systemd/: running without Docker. - README.md (Czech) and AGENTS.md for setting it up with an AI agent. - CI: lint and tests, gitleaks; PR check builds the image; single-platform images per architecture behind a Trivy gate (latest-<arch>, and X.Y.Z-<arch> with a release on tag vX.Y.Z); dependencies by Renovate. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
25 lines
1015 B
TOML
25 lines
1015 B
TOML
# Copy to repeaters.toml (git ignores it) and fill in. Top-level keys are the
|
|
# defaults of the command-line options; command line and MC_* env win.
|
|
|
|
# The companion radio -- exactly one of these:
|
|
serial = "/dev/serial/by-id/usb-REPLACE_ME-if00" # `ls /dev/serial/by-id/`
|
|
# tcp = "192.168.1.50:5000" # WiFi companion
|
|
# ble = "AA:BB:CC:DD:EE:FF" # BLE companion
|
|
# ble_pin = "123456"
|
|
|
|
interval = 3600 # seconds between rounds (min 900)
|
|
# path_hash_bytes = 2 # Czech mesh: 2
|
|
|
|
# Default password for the blocks below that have none. Admin or guest:
|
|
# a guest gets everything except external sensors (humidity, ambient temp).
|
|
password = "REPLACE_ME"
|
|
|
|
[[repeater]]
|
|
name = "my-repeater" # exactly as the repeater advertises itself
|
|
|
|
# [[repeater]]
|
|
# name = "other-repeater"
|
|
# password = "its own password"
|
|
# pubkey = "64 hex chars" # only if the companion never heard its advert
|
|
# path = "5361" # force a route via other repeaters (hex hop hashes)
|