Cody LeeandCursor
912ea91ac0
Prefer a known stats channel and fall back to airQuality for temperature and humidity. Omit channels whose status is unknown, and add the particulate and gas series only when the controller includes them. Co-authored-by: Cursor <cursoragent@cursor.com>
prometheus
This package provides the interface to turn UniFi measurements into prometheus exported metrics. Requires the poller package for actual UniFi data collection.
Scrape cache
By default, Prometheus scrapes are served from an in-memory cache refreshed by a
background poller on a fixed interval. This decouples the scrape cadence from the
UniFi API call cadence: scrapes always return immediately, and upstream backpressure
(e.g. 429 Too Many Requests) no longer stalls /metrics. Set interval = 0 to
disable the cache and restore on-demand /metrics fetches.
Config (TOML):
[prometheus]
http_listen = "0.0.0.0:9130"
# How often the background poller refreshes the cache served to /metrics.
# Omitted: cache on, 60s. Set to 0 / "0" / "0s" to disable the cache so
# /metrics fetches live. Values below 15s log a warning but are not clamped.
interval = "60s"
Environment variable: UP_PROMETHEUS_INTERVAL (same contract; 0 / 0s disables the cache).
On poll error the last successful snapshot is preserved, so a transient 429 no
longer empties /metrics. To monitor cache staleness, scrape the
unpoller_prometheus_cache_age_seconds gauge — it reports seconds since the
last successful background refresh, or -1 if no refresh has succeeded yet.
The /scrape endpoint (per-target dynamic scrapes) still fetches live but
coalesces concurrent requests for the same target via singleflight, so a
noisy scraper cannot multiply upstream load.