From 0edd2fb017be8e8a515a7dfea563dac261e95fe9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Rapha=C3=ABl?=
 <203084086+raphael-bynome@users.noreply.github.com>
Date: Sun, 8 Nov 2026 10:47:19 +0100
Subject: [PATCH] docs: list the user gauges exported by OpenTelemetry metrics

---
 docs/reference/monitoring/otel.md | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/docs/reference/monitoring/otel.md b/docs/reference/monitoring/otel.md
index 4d016ef4b6..496b32591c 100644
--- a/docs/reference/monitoring/otel.md
+++ b/docs/reference/monitoring/otel.md
@@ -101,6 +101,15 @@ WebUI exports the following metrics via OpenTelemetry:
 |------------------------|-----------|------|--------------------------------------|
 | `http.server.requests` | Counter   | 1    | `http.method`, `http.route`, `http.status_code` |
 | `http.server.duration` | Histogram | ms   | (same as above)                      |
+| `webui.users.total`    | Gauge     | users | (none)                              |
+| `webui.users.active`   | Gauge     | users | (none)                              |
+| `webui.users.active.today` | Gauge | users | (none)                              |
+
+The three user gauges are read from the database at each export:
+
+- `webui.users.total`: registered users.
+- `webui.users.active`: users active in the last 3 minutes.
+- `webui.users.active.today`: users active since midnight **UTC** today, not local midnight.
 
 Metrics are sent via OTLP (default every 10 seconds, configurable via `OTEL_METRICS_EXPORT_INTERVAL_MILLIS`) and can be visualized in **Grafana** (via Prometheus/Mimir).