Explorar o código

Add Logback config to java REST client docs (#94358)

Saman Nourkhalaj %!s(int64=2) %!d(string=hai) anos
pai
achega
7c342f1241
Modificáronse 1 ficheiros con 34 adicións e 0 borrados
  1. 34 0
      docs/java-rest/low-level/usage.asciidoc

+ 34 - 0
docs/java-rest/low-level/usage.asciidoc

@@ -420,3 +420,37 @@ still yields the same response as it did. Enable trace logging for the `tracer`
 package to have such log lines printed out. Do note that this type of logging is
 expensive and should not be enabled at all times in production environments,
 but rather temporarily used only when needed.
+
+==== Logback
+===== Trace Logs
+In order to enable trace logs for logback, we have to use https://www.slf4j.org/legacy.html#jclOverSLF4J[jcl-over-slf4j bridging module].
+
+1. Add the following to your Gradle setting:
+[source,groovy]
+dependencies {
+    implementation('org.slf4j:slf4j-api:1.8.0-beta2')
+    implementation('ch.qos.logback:logback-classic:1.3.0-alpha4')
+    implementation('org.slf4j:jcl-over-slf4j:1.8.0-beta2')
+}
+
+2. Exclude `commons-logging.jar`:
+[source,groovy]
+dependencies {
+    configurations.all {
+        exclude group: "commons-logging", module: "commons-logging"
+    }
+}
+
+3. Add a tracer logger in Logback configuration:
+[source,xml]
+<logger name="tracer" level="TRACE" additivity="false">
+    <appender-ref ref="your_appender_block_name" />
+</logger>
+
+===== RestClient Debug Logs
+To enable debug logs for `RestClient` class, add the following to your Logback configuration:
+[source,xml]
+<logger name="org.elasticsearch.client.RestClient" level="DEBUG" additivity="false">
+    <appender-ref ref="your_appender_block_name" />
+</logger>
+