Skip to content

Commit 5ee0bbf

Browse files
committed
doc/health-checks: update MON_NETSPLIT documentation
Update the MON_NETSPLIT health check documentation to reflect the introduction of the configurable mon_netsplit_grace_period option. Fixes: https://tracker.ceph.com/issues/71344 Signed-off-by: Kamoltat Sirivadhna <[email protected]>
1 parent abfa5a3 commit 5ee0bbf

File tree

1 file changed

+18
-0
lines changed

1 file changed

+18
-0
lines changed

doc/rados/operations/health-checks.rst

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -167,6 +167,12 @@ which are frequently updated. This warning only appears when
167167
the cluster is provisioned with at least three Ceph Monitors and are using the
168168
``connectivity`` election strategy.
169169

170+
To reduce false alarms from transient network issues, detected netsplits are
171+
not immediately reported as health warnings. Instead, they must persist for at
172+
least ``mon_netsplit_grace_period`` seconds (default: 9 seconds) before being
173+
reported. If the network partition resolves within this grace period, no health
174+
warning is emitted.
175+
170176
Network partitions are reported in two ways:
171177

172178
- As location-level netsplits (e.g., "Netsplit detected between dc1 and dc2") when
@@ -177,6 +183,18 @@ Network partitions are reported in two ways:
177183
The system prioritizes reporting at the highest topology level (``datacenter``, ``rack``, etc.)
178184
when possible, to better help operators identify infrastructure-level network issues.
179185

186+
To adjust the grace period threshold, run the following command:
187+
188+
.. prompt:: bash $
189+
190+
ceph config set mon mon_netsplit_grace_period <seconds>
191+
192+
To disable the grace period entirely (immediate reporting), set the value to 0:
193+
194+
.. prompt:: bash $
195+
196+
ceph config set mon mon_netsplit_grace_period 0
197+
180198
AUTH_INSECURE_GLOBAL_ID_RECLAIM
181199
_______________________________
182200

0 commit comments

Comments
 (0)