docs: explain runtime logging controls

This commit is contained in:
Pauli Virtanen 2023-12-06 21:05:00 +02:00 committed by George Kiagiadakis
parent 43e190e3b4
commit 88c59ff9c6
1 changed files with 27 additions and 0 deletions

View File

@ -100,6 +100,33 @@ If a ``<topic pattern>`` is not specified, then the given ``<level>`` is
considered to be the global log level, which applies to all topics that have
no explicit level specified.
Changing log level at runtime
-----------------------------
The debug log level can be changed at runtime using ``wpctl``:
.. code::
wpctl set-log-level D # enable debug logging for Wireplumber
wpctl set-log-level - # restore default logging for Wireplumber
wpctl set-log-level 0 4 # enable debug logging for Pipewire daemon
wpctl set-log-level 0 - # restore default logging for Pipewire daemon
Equivalently, it is also possible to adjust the logging by setting
``log.level`` in the ``settings`` metadata:
.. code::
pw-metadata -n settings <ID> log.level "D" # WirePlumber logging
pw-metadata -n settings 0 log.level 4 # PipeWire daemon logging
Above, ``<ID>`` should be replaced by the WirePlumber daemon client ID.
Note that PipeWire daemon log levels must be specified by numbers, not
letter codes.
Examples
--------