[PATCH 2/2] kbase: debuglogs: Add some more example filters settings

Show various usage of filters including some useful examples. Signed-off-by: Peter Krempa <pkrempa(a)redhat.com&gt; --- docs/kbase/debuglogs.rst | 39 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 39 insertions(+) diff --git a/docs/kbase/debuglogs.rst b/docs/kbase/debuglogs.rst index 523adfcacc..8991feb17c 100644 --- a/docs/kbase/debuglogs.rst +++ b/docs/kbase/debuglogs.rst @@ -153,3 +153,42 @@ Now you should go and reproduce the bug. Once you're finished, attach: - If you are asked for client logs, ``/tmp/libvirt_client.log``. - Ideally don't tear down the environment in case additionall information is required. + +Example filter settings +----------------------- + +Some filter setting suggestions for debugging more specific things. Unless it's +explicitly stated, these apply on libvirt 4.4.0 and later. Please note that some +of the filtrs below may not contain enough information for filing a libvirt bug. + +Targetted logging for debugging QEMU vms +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Specifying only sections some sections allows for a targetted filter +configuration which works on all versions and is sufficient for most cases. + +:: + + 1:libvirt 1:qemu 1:conf 1:security 3:event 3:json 3:file 3:object 1:util + +Less verbose logging for QEMU vms +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Some subsystems are very noisy and usually not the culprit of the problems. They +can be silenced individually for a less verbose log while still logging +everything else. Usual suspects are the JSON code, udev, authentication and such. +A permissive filter is good for development use cases. + +:: + + 3:remote 4:event 3:util.json 3:util.object 3:util.dbus 3:util.udev 3:node_device 3:rpc 3:access.accessmanager 3:util.netlink 1:* + + +Minimalistic QEMU QMP monitor logging +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +This filter logs only QMP traffic and skips most of libvirt's messages. + +:: + + 2:qemu.qemu_monitor 3:* -- 2.26.2