github itsDNNS/docsight v2026-03-04.1
v2026-03-04.1 — Prometheus Metrics Endpoint

latest releases: v2026-08-13.1, v2026-08-07.1, v2026-07-29.1...
5 months ago

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

Don't miss a new docsight release

NewReleases is sending notifications on new releases.