From: Dhairya Parmar <dparmar@redhat.com>
Date: Thu, 13 Apr 2023 10:12:29 +0000 (+0530)
Subject: doc/cephfs: document MDS_CLIENTS_LAGGY health warning
X-Git-Tag: v16.2.14~5^2~1
X-Git-Url: http://git-server-git.apps.pok.os.sepia.ceph.com/?a=commitdiff_plain;h=b37beeb09d2a7d69786795aafc0bbf40ca67b8fc;p=ceph.git

doc/cephfs: document MDS_CLIENTS_LAGGY health warning

Signed-off-by: Dhairya Parmar <dparmar@redhat.com>
(cherry picked from commit 7c8e7944147c0525b82c1cc71620078d3d35586e)
---

diff --git a/doc/cephfs/health-messages.rst b/doc/cephfs/health-messages.rst
index ee322c2c7adb..bb461be7b606 100644
--- a/doc/cephfs/health-messages.rst
+++ b/doc/cephfs/health-messages.rst
@@ -170,3 +170,15 @@ other daemons, please see :ref:`health-checks`.
     the actual cache size (in memory) is at least 50% greater than
     ``mds_cache_memory_limit`` (default 1GB). Modify ``mds_health_cache_threshold``
     to set the warning ratio.
+
+* ``MDS_CLIENTS_LAGGY``
+
+  Message
+    "Client *ID* is laggy; not evicted because some OSD(s) is/are laggy"
+
+  Description
+    If OSD(s) is laggy (due to certain conditions like network cut-off, etc)
+    then it might make clients laggy(session might get idle or cannot flush
+    dirty data for cap revokes). If ``defer_client_eviction_on_laggy_osds`` is
+    set to true (default true), client eviction will not take place and thus
+    this health warning will be generated.