From: Zac Dover <zac.dover@proton.me>
Date: Wed, 14 Aug 2024 18:08:14 +0000 (+1000)
Subject: doc/glossary: add "flapping OSD"
X-Git-Tag: v19.2.1~40^2
X-Git-Url: http://git.apps.os.sepia.ceph.com/?a=commitdiff_plain;h=ef1dfd9fbcdca7d2f980be6f1eb5b4bcb2a58032;p=ceph.git

doc/glossary: add "flapping OSD"

Add an entry for "Flapping OSD" to the glossary.

Signed-off-by: Zac Dover <zac.dover@proton.me>
(cherry picked from commit 1ca89e6ca3d9e0042702b7ac3af9a3e596330c1d)
---

diff --git a/doc/glossary.rst b/doc/glossary.rst
index d1b47a0059ab1..8e8a6d9852240 100644
--- a/doc/glossary.rst
+++ b/doc/glossary.rst
@@ -261,6 +261,10 @@
                 Another name for :term:`Dashboard`.
 
 	Dashboard Plugin
+        Flapping OSD
+                An OSD that is repeatedly marked ``up`` and then ``down`` in
+                rapid succession. See :ref:`rados_tshooting_flapping_osd`.
+
         FQDN
                 **F**\ully **Q**\ualified **D**\omain **N**\ame. A domain name
                 that is applied to a node in a network and that specifies the
@@ -361,6 +365,9 @@
                 mid-2010s to insist that "OSD" should refer to "Object Storage
                 Device", so it is important to know which meaning is intended. 
 
+        OSD, flapping
+                See :term:`Flapping OSD`.
+
 	OSD FSID 
                 The OSD fsid is a unique identifier that is used to identify an
                 OSD. It is found in the OSD path in a file called ``osd_fsid``.
diff --git a/doc/rados/troubleshooting/troubleshooting-osd.rst b/doc/rados/troubleshooting/troubleshooting-osd.rst
index 3150e8382ad9d..d237226ea92cd 100644
--- a/doc/rados/troubleshooting/troubleshooting-osd.rst
+++ b/doc/rados/troubleshooting/troubleshooting-osd.rst
@@ -680,6 +680,7 @@ Although some of these events may appear redundant, they cross important
 boundaries in the internal code (such as passing data across locks into new
 threads).
 
+.. _rados_tshooting_flapping_osd:
 
 Flapping OSDs
 =============