From ca55192311dec1392cbd02c21a9bd1b46d92b9a2 Mon Sep 17 00:00:00 2001 From: MMD Date: Sat, 19 Sep 2026 01:03:29 +0330 Subject: [PATCH] docs(monitoring): Docker Desktop local-run notes (host-metrics profile) --- monitoring/README.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/monitoring/README.md b/monitoring/README.md index 4a7683f..8d73e13 100644 --- a/monitoring/README.md +++ b/monitoring/README.md @@ -109,3 +109,16 @@ webhook uses it post-rebuild regardless of the metrics stack. - `GET /metrics` — Prometheus format (unauthenticated, for scraping). - JSON request logs with `X-Request-ID` (set `LOG_FORMAT=json` in prod) → shipped to Loki by Promtail. + +## Local runs (Docker Desktop) + +Start WITHOUT `--profile host-metrics` — node-exporter and cAdvisor need +Linux rootfs mounts and will fail to start on Windows/macOS hosts: + +```bash +docker compose -f monitoring/docker-compose.monitoring.yml --env-file .env up -d +``` + +Per-container and host metrics are absent locally; API metrics, Postgres +metrics, logs, GlitchTip and Grafana all work the same. On the Linux VPS +always include `--profile host-metrics`.