From: Nathan Cutler <ncutler@suse.com>
Date: Fri, 28 Feb 2020 17:16:17 +0000 (+0100)
Subject: doc/cephadm/administration: clarify log gathering
X-Git-Tag: v15.1.1~190^2
X-Git-Url: http://git-server-git.apps.pok.os.sepia.ceph.com/?a=commitdiff_plain;h=refs%2Fpull%2F33627%2Fhead;p=ceph.git

doc/cephadm/administration: clarify log gathering

This is an attempt to bring the current state of the documentation more
into line with the current state of the cephadm code.

However, when I try to grab logs from a daemon on a host other than the
one where the daemon is running, I get an empty log...

References: https://tracker.ceph.com/issues/44354
Signed-off-by: Nathan Cutler <ncutler@suse.com>
---

diff --git a/doc/cephadm/administration.rst b/doc/cephadm/administration.rst
index 30340d0fbb6e..855f2df94026 100644
--- a/doc/cephadm/administration.rst
+++ b/doc/cephadm/administration.rst
@@ -202,10 +202,17 @@ To read the log file of one specific daemon, run::
 
     cephadm logs --name <name-of-daemon>
 
+Note: this only works when run on the same host where the daemon is running. To
+get logs of a daemon running on a different host, give the ``--fsid`` option::
+
+    cephadm logs --fsid <fsid> --name <name-of-daemon>
+
+Where the ``<fsid>`` corresponds to the cluster id printed by ``ceph status``.
+
 To fetch all log files of all daemons on a given host, run::
 
     for name in $(cephadm ls | jq -r '.[].name') ; do
-      cephadm logs --name "$name" > $name;
+      cephadm logs --fsid <fsid> --name "$name" > $name;
     done
 
 Collecting systemd status