From 3c3e49e3852dcf434fc86c0d3ef479166c661e40 Mon Sep 17 00:00:00 2001
From: Geoff Bourne <itzgeoff@gmail.com>
Date: Sat, 11 Jul 2026 11:14:21 -0500
Subject: [PATCH] Document troubleshooting of Reactor Netty's HTTP client
 (#4153)

---
 docs/misc/troubleshooting.md | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/docs/misc/troubleshooting.md b/docs/misc/troubleshooting.md
index e36071f1..1c949988 100644
--- a/docs/misc/troubleshooting.md
+++ b/docs/misc/troubleshooting.md
@@ -51,4 +51,11 @@ When exec'ed interactively into the container, jattach can be invoked against th
     
     ```shell
     jattach $(pgrep java) threaddump
-    ```
\ No newline at end of file
+    ```
+
+## Networking errors
+
+If observing network error/exceptions that involve the term "reactor.netty.http.client", then further tracing logs can be enabled by setting the following environment variables:
+
+- `FETCH_WIRETAP` to `true`
+- `HELPER_LOGGING_LEVEL` to `trace`
\ No newline at end of file