]> git.apps.os.sepia.ceph.com Git - ceph.git/commitdiff
doc/rados: improve formatting of log-and-debug.rst 54731/head
authorZac Dover <zac.dover@proton.me>
Thu, 30 Nov 2023 08:16:38 +0000 (09:16 +0100)
committerZac Dover <zac.dover@proton.me>
Fri, 1 Dec 2023 09:35:42 +0000 (10:35 +0100)
Improve the arrangment of information in the section "Ceph Subsystems"
in doc/rados/troubleshooting/log-and-debug.rst.

Co-authored-by: Anthony D'Atri <anthony.datri@gmail.com>
Signed-off-by: Zac Dover <zac.dover@proton.me>
doc/rados/troubleshooting/log-and-debug.rst

index 7c3f848b54610364c45cddd4f8cd753e36038a70..7d288552213254770eaf1ca4e0fc50b3760a5dc8 100644 (file)
@@ -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
   <http://docs.ceph.com/en/latest/man/8/ceph/#daemon>`_ 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``