]> git.apps.os.sepia.ceph.com Git - ceph.git/commitdiff
doc/rados: improve formatting of log-and-debug.rst 54746/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 10:49:44 +0000 (11:49 +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>
(cherry picked from commit e63fa697b72b3c12d98169958b6dd74cc6eb5486)

doc/rados/troubleshooting/log-and-debug.rst

index 3117541aad3cc8d57d11f6a189a054a984768a5c..fa089338cfa7e315594594d86fd2025a52c56b3f 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``