📊 Prometheus Monitoring Stack
Host: Homelab · Compose:
Homelab/Docker/prometheus/compose.yaml
Stack name:prometheus[!NOTE] Update Available: Updates for this stack are pending in:
renovate/docker-dependencies,renovate/major-docker-dependencies.
1. Overview
A comprehensive Prometheus-based monitoring stack with exporters for nearly every service in the homelab. Metrics are collected from AdGuard, UniFi, all *arr applications, qBittorrent, MQTT, PostgreSQL, UPS (NUT), and Immich, then visualised in Grafana.
2. Architecture & Services
| Service | Image | Port | Role |
|---|---|---|---|
adguard_exporter_1 |
ebrianne/adguard-exporter:v1.14 |
— | — |
adguard_exporter_2 |
ebrianne/adguard-exporter:v1.14 |
— | — |
adguard_exporter_3 |
ebrianne/adguard-exporter:v1.14 |
— | — |
adguard_exporter_4 |
ebrianne/adguard-exporter:v1.14 |
— | — |
adguard_exporter_5 |
ebrianne/adguard-exporter:v1.14 |
— | — |
lidarr-exporter |
ghcr.io/onedr0p/exportarr:v2.3 |
9709 |
Lidarr metrics |
mqtt-exporter |
jryberg/mosquitto-exporter:v0.7.8 |
— | MQTT broker metrics |
nut-exporter |
hon95/prometheus-nut-exporter:1.2.1 |
9995 |
UPS (NUT) metrics |
postgres-exporter |
prometheuscommunity/postgres-exporter:v0.20.1 |
— | PostgreSQL metrics |
prometheus |
prom/prometheus:v3.14.0 |
9090 |
Core metrics storage and query engine |
prowlarr-exporter |
ghcr.io/onedr0p/exportarr:v2.3 |
9710 |
Prowlarr metrics |
qbittorrent-exporter |
caseyscarborough/qbittorrent-exporter:v1.3.5 |
— | qBittorrent metrics |
radarr-exporter |
ghcr.io/onedr0p/exportarr:v2.3 |
9708 |
Radarr metrics |
readarr-exporter |
ghcr.io/onedr0p/exportarr:v2.3 |
9713 |
Readarr metrics |
sonarr-exporter |
ghcr.io/onedr0p/exportarr:v2.3 |
9707 |
Sonarr metrics |
unpoller |
ghcr.io/unpoller/unpoller:v3.5.0 |
— | UniFi controller metrics |
3. Networking
apps— —backend— —database— —
4. Persistent Storage
| Container | Host Path / Volume | Description |
|---|---|---||
| prometheus | /docker/data/prometheus/prometheus | prometheus.yml config and TSDB data |
5. Environment Variables
| Variable | Service | Description |
|---|---|---|
adguard_hostname |
adguard_exporter_1 |
— |
adguard_password |
adguard_exporter_1 |
— |
adguard_protocol |
adguard_exporter_1 |
— |
adguard_username |
adguard_exporter_1 |
— |
interval |
adguard_exporter_1 |
— |
log_limit |
adguard_exporter_1 |
— |
adguard_hostname |
adguard_exporter_2 |
— |
adguard_password |
adguard_exporter_2 |
— |
adguard_protocol |
adguard_exporter_2 |
— |
adguard_username |
adguard_exporter_2 |
— |
interval |
adguard_exporter_2 |
— |
log_limit |
adguard_exporter_2 |
— |
adguard_hostname |
adguard_exporter_3 |
— |
adguard_password |
adguard_exporter_3 |
— |
adguard_protocol |
adguard_exporter_3 |
— |
adguard_username |
adguard_exporter_3 |
— |
interval |
adguard_exporter_3 |
— |
log_limit |
adguard_exporter_3 |
— |
adguard_hostname |
adguard_exporter_4 |
— |
adguard_password |
adguard_exporter_4 |
— |
adguard_protocol |
adguard_exporter_4 |
— |
adguard_username |
adguard_exporter_4 |
— |
interval |
adguard_exporter_4 |
— |
log_limit |
adguard_exporter_4 |
— |
adguard_hostname |
adguard_exporter_5 |
— |
adguard_password |
adguard_exporter_5 |
— |
adguard_protocol |
adguard_exporter_5 |
— |
adguard_username |
adguard_exporter_5 |
— |
interval |
adguard_exporter_5 |
— |
log_limit |
adguard_exporter_5 |
— |
APIKEY |
lidarr-exporter |
— |
PORT |
lidarr-exporter |
— |
URL |
lidarr-exporter |
— |
HTTP_PATH |
nut-exporter |
— |
HTTP_PORT |
nut-exporter |
— |
LOG_REQUESTS_CONSOLE |
nut-exporter |
— |
PRINT_METRICS_AND_EXIT |
nut-exporter |
— |
RUST_LOG |
nut-exporter |
— |
TZ |
nut-exporter |
— |
DATA_SOURCE_PASS |
postgres-exporter |
— |
DATA_SOURCE_URI |
postgres-exporter |
— |
DATA_SOURCE_USER |
postgres-exporter |
— |
APIKEY |
prowlarr-exporter |
— |
PORT |
prowlarr-exporter |
— |
URL |
prowlarr-exporter |
— |
QBITTORRENT_BASE_URL |
qbittorrent-exporter |
— |
QBITTORRENT_PASSWORD |
qbittorrent-exporter |
— |
QBITTORRENT_USERNAME |
qbittorrent-exporter |
— |
APIKEY |
radarr-exporter |
— |
PORT |
radarr-exporter |
— |
URL |
radarr-exporter |
— |
APIKEY |
readarr-exporter |
— |
PORT |
readarr-exporter |
— |
URL |
readarr-exporter |
— |
APIKEY |
sonarr-exporter |
— |
PORT |
sonarr-exporter |
— |
URL |
sonarr-exporter |
— |
UP_INFLUXDB_DISABLE |
unpoller |
— |
UP_POLLER_DEBUG |
unpoller |
— |
UP_PROMETHEUS_HTTP_LISTEN |
unpoller |
— |
UP_PROMETHEUS_NAMESPACE |
unpoller |
— |
UP_UNIFI_CONTROLLER_0_PASS |
unpoller |
— |
UP_UNIFI_CONTROLLER_0_SAVE_ALARMS |
unpoller |
— |
UP_UNIFI_CONTROLLER_0_SAVE_ANOMALIES |
unpoller |
— |
UP_UNIFI_CONTROLLER_0_SAVE_DPI |
unpoller |
— |
UP_UNIFI_CONTROLLER_0_SAVE_EVENTS |
unpoller |
— |
UP_UNIFI_CONTROLLER_0_SAVE_IDS |
unpoller |
— |
UP_UNIFI_CONTROLLER_0_SAVE_SITES |
unpoller |
— |
UP_UNIFI_CONTROLLER_0_URL |
unpoller |
— |
UP_UNIFI_CONTROLLER_0_USER |
unpoller |
— |
UP_UNIFI_DYNAMIC |
unpoller |
— |
6. Access & Usage
| URL | Description |
|---|---|
http://localhost:9090 |
Prometheus UI |
https://grafana.m1ckyb.com |
Grafana dashboards (OAuth via Authentik) |
# Start
docker compose -f Homelab/Docker/prometheus/compose.yaml up -d
# Reload config without restart
curl -X POST http://localhost:9090/-/reload
# Check all targets
curl http://localhost:9090/api/v1/targets | jq '.data.activeTargets[] | {job:.labels.job, health:.health}'