Explain metrics endpoint availability on port 9100

emyller · emyller · commit ebaa535493e3 · 2026-01-20T14:46:46.000-03:00
diff --git a/src/common/core/templates/docgen-metrics.md b/src/common/core/templates/docgen-metrics.md
@@ -6,7 +6,9 @@ sidebar_position: 20
 
 ## Prometheus
 
-To enable the Prometheus `/metrics` endpoint, set the `PROMETHEUS_ENABLED` environment variable to `true`. 
+To enable the Prometheus `/metrics` endpoint, set the `PROMETHEUS_ENABLED` environment variable to `true`.
+
+When enabled, Flagsmith serves the `/metrics` endpoint on a standalone HTTP server on port 9100, separate from the main API server. This design ensures that metrics collection remains available even when the main API is under heavy load.
 
 The metrics provided by Flagsmith are described below.
 
diff --git a/tests/integration/core/snapshots/test_docgen__metrics__runs_expected.txt b/tests/integration/core/snapshots/test_docgen__metrics__runs_expected.txt
@@ -6,7 +6,9 @@ sidebar_position: 20
 
 ## Prometheus
 
-To enable the Prometheus `/metrics` endpoint, set the `PROMETHEUS_ENABLED` environment variable to `true`. 
+To enable the Prometheus `/metrics` endpoint, set the `PROMETHEUS_ENABLED` environment variable to `true`.
+
+When enabled, Flagsmith serves the `/metrics` endpoint on a standalone HTTP server on port 9100, separate from the main API server. This design ensures that metrics collection remains available even when the main API is under heavy load.
 
 The metrics provided by Flagsmith are described below.
 
