Skip to content

Prometheus Metrics

ChannelWatch exposes a Prometheus endpoint at /metrics. This page documents only the metrics confirmed in the current backend implementation.

GET /metrics

The endpoint returns standard Prometheus text exposition:

scrape_configs:
- job_name: channelwatch
static_configs:
- targets: ['channelwatch-host:8501']
scrape_interval: 30s

The current source-backed metrics are:

MetricTypeNotes
channelwatch_uptime_secondsGaugeSeconds since the UI backend started
channelwatch_active_streamsGaugeAggregate active streams plus per-DVR labeled series
channelwatch_core_runningGauge1 when the core process is running, 0 otherwise
channelwatch_configured_dvrsGaugeNumber of enabled DVRs in the current settings
channelwatch_disk_free_bytesGaugeAggregate and per-DVR free storage bytes
channelwatch_disk_total_bytesGaugeAggregate and per-DVR total storage bytes
channelwatch_disk_used_bytesGaugeAggregate and per-DVR used storage bytes
channelwatch_dvr_connectedGaugePer-DVR reachability state
channelwatch_dvr_version_infoGaugePer-DVR version metadata; metric value is always 1

Any other metric names previously documented should be treated as stale unless you confirm them in the current app source.

The per-DVR variants of these metrics use:

  • dvr_id
  • dvr_name
  • host
  • port

This label set is used for:

  • channelwatch_dvr_connected
  • per-DVR channelwatch_active_streams
  • per-DVR channelwatch_disk_free_bytes
  • per-DVR channelwatch_disk_total_bytes
  • per-DVR channelwatch_disk_used_bytes

The aggregate disk-byte series use:

  • scope="all"

channelwatch_dvr_version_info uses these labels:

  • dvr_id
  • dvr_name
  • version
  • compatible

The sample value is always 1; the version and compatibility state live in the labels.

channelwatch_dvr_connected
channelwatch_active_streams{dvr_name="Living Room"}
channelwatch_disk_free_bytes{scope="all"}
channelwatch_dvr_version_info{compatible="0"}