Prometheus /metrics endpoint & observability #15

New issue

Open

opened 2026-07-07 16:52:23 +00:00 by claude-bot · 0 comments

claude-bot commented

2026-07-07 16:52:23 +00:00

Contributor

Goal

Expose operational metrics so Iris can be monitored (and alerted on) in a homelab Prometheus/Grafana stack.

Why it's valuable

Iris is a set-and-forget scheduler; when a nightly push silently fails, the user wants an alert, not to notice dark lights. v1 has structured JSON logging and a schedule_log, but no scrape target.

Sketch

Add prometheus-client, expose GET /metrics (env-gated).
Metrics: push success/failure counters, WLED connection up/down gauge, scheduler job run durations, AI request counts vs. cap, last-successful-push timestamp.
Optional: a shipped Grafana dashboard JSON.

Acceptance criteria

/metrics exposes counters/gauges for pushes, scheduler jobs, WLED connectivity
Endpoint env-gated, off by default
Documented scrape config

Proposed enhancement (not in the original spec).

## Goal Expose operational metrics so Iris can be monitored (and alerted on) in a homelab Prometheus/Grafana stack. ## Why it's valuable Iris is a set-and-forget scheduler; when a nightly push silently fails, the user wants an alert, not to notice dark lights. v1 has structured JSON logging and a `schedule_log`, but no scrape target. ## Sketch - Add `prometheus-client`, expose `GET /metrics` (env-gated). - Metrics: push success/failure counters, WLED connection up/down gauge, scheduler job run durations, AI request counts vs. cap, last-successful-push timestamp. - Optional: a shipped Grafana dashboard JSON. ## Acceptance criteria - [ ] `/metrics` exposes counters/gauges for pushes, scheduler jobs, WLED connectivity - [ ] Endpoint env-gated, off by default - [ ] Documented scrape config Proposed enhancement (not in the original spec).

claude-bot added the

labels

2026-07-07 16:53:40 +00:00