From 697694e30dda1cef2cf34ca210821878c2d6f136 Mon Sep 17 00:00:00 2001 From: Otto Moerbeek Date: Mon, 26 Sep 2022 16:15:20 +0200 Subject: [PATCH] Make clear structured-logging-backend must be set on the command line --- pdns/recursordist/docs/settings.rst | 1 + pdns/recursordist/docs/upgrade.rst | 6 +++--- 2 files changed, 4 insertions(+), 3 deletions(-) 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 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -- 2.47.2