Pārlūkot izejas kodu

Give a less dangerous example of logger config (#66318)

Today the docs use `logger.org.elasticsearch.transport: TRACE` as the
example for adjusting the logger config. This is a dangerous thing to
suggest since that's one of the most verbose loggers we have. An
accidental copy-and-paste of this example into a busy cluster can
cause damage.

This commit suggests `logger.org.elasticsearch.discovery: DEBUG`
instead, which is much more benign.

It also corrects the order of the levels and notes that `DEBUG` and
`TRACE` are only for expert use.
David Turner 4 gadi atpakaļ
vecāks
revīzija
b706e0dd69
1 mainītis faili ar 9 papildinājumiem un 8 dzēšanām
  1. 9 8
      docs/reference/setup/logging-config.asciidoc

+ 9 - 8
docs/reference/setup/logging-config.asciidoc

@@ -140,22 +140,23 @@ documentation].
 === Configuring logging levels
 
 Each Java package in the {es-repo}[{es} source code] has a related logger. For
-example, the `org.elasticsearch.transport` package has
-`logger.org.elasticsearch.transport` for logs related to communication between
-nodes.
+example, the `org.elasticsearch.discovery` package has
+`logger.org.elasticsearch.discovery` for logs related to the
+<<modules-discovery-hosts-providers,discovery>> process.
 
 To get more or less verbose logs, use the <<cluster-update-settings,cluster
 update settings API>> to change the related logger's log level. Each logger
 accepts Log4j 2's built-in log levels, from least to most verbose: `OFF`,
-`FATAL`, `ERROR`, `WARN`, `INFO`, `TRACE`, and `DEBUG`. The default log level is
-`INFO`.
+`FATAL`, `ERROR`, `WARN`, `INFO`, `DEBUG`, and `TRACE`. The default log level is
+`INFO`. Messages logged at higher verbosity levels (`DEBUG` and `TRACE`) are
+only intended for expert use.
 
 [source,console]
 ----
 PUT /_cluster/settings
 {
   "transient": {
-    "logger.org.elasticsearch.transport": "TRACE"
+    "logger.org.elasticsearch.discovery": "DEBUG"
   }
 }
 ----
@@ -167,7 +168,7 @@ Other ways to change log levels include:
 --
 [source,yaml]
 ----
-logger.org.elasticsearch.transport: TRACE
+logger.org.elasticsearch.discovery: DEBUG
 ----
 
 This is most appropriate when debugging a problem on a single node.
@@ -178,7 +179,7 @@ This is most appropriate when debugging a problem on a single node.
 --
 [source,properties]
 ----
-logger.transport.level = trace
+logger.org.elasticsearch.discovery.level = debug
 ----
 
 This is most appropriate when you already need to change your Log4j 2