From 3fe4d0971325ba9e10cd65882e1a16bb19a203b0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?D=C3=A1vid=20Szab=C3=B3?= <david.szabo97@gmail.com>
Date: Wed, 7 Sep 2022 20:24:30 +0200
Subject: [PATCH] metrics: Add caddy_reverse_proxy_upstreams_healthy (#257)

---
 src/docs/markdown/metrics.md | 15 ++++++++++++++-
 1 file changed, 14 insertions(+), 1 deletion(-)

diff --git a/src/docs/markdown/metrics.md b/src/docs/markdown/metrics.md
index 53ef4ab..f8f0b74 100644
--- a/src/docs/markdown/metrics.md
+++ b/src/docs/markdown/metrics.md
@@ -70,11 +70,12 @@ caddy_http_request_duration_seconds_bucket{code="308",handler="static_response",
 ...
 ```
 
-There are a number of metrics you'll see, that broadly fall under 3 categories:
+There are a number of metrics you'll see, that broadly fall under 4 categories:
 
 - Runtime metrics
 - Admin API metrics
 - HTTP Middleware metrics
+- Reverse proxy metrics
 
 ### Runtime metrics
 
@@ -215,6 +216,18 @@ Label  | Description
 `code` | HTTP status code
 `method` | The HTTP method
 
+### Reverse proxy metrics
+
+#### `caddy_reverse_proxy_upstreams_healthy`
+
+A gauge of the reverse proxy upstreams healthiness.
+
+Value `0` means the upstream is unhealthy, where as `1` means the upstream is healthy.
+
+Label  | Description
+-------|------------
+`upstream` | Address of the upstream
+
 ## Sample Queries
 
 Once you have Prometheus scraping Caddy's metrics, you can start to see some