[PATCH 28/29] docs: logging: Replace example by link to kbase/debuglogs.html
pkrempa at redhat.com
Mon Mar 28 12:10:43 UTC 2022
The 'debuglogs' knowledge base page has way more info and examples on
how to set logging use it instead of the ad-hoc examples.
Signed-off-by: Peter Krempa <pkrempa at redhat.com>
docs/logging.rst | 34 +++-------------------------------
1 file changed, 3 insertions(+), 31 deletions(-)
diff --git a/docs/logging.rst b/docs/logging.rst
index 204176c6f5..c7c14504ae 100644
@@ -210,34 +210,6 @@ specific message ID values
-For example setting up the following:
- export LIBVIRT_DEBUG=1
- export LIBVIRT_LOG_OUTPUTS="1:file:virsh.log"
-and then running virsh will accumulate the logs in the ``virsh.log`` file in a
-way similar to:
- 14:29:04.771: debug : virInitialize:278 : register drivers
- 14:29:04.771: debug : virRegisterDriver:618 : registering Test as driver 0
-the messages are timestamped, there is also the level recorded, if debug the
-name of the function is also printed and then the formatted message. This should
-be sufficient to at least get a precise idea of what is happening and where
-things are going wrong, allowing to then put the correct breakpoints when
-running under a debugger.
-To activate full debug of the libvirt entry points, utility functions and the
-QEMU/KVM driver, set:
- log_filters="1:libvirt 1:util 1:qemu"
-in libvirtd.conf and restart the daemon will allow to gather a copious amount of
-debugging traces for the operations done in those areas.
+Examples with useful log settings along with more information on how to properly
+configure logging for various situations can be found in the
+`logging knowledge base article <kbase/debuglogs.html>`__.
More information about the libvir-list