Skip to content

Commit ddd8ca9

Browse files
Docsp 34942 7.0 backport (#5795)
* 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 eed4c65 commit ddd8ca9

File tree

1 file changed

+30
-0
lines changed

1 file changed

+30
-0
lines changed

Diff for: source/reference/parameters.txt

+30
Original file line numberDiff line numberDiff line change
@@ -1804,6 +1804,30 @@ General Parameters
18041804
.. seealso: :ref:`storage-node-watchdog`
18051805

18061806

1807+
.. parameter:: tcmallocAggressiveMemoryDecommit
1808+
1809+
*Type*: integer (``0`` or ``1`` only)
1810+
1811+
Default: 1
1812+
1813+
If you enable ``tmallocAggressiveMemoryDecommit``, MongoDB:
1814+
1815+
- releases a :term:`chunk <chunk>` of memory to system, and
1816+
1817+
- attempts to return all neighboring free chunks.
1818+
1819+
A value of ``1`` enables ``tcmallocAggressiveMemoryDecommit``;
1820+
``0`` disables this parameter.
1821+
1822+
If you enable this parameter, the system will require new memory allocations
1823+
for use. Consider enabling ``tcmallocAggressiveMemoryDecommit``
1824+
only on memory-constrained systems and after pursuing other memory and
1825+
performance options.
1826+
1827+
Despite the potential performance degradation when using
1828+
``tcmallocAggressiveMemoryDecommit``, it is often preferred over using
1829+
:parameter:`tcmallocReleaseRate`.
1830+
18071831
.. parameter:: tcmallocReleaseRate
18081832

18091833
.. versionadded:: 4.2.3
@@ -1820,6 +1844,12 @@ General Parameters
18201844
return memory faster; decrease it to return memory slower.
18211845
Reasonable rates are in the range [0,10]."
18221846

1847+
.. note::
1848+
1849+
Consider using :parameter:`tcmallocAggressiveMemoryDecommit` instead of
1850+
:parameter:`tcmallocReleaseRate`, unless you see a significant performance
1851+
degradation when using ``tcmallocAggressiveMemoryDecommit``.
1852+
18231853
To modify the release rate during run time, you can use the
18241854
:dbcommand:`setParameter` command; for example:
18251855

0 commit comments

Comments
 (0)