DOCS-16048 documents balancerMigrationsThrottlingMs (#2995)

* DOCS-16048 documents balancerMigrationsThrottlingMs

* internal review

* external review

* external feedback

Author: jmd-mongo

source/reference/parameters.txt

@@ -2996,6 +2996,34 @@ Sharding Parameters
    ``AsyncRequestsSenderUseBaton`` and always enables the performance
    enhancement controlled by the parameter.
 
+.. parameter:: balancerMigrationsThrottlingMs
+ 
+   .. versionadded:: 7.0 (*Also available starting in 6.3.1, 6.0.6, 5.0.18*)
+
+   *Type*: integer
+
+   *Default*: 1000
+
+   |mongod-only|
+ 
+   Specifies the minimum amount of time between two consecutive 
+   balancing rounds. This allows you to throttle the balancing
+   rate. This parameter only takes effect on config server nodes.
+
+   This example sets ``balancerMigrationsThrottlingMs`` to 2000 
+   milliseconds at startup:
+
+   .. code-block:: bash
+
+      mongod --setParameter balancerMigrationsThrottlingMs=2000
+
+   During runtime, you can also set the parameter with the
+   :dbcommand:`setParameter` command:
+
+   .. code-block:: javascript
+
+      db.adminCommand( { setParameter: 1, balancerMigrationsThrottlingMs: 2000 } )
+
 .. parameter:: chunkDefragmentationThrottlingMS
 
    .. versionadded:: 5.3

source/release-notes/7.0.txt

@@ -32,3 +32,12 @@ Starting in MongoDB 7.0, if you have large :ref:`change stream
 <changeStreams>` events that exceed 16 MB, you can use the new
 :pipeline:`$changeStreamSplitLargeEvent` stage to split the events into
 smaller fragments.
+
+New Parameters
+~~~~~~~~~~~~~~
+
+``balancerMigrationsThrottlingMs`` Parameter
+````````````````````````````````````````````
+MongoDB 7.0 adds the :parameter:`balancerMigrationsThrottlingMs`
+parameter which allows you to throttle the balancing rate.
+