feat(telemetry): add /metrics prommetheus exporter

2026-08-09 03:05:14 +02:00
parent 80f2f67db6
commit 1b9d812175
9 changed files with 338 additions and 4 deletions
@@ -42,6 +42,18 @@ OXICLOUD_SERVER_HOST=127.0.0.1
 # Example: https://cloud.example.com
 #OXICLOUD_BASE_URL=https://cloud.example.com

+# Prometheus /metrics listener — OFF by default.
+# When unset (or empty), no /metrics endpoint is exposed and no
+# metrics recorder is installed (zero runtime cost).
+# When set, a SEPARATE HTTP listener on this address serves the
+# text-format scrape at /metrics. It is NOT merged into the main
+# API — no auth, CSRF, or DPoP layer in front. Bind it to loopback
+# or a private interface; make it publicly reachable only if you
+# intend to expose metrics publicly.
+# Format: host:port (IPv6 allowed, e.g. [::1]:9090).
+# Recommended: 127.0.0.1:9090 with node_exporter-style scrapers.
+#OXICLOUD_METRICS_LISTEN=127.0.0.1:9090
+
 # ── Upload size caps ──────────────────────────────────────────────────
 # See docs/config/storage-fine-tuning.md for sizing guidance.