DOCS-15039 throttling parameter (#367) (#375)

* DOCS-15039 throttling parameter

* DOCS-15039 throttling parameter

* DOCS-15039 throttling parameter

* DOCS-15039 throttling parameter

Co-authored-by: jason-price-mongodb <[email protected]>

Co-authored-by: jason-price-mongodb <[email protected]>

Author: jason-price-mongodb

source/reference/parameters.txt

@@ -2814,6 +2814,36 @@ Sharding Parameters
    ``AsyncRequestsSenderUseBaton`` and always enables the performance
    enhancement controlled by the parameter.
 
+.. parameter:: chunkDefragmentationThrottlingMS
+
+   .. versionadded:: 5.3
+
+   *Type*: integer
+
+   *Default*: 0
+
+   |both|
+
+   Specifies the minimum time period (in milliseconds) between
+   consecutive split and merge commands run by the :term:`balancer` when
+   the :term:`chunks <chunk>` in a :term:`sharded <sharding>` collection
+   are defragmented. :parameter:`chunkDefragmentationThrottlingMS`
+   limits the rate of split and merge commands.
+
+   The following example sets
+   :parameter:`chunkDefragmentationThrottlingMS` to ``10`` milliseconds:
+
+   .. code-block:: bash
+
+      mongod --setParameter chunkDefragmentationThrottlingMS=10
+
+   During runtime, you can also set the parameter with the
+   :dbcommand:`setParameter` command:
+
+   .. code-block:: javascript
+
+      db.adminCommand( { setParameter: 1, chunkDefragmentationThrottlingMS: 10 } )
+
 .. parameter:: disableResumableRangeDeleter
 
    .. versionadded:: 4.4

source/release-notes/5.3.txt

@@ -38,6 +38,17 @@ Management Interoperability Protocol (KMIP) server to securely manage
 the keys for :ref:`encrypting the MongoDB audit log
 <security-encryption-at-rest-audit-log>`.
 
+.. _5.3-rel-notes-sharding:
+
+Sharding
+--------
+
+Starting in MongoDB 5.3, you can use the new
+:parameter:`chunkDefragmentationThrottlingMS` parameter to limit the
+rate of split and merge commands run by the :term:`balancer` when the
+:term:`chunks <chunk>` in a :term:`sharded <sharding>` collection are
+defragmented.
+
 Report an Issue
 ---------------