Skip to content

Commit 2a9a202

Browse files
TimLFletcherggray-cb
authored andcommitted
DOC-13223: Added guardrails details to server docs (#3808)
* DOC-13223: Added guardrails details to server docs * Update sizing-general.adoc
1 parent 9e49dd5 commit 2a9a202

File tree

1 file changed

+34
-0
lines changed

1 file changed

+34
-0
lines changed

modules/install/pages/sizing-general.adoc

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -108,6 +108,40 @@ A reliable high-speed network for intra-cluster and inter-cluster communications
108108
+
109109
Most deployments can achieve optimal performance with 1 Gbps interconnects, but some may need 10 Gbps.
110110

111+
112+
[#guardrails]
113+
==== Couchbase Server Guardrails
114+
115+
For safe and reliable cluster operations, and to minimize the severity of cluster outages, clusters using Couchbase Server 7.6 or later have guardrails in place.
116+
These guardrails proactively monitor for specific system thresholds.
117+
When a cluster meets these thresholds, these guardrails automatically prevent the following cluster operations, which during these conditions can put the cluster at severe risk of outage and downtime:
118+
119+
* Bucket writes
120+
* Bucket creation
121+
* Collection creation
122+
* Topology changes that involve rebalancing
123+
124+
Server-level enforcement thresholds are designed to ensure the optimal and reliable usage of available system resources by various workloads.
125+
These thresholds are as follows:
126+
127+
[Attributes]
128+
|===
129+
|Cluster Metric |Threshold
130+
131+
|Data Service Resident Ratio (Couchstore)
132+
|\<= 1%
133+
134+
|Data Service Resident Ratio (Magma)
135+
|\<= 0.1%
136+
137+
|Free Disk Space
138+
|\<= 4%
139+
140+
|Number of Buckets
141+
|\<= 0.2 cores per bucket
142+
143+
|===
144+
111145
== Sizing Data Service Nodes
112146

113147
Data Service nodes handle data service operations, such as create/read/update/delete (CRUD).

0 commit comments

Comments
 (0)