From 5de70e28c271cfab3dfe68370a8bd3653bf0f992 Mon Sep 17 00:00:00 2001
From: mfkd <mattkfd@gmail.com>
Date: Wed, 22 Oct 2025 14:08:34 +0200
Subject: [PATCH] Add circuit breaker metrics documentation

Signed-off-by: mfkd <mattkfd@gmail.com>
---
 content/master/guides/metrics.md | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/content/master/guides/metrics.md b/content/master/guides/metrics.md
index 255d584e2..9af3a719f 100644
--- a/content/master/guides/metrics.md
+++ b/content/master/guides/metrics.md
@@ -55,4 +55,7 @@ prometheus.io/scrape: "true"
 | {{<hover label="crossplane_managed_resource_first_time_to_readiness_seconds_bucket" line="27">}}crossplane_managed_resource_first_time_to_readiness_seconds_bucket{{</hover>}} | The time it took for a managed resource to become ready first time after creation |  |
 | {{<hover label="crossplane_managed_resource_first_time_to_reconcile_seconds_bucket" line="28">}}crossplane_managed_resource_first_time_to_reconcile_seconds_bucket{{</hover>}} | The time it took to detect a managed resource by the controller |  |
 | {{<hover label="upjet_resource_ttr_bucket" line="29">}}upjet_resource_ttr_bucket{{</hover>}} | Measures in seconds the `time-to-readiness` `(TTR)` for managed resources |  |
-{{</table >}}
\ No newline at end of file
+| {{<hover label="circuit_breaker_opens_total" line="30">}}circuit_breaker_opens_total{{</hover>}} | Total number of times the XR watch circuit breaker opened |  |
+| {{<hover label="circuit_breaker_closes_total" line="31">}}circuit_breaker_closes_total{{</hover>}} | Total number of times the XR watch circuit breaker closed again |  |
+| {{<hover label="circuit_breaker_events_total" line="32">}}circuit_breaker_events_total{{</hover>}} | Total number of watched events handled by the XR circuit breaker | Labeled by outcome (`Allowed`, `HalfOpenAllowed`, `Dropped`); deletion events skip the breaker. |
+{{</table >}}