From: Zac Dover Date: Thu, 30 Nov 2023 08:16:38 +0000 (+0100) Subject: doc/rados: improve formatting of log-and-debug.rst X-Git-Tag: v18.2.4~422^2 X-Git-Url: http://git-server-git.apps.pok.os.sepia.ceph.com/?a=commitdiff_plain;h=refs%2Fpull%2F54746%2Fhead;p=ceph.git doc/rados: improve formatting of log-and-debug.rst Improve the arrangment of information in the section "Ceph Subsystems" in doc/rados/troubleshooting/log-and-debug.rst. Co-authored-by: Anthony D'Atri Signed-off-by: Zac Dover (cherry picked from commit e63fa697b72b3c12d98169958b6dd74cc6eb5486) --- diff --git a/doc/rados/troubleshooting/log-and-debug.rst b/doc/rados/troubleshooting/log-and-debug.rst index 3117541aad3c..fa089338cfa7 100644 --- a/doc/rados/troubleshooting/log-and-debug.rst +++ b/doc/rados/troubleshooting/log-and-debug.rst @@ -175,9 +175,12 @@ For each subsystem, there is a logging level for its output logs (a so-called "log level") and a logging level for its in-memory logs (a so-called "memory level"). Different values may be set for these two logging levels in each subsystem. Ceph's logging levels operate on a scale of ``1`` to ``20``, where -``1`` is terse and ``20`` is verbose [#f1]_. As a general rule, the in-memory -logs are not sent to the output log unless one or more of the following -conditions obtain: +``1`` is terse and ``20`` is verbose. In certain rare cases, there are logging +levels that can take a value greater than 20. The resulting logs are extremely +verbose. + +The in-memory logs are not sent to the output log unless one or more of the +following conditions are true: - a fatal signal has been raised or - an assertion within Ceph code has been triggered or @@ -186,9 +189,6 @@ conditions obtain: that provides an example of how to submit admin socket commands `_ for more detail. -.. warning :: - .. [#f1] In certain rare cases, there are logging levels that can take a value greater than 20. The resulting logs are extremely verbose. - Log levels and memory levels can be set either together or separately. If a subsystem is assigned a single value, then that value determines both the log level and the memory level. For example, ``debug ms = 5`` will give the ``ms``