From: Otto Moerbeek Date: Mon, 26 Sep 2022 14:15:20 +0000 (+0200) Subject: Make clear structured-logging-backend must be set on the command line X-Git-Tag: rec-4.9.0-alpha0~30^2 X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=refs%2Fpull%2F12020%2Fhead;p=thirdparty%2Fpdns.git Make clear structured-logging-backend must be set on the command line --- diff --git a/pdns/recursordist/docs/settings.rst b/pdns/recursordist/docs/settings.rst index 3c1819df58..61f8201c3a 100644 --- a/pdns/recursordist/docs/settings.rst +++ b/pdns/recursordist/docs/settings.rst @@ -2091,6 +2091,7 @@ Prefer structured logging when both an old style and a structured log messages i - Default: "default" The backend used for structured logging output. +This setting must be set on the command line (``--structured-logging-backend=...``) to be effective. Available backends are: - ``default``: use the traditional logging system to output structured logging information. diff --git a/pdns/recursordist/docs/upgrade.rst b/pdns/recursordist/docs/upgrade.rst index c5bbae5ff8..0efc39e93a 100644 --- a/pdns/recursordist/docs/upgrade.rst +++ b/pdns/recursordist/docs/upgrade.rst @@ -9,10 +9,10 @@ When upgrading several versions, please read **all** notes applying to the upgra Structured logging ^^^^^^^^^^^^^^^^^^ -All logging (execpt query tracing) has been converted to stuctured logging. +All logging (except query tracing) has been converted to stuctured logging. Switch to old style logging by setting the :ref:`setting-structured-logging` setting to ``no``. When using ``systemd``, structured logging information will be sent to ``journald`` using formatted text strings that list the key-value pairs and are human readable. -Switch to native key-value pair logging (more suitable for automated log processing) by setting :ref:`setting-structured-logging-backend` to ``systemd-journal``. +Switch to native key-value pair logging (more suitable for automated log processing) by setting :ref:`setting-structured-logging-backend` on the command line to ``systemd-journal``. New settings ^^^^^^^^^^^^ @@ -20,7 +20,7 @@ New settings - The :ref:`setting-serve-stale-extensions` setting to control the new ``Serve Stale`` feature has been introduced. - The :ref:`setting-record-cache-locked-ttl-perc` setting to control locking of record sets in the record cache has been introduced. - The :ref:`setting-edns-padding-out` setting to control EDNS padding for outgoing DoT has been introduced. -- The :ref:`setting-structured-logging-backend` setting to control the type of structiured logging to ``journald`` has been introduced. +- The :ref:`setting-structured-logging-backend` setting to control the type of structured logging to ``journald`` has been introduced. :program:`rec_control` changes ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^