From 5cf651a6957b6178da9f0429f40b89ae647e843d Mon Sep 17 00:00:00 2001 From: Sebastian Bernauer Date: Thu, 27 Nov 2025 11:44:55 +0100 Subject: [PATCH 1/2] docs: Point users to Prometheus status/bundle metrics --- docs/modules/opa/pages/usage-guide/monitoring.adoc | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/modules/opa/pages/usage-guide/monitoring.adoc b/docs/modules/opa/pages/usage-guide/monitoring.adoc index ddaac97a..009f555b 100644 --- a/docs/modules/opa/pages/usage-guide/monitoring.adoc +++ b/docs/modules/opa/pages/usage-guide/monitoring.adoc @@ -3,3 +3,9 @@ The managed OPA instances are automatically configured to export Prometheus metrics. See xref:operators:monitoring.adoc[] for more details. + +You can read on the list of exported metrics in the https://www.openpolicyagent.org/docs/monitoring#prometheus[OPA monitoring documentation]. + +Especially worth mentioning are the https://www.openpolicyagent.org/docs/monitoring#status-metrics[Status metrics], which contain e.g. `opa_info`, `bundle_loaded_counter` and `bundle_failed_load_counter`. +You can use those to create a Dashboard to quickly see any bundle loading problems. +Additionally, you can use set up an alert based on this, so that you are proactively informed. From d1cb92c88df3755d6246116ed1a6eb198a88e551 Mon Sep 17 00:00:00 2001 From: Sebastian Bernauer Date: Thu, 27 Nov 2025 12:14:57 +0100 Subject: [PATCH 2/2] Apply suggestions from code review Co-authored-by: Lars Francke --- docs/modules/opa/pages/usage-guide/monitoring.adoc | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/modules/opa/pages/usage-guide/monitoring.adoc b/docs/modules/opa/pages/usage-guide/monitoring.adoc index 009f555b..9e991117 100644 --- a/docs/modules/opa/pages/usage-guide/monitoring.adoc +++ b/docs/modules/opa/pages/usage-guide/monitoring.adoc @@ -4,8 +4,8 @@ The managed OPA instances are automatically configured to export Prometheus metrics. See xref:operators:monitoring.adoc[] for more details. -You can read on the list of exported metrics in the https://www.openpolicyagent.org/docs/monitoring#prometheus[OPA monitoring documentation]. +You can read the list of exported metrics in the https://www.openpolicyagent.org/docs/monitoring#prometheus[OPA monitoring documentation]. Especially worth mentioning are the https://www.openpolicyagent.org/docs/monitoring#status-metrics[Status metrics], which contain e.g. `opa_info`, `bundle_loaded_counter` and `bundle_failed_load_counter`. -You can use those to create a Dashboard to quickly see any bundle loading problems. -Additionally, you can use set up an alert based on this, so that you are proactively informed. +You can use these to create a dashboard to see any bundle loading problems at a glance. +You can also set up alerts to get notified proactively.