DOCS-15437-reap-transactions (#2062) (#2103)

* DOCS-15437-reap-transactions

* DOCS-15437-reap-transactions

* DOCS-15437-reap-transactions

* DOCS-15437-reap-transactions

* DOCS-15437-reap-transactions

* DOCS-15437-reap-transactions

* DOCS-15437-reap-transactions

* DOCS-15437-reap-transactions

* DOCS-15437-reap-transactions

* DOCS-15437-reap-transactions

* DOCS-15437-reap-transactions

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

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

Author: jason-price-mongodb

source/reference/parameters.txt

@@ -4732,6 +4732,39 @@ Transaction Parameters
 
       db.adminCommand( { setParameter: 1, coordinateCommitReturnImmediatelyAfterPersistingDecision: true } )
 
+.. parameter:: internalSessionsReapThreshold
+
+   .. versionadded:: 6.0
+
+   |both|
+
+   *Default*: 1000
+
+   Session limit for internal session metadata deletion. The metadata:
+
+   - Contains session transaction information for user operations.
+   - Is stored in the :data:`config.transactions` collection.
+
+   When the number of internal sessions is greater than
+   :parameter:`internalSessionsReapThreshold`, the metadata is deleted.
+   
+   If you set :parameter:`internalSessionsReapThreshold` to ``0``, the
+   internal session metadata is only deleted when the user session ends.
+
+   The following example sets :parameter:`internalSessionsReapThreshold`
+   to ``500`` sessions:
+
+   .. code-block:: javascript
+
+      db.adminCommand( { setParameter: 1, internalSessionsReapThreshold: 500 } )
+
+   You can also set :parameter:`internalSessionsReapThreshold` at
+   startup. For example:
+
+   .. code-block:: bash
+
+      mongod --setParameter internalSessionsReapThreshold=500
+
 .. parameter:: transactionLifetimeLimitSeconds
 
    .. versionadded:: 4.0

source/release-notes/6.0.txt

@@ -265,6 +265,13 @@ minimum and maximum sharding TaskExecutor connection pool size for
 Starting in MongoDB 6.0, you can use :parameter:`changeStreamOptions` to control 
 the retention policy of change stream pre- and post-images.
 
+``internalSessionsReapThreshold`` Parameter
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Starting in MongoDB 6.0, you can use the new
+:parameter:`internalSessionsReapThreshold` parameter to set the session
+limit for internal session metadata deletion.
+
 Multiple Arbiters Unsupported
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~