Skip to content

Commit b90cde9

Browse files
Docsp 34942 6.0 backport (#5796)
* Add tcmallocAggressiveMemoryDecommit (#5650) * add tcmallocAggressiveMemoryDecommit * wordsmithing * external review suggestions and clarifications * writing review * Update source/reference/parameters.txt Co-authored-by: Alison Huh <112565127+ajhuh-mdb@users.noreply.github.com> * Update source/reference/parameters.txt Co-authored-by: Alison Huh <112565127+ajhuh-mdb@users.noreply.github.com> * fix formatting * final? review * Update source/reference/parameters.txt Co-authored-by: Alison Huh <112565127+ajhuh-mdb@users.noreply.github.com> * final changes, I hope... * fix formatting --------- Co-authored-by: Alison Huh <112565127+ajhuh-mdb@users.noreply.github.com> * fix single-hash issue (#5789) --------- Co-authored-by: Alison Huh <112565127+ajhuh-mdb@users.noreply.github.com>
1 parent ff6a71a commit b90cde9

File tree

1 file changed

+31
-1
lines changed

1 file changed

+31
-1
lines changed

source/reference/parameters.txt

Lines changed: 31 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1719,6 +1719,30 @@ General Parameters
17191719
.. seealso: :ref:`storage-node-watchdog`
17201720

17211721

1722+
.. parameter:: tcmallocAggressiveMemoryDecommit
1723+
1724+
*Type*: integer (``0`` or ``1`` only)
1725+
1726+
Default: 1
1727+
1728+
If you enable ``tmallocAggressiveMemoryDecommit``, MongoDB:
1729+
1730+
- releases a :term:`chunk <chunk>` of memory to system, and
1731+
1732+
- attempts to return all neighboring free chunks.
1733+
1734+
A value of ``1`` enables ``tcmallocAggressiveMemoryDecommit``;
1735+
``0`` disables this parameter.
1736+
1737+
If you enable this parameter, the system will require new memory allocations
1738+
for use. Consider enabling ``tcmallocAggressiveMemoryDecommit``
1739+
only on memory-constrained systems and after pursuing other memory and
1740+
performance options.
1741+
1742+
Despite the potential performance degradation when using
1743+
``tcmallocAggressiveMemoryDecommit``, it is often preferred over using
1744+
:parameter:`tcmallocReleaseRate`.
1745+
17221746
.. parameter:: tcmallocReleaseRate
17231747

17241748
.. versionadded:: 4.2.3
@@ -1735,7 +1759,13 @@ General Parameters
17351759
return memory faster; decrease it to return memory slower.
17361760
Reasonable rates are in the range [0,10]."
17371761

1738-
To modify the release rate during runtime, you can use the
1762+
.. note::
1763+
1764+
Consider using :parameter:`tcmallocAggressiveMemoryDecommit` instead of
1765+
:parameter:`tcmallocReleaseRate`, unless you see a significant performance
1766+
degradation when using ``tcmallocAggressiveMemoryDecommit``.
1767+
1768+
To modify the release rate during run time, you can use the
17391769
:dbcommand:`setParameter` command; for example:
17401770

17411771
.. code-block:: javascript

0 commit comments

Comments
 (0)