From bdb2241ca5a9758e8c52d47320d8b5ea0766aea9 Mon Sep 17 00:00:00 2001 From: Varsha Rao Date: Tue, 3 Aug 2021 17:21:45 +0530 Subject: [PATCH] doc/cephadm: update about disabling logging to journald for quincy Signed-off-by: Varsha Rao --- doc/cephadm/operations.rst | 35 ++++++++++++++++++++--------------- 1 file changed, 20 insertions(+), 15 deletions(-) diff --git a/doc/cephadm/operations.rst b/doc/cephadm/operations.rst index 621aa2a70a117..87e11952506c6 100644 --- a/doc/cephadm/operations.rst +++ b/doc/cephadm/operations.rst @@ -41,17 +41,17 @@ monitor hosts as well as to the monitor daemons' stderr. Ceph daemon logs ================ -Logging to stdout ------------------ +Logging to journald +------------------- -Ceph daemons traditionally write logs to ``/var/log/ceph``. Ceph -daemons log to stderr by default and Ceph logs are captured by the -container runtime environment. By default, most systems send these -logs to journald, which means that they are accessible via -``journalctl``. +Ceph daemons traditionally write logs to ``/var/log/ceph``. Ceph daemons log to +journald by default and Ceph logs are captured by the container runtime +environment. They are accessible via ``journalctl``. -Example of logging to stdout -~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.. note:: Prior to Quincy, ceph daemons logged to stderr. + +Example of logging to journald +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ For example, to view the logs for the daemon ``mon.foo`` for a cluster with ID ``5c5a50ae-272a-455d-99e9-32c6a013e694``, the command would be @@ -67,11 +67,11 @@ Logging to files ---------------- You can also configure Ceph daemons to log to files instead of to -stderr if you prefer logs to appear in files (as they did in earlier, +journald if you prefer logs to appear in files (as they did in earlier, pre-cephadm, pre-Octopus versions of Ceph). When Ceph logs to files, the logs appear in ``/var/log/ceph/``. If you choose to -configure Ceph to log to files instead of to stderr, remember to -configure Ceph so that it will not log to stderr (the commands for +configure Ceph to log to files instead of to journald, remember to +configure Ceph so that it will not log to journald (the commands for this are covered below). Enabling logging to files @@ -84,10 +84,10 @@ To enable logging to files, run the following commands: ceph config set global log_to_file true ceph config set global mon_cluster_log_to_file true -Disabling logging to stderr -~~~~~~~~~~~~~~~~~~~~~~~~~~~ +Disabling logging to journald +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -If you choose to log to files, we recommend disabling logging to stderr or else +If you choose to log to files, we recommend disabling logging to journald or else everything will be logged twice. Run the following commands to disable logging to stderr: @@ -95,6 +95,11 @@ to stderr: ceph config set global log_to_stderr false ceph config set global mon_cluster_log_to_stderr false + ceph config set global log_to_journald false + ceph config set global mon_cluster_log_to_journald false + +.. note:: You can change the default by passing --log-to-file during + bootstrapping a new cluster. Modifying the log retention schedule ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -- 2.39.5