From 478b0492ea1526a2941ef714f9c9c7c4bcbb57a9 Mon Sep 17 00:00:00 2001
From: Etienne Dysli Metref <edysli@users.noreply.github.com>
Date: Thu, 6 Oct 2022 01:54:39 +0200
Subject: [PATCH] Update docs about logging configuration (#5976)

* Recommend disabling Apache HTTP client wire logging
* Recommend enabling debug logging only for org.testcontainers

Fixes #4913

Co-authored-by: Kevin Wittek <kiview@users.noreply.github.com>
---
 docs/supported_docker_environment/logging_config.md | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/docs/supported_docker_environment/logging_config.md b/docs/supported_docker_environment/logging_config.md
index 5c7abcd211c..3e4660e85ae 100644
--- a/docs/supported_docker_environment/logging_config.md
+++ b/docs/supported_docker_environment/logging_config.md
@@ -18,5 +18,14 @@ should be included in your classpath to show a reasonable level of log output:
 
     <logger name="org.testcontainers" level="INFO"/>
     <logger name="com.github.dockerjava" level="WARN"/>
+    <logger name="com.github.dockerjava.zerodep.shaded.org.apache.hc.client5.http.wire" level="OFF"/>
 </configuration>
 ```
+
+In order to troubleshoot issues with Testcontainers, increase the logging level of `org.testcontainers` to `DEBUG`:
+
+```xml
+<logger name="org.testcontainers" level="DEBUG"/>
+```
+
+Avoid changing the root logger's level to `DEBUG`, because this turns on debug logging for every package whose level isn't explicitly configured here, resulting in a large amount of log data.