From b9237a5a813a158193cb70e37133837dea859287 Mon Sep 17 00:00:00 2001
From: Steffen Busch <37350514+steffenbusch@users.noreply.github.com>
Date: Sat, 1 Jun 2024 23:55:16 +0200
Subject: [PATCH] Use log_append for upstream details

---
 .../caddyfile/directives/log_append.md        | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/src/docs/markdown/caddyfile/directives/log_append.md b/src/docs/markdown/caddyfile/directives/log_append.md
index a996894..b86555b 100644
--- a/src/docs/markdown/caddyfile/directives/log_append.md
+++ b/src/docs/markdown/caddyfile/directives/log_append.md
@@ -37,3 +37,22 @@ example.com {
 	}
 }
 ```
+
+Display in the logs, which reverse proxy upstream was effectively used (either `node1:80`, `node2:80` or `node3:80`) and
+the time spent proxying to the upstream in milliseconds as well as how long it took the proxy upstream to write the response header:
+
+```caddy
+example.com {
+	log
+
+	handle {
+		reverse_proxy node1:80 node2:80 node3:80 {
+			header_up Host {upstream_hostport}
+			lb_policy random_choose 2 
+        }
+		log_append upstream-host "{http.reverse_proxy.upstream.host}"
+		log_append upstream-duration-ms "{http.reverse_proxy.upstream.duration_ms}"
+		log_append upstream-latency-ms "{http.reverse_proxy.upstream.latency_ms}"
+	}
+}
+```