Hserver Failure Notes: Observability · intermediate

Wi-Fi Signal Needed Two Measurement Paths, Not One Assumption

Hardware and drivers expose radio state differently, so a production metric may need a fallback without hiding uncertainty.

Current. Current engineering note based on recent hserver deployment, debugging, recovery, and production-hardening work in September 2026.

Robust instrumentation distinguishes 'measurement unavailable' from 'system failed'. Multiple evidence sources can be useful when each has known limitations and the fallback semantics are explicit. The host metrics collector originally relied on iw output for signal and connectivity. On the production Wi-Fi stack, that path did not always provide the complete state needed for reliable dashboards.

The collector assumed one tool represented the authoritative interface state across driver and NetworkManager behavior. That assumption made the metric brittle even though the underlying link was fine.

The collector retains iw dBm parsing when available and adds NetworkManager signal percentage as another observation path. Connectivity falls back carefully instead of treating missing output as a hard disconnect. Expose collector success and avoid turning parser failure into a user-facing outage signal. Metrics code should be tested against real production command output, not only idealized fixtures. The concrete hserver evidence is commit 218300b, so this note is tied to an actual production change rather than a hypothetical failure.

Quick navigationEsc