Pārlūkot izejas kodu

[DOCS] Clarify logger-package relationship (#65169)

Updates the logging level docs to better clarify the relationship
between loggers and their Java packages.
James Rodewig 4 gadi atpakaļ
vecāks
revīzija
661409a5a0
1 mainītis faili ar 28 papildinājumiem un 44 dzēšanām
  1. 28 44
      docs/reference/setup/logging-config.asciidoc

+ 28 - 44
docs/reference/setup/logging-config.asciidoc

@@ -139,67 +139,51 @@ documentation].
 [[configuring-logging-levels]]
 === Configuring logging levels
 
-There are four ways to configuring logging levels, each having situations in which they are appropriate to use.
-
-1. Via the command-line: `-E <name of logging hierarchy>=<level>` (e.g.,
-   `-E logger.org.elasticsearch.transport=trace`). This is most appropriate when
-   you are temporarily debugging a problem on a single node (for example, a
-   problem with startup, or during development).
-2. Via `elasticsearch.yml`: `<name of logging hierarchy>: <level>` (e.g.,
-   `logger.org.elasticsearch.transport: trace`). This is most appropriate when
-   you are temporarily debugging a problem but are not starting Elasticsearch
-   via the command-line (e.g., via a service) or you want a logging level
-   adjusted on a more permanent basis.
-3. Via <<cluster-logger,cluster settings>>:
-+
---
-[source,js]
--------------------------------
-PUT /_cluster/settings
-{
-  "transient": {
-    "<name of logging hierarchy>": "<level>"
-  }
-}
--------------------------------
-// NOTCONSOLE
+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.
 
-For example:
+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`.
 
 [source,console]
--------------------------------
+----
 PUT /_cluster/settings
 {
   "transient": {
-    "logger.org.elasticsearch.transport": "trace"
+    "logger.org.elasticsearch.transport": "TRACE"
   }
 }
--------------------------------
+----
 
-This is most appropriate when you need to dynamically need to adjust a logging
-level on an actively-running cluster.
+Other ways to change log levels include:
 
---
-4. Via the `log4j2.properties`:
+1. `elasticsearch.yml`:
 +
 --
-[source,properties]
---------------------------------------------------
-logger.<unique_identifier>.name = <name of logging hierarchy>
-logger.<unique_identifier>.level = <level>
---------------------------------------------------
+[source,yaml]
+----
+logger.org.elasticsearch.transport: TRACE
+----
 
-For example:
+This is most appropriate when debugging a problem on a single node.
+--
 
+2. `log4j2.properties`:
++
+--
 [source,properties]
---------------------------------------------------
-logger.transport.name = org.elasticsearch.transport
+----
 logger.transport.level = trace
---------------------------------------------------
+----
 
-This is most appropriate when you need fine-grained control over the logger (for
-example, you want to send the logger to another file, or manage the logger
-differently; this is a rare use-case).
+This is most appropriate when you already need to change your Log4j 2
+configuration for other reasons. For example, you may want to send logs for a
+particular logger to another file. However, these use cases are rare.
 --
 
 [discrete]