Skip to content

feat(mqtt): expose client and traffic telemetry to Home Assistant - #402

Merged
gnacho merged 1 commit into
mainfrom
feat/401-telemetry
Sep 23, 2026
Merged

gnacho merged 1 commit into
mainfrom
feat/401-telemetry

Conversation

@gnacho

@gnacho gnacho commented Sep 23, 2026

Copy link
Copy Markdown
Owner

Extends the MQTT state and Home Assistant discovery with aggregated client telemetry, built from NetGrip's own client probe (no NetPulse server involved):

  • total clients, split into Wi-Fi (2.4/5 GHz) and wired
  • clients with a weak signal
  • cumulative RX/TX bytes

New sensors in Home Assistant: Clients, Wi-Fi clients, Wired clients, Weak-signal clients and the RX/TX totals. Per-client entities are intentionally out of scope (100+ clients would flood Home Assistant).

The probe is cached briefly so the periodic publish does not add a second fork storm on top of the panel's own requests.

Verification: go test ./... and go vet pass. Deployed on two routers, Home Assistant created the new entities (19 per router) and the live aggregation reported real client counts (48 clients on the busiest one). The byte totals read zero without per-client counters/nlbwmon; they populate where the router exposes them.

Closes #401

Add aggregated client telemetry (total, Wi-Fi/wired split, weak-signal count
and cumulative RX/TX bytes) to the MQTT state, with the matching discovery
entities. Built from the existing client probe, cached briefly so the periodic
publish does not add a second fork storm on top of the panel's requests.

Per-client entities are intentionally out of scope: a network with 100+ clients
would flood Home Assistant.
@gnacho
gnacho merged commit a49a34e into main Sep 23, 2026
1 check passed
@gnacho
gnacho deleted the feat/401-telemetry branch September 23, 2026 08:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

feat(mqtt): expose client and traffic telemetry to Home Assistant

1 participant