Skip to content

v2026-03-04.1 — Prometheus Metrics Endpoint

Choose a tag to compare

View all tags
@itsDNNS itsDNNS released this 04 Mar 09:50
· 953 commits to main since this release
v2026-03-04.1
6d95d08

What's New

DOCSight now exposes all DOCSIS signal metrics via a Prometheus-compatible /metrics endpoint, enabling integration with Grafana/Prometheus monitoring stacks.

Features

  • GET /metrics returns all channel metrics in Prometheus text exposition format (text/plain; version=0.0.4; charset=utf-8)
  • Per-channel downstream metrics: power, SNR, correctable/uncorrectable errors, modulation (as numeric QAM order)
  • Per-channel upstream metrics: power, modulation
  • Summary metrics: health status (0-3), channel counts
  • Device info: model, software version, uptime
  • Connection info: max downstream/upstream kbps
  • Poll timestamp: Unix epoch gauge of last successful modem poll
  • No auth required: endpoint is always accessible (like /health)
  • No additional modem queries: reads from existing in-memory state

Technical Details

  • Pure format_metrics() function with no external dependencies
  • 60 new tests (52 unit + 8 integration), 860 total passing
  • Closes #59
Assets 2
Loading