Prometheus Metrics

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

Scrape endpoint

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 metrics are:

Metric	Type	Notes
`channelwatch_uptime_seconds`	Gauge	Seconds since the UI backend started
`channelwatch_active_streams`	Gauge	Aggregate active streams plus per-DVR labeled series
`channelwatch_core_running`	Gauge	`1` when the core process is running, `0` otherwise
`channelwatch_configured_dvrs`	Gauge	Number of enabled DVRs in the current settings
`channelwatch_disk_free_bytes`	Gauge	Aggregate and per-DVR free storage bytes
`channelwatch_disk_total_bytes`	Gauge	Aggregate and per-DVR total storage bytes
`channelwatch_disk_used_bytes`	Gauge	Aggregate and per-DVR used storage bytes
`channelwatch_dvr_connected`	Gauge	Per-DVR reachability state
`channelwatch_dvr_version_info`	Gauge	Per-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:

This label set is used for:

The aggregate disk-byte series use:

channelwatch_dvr_version_info uses these labels:

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"}