Skip to content

Commit ba3123d

Browse files
(DOCSP-20183): Updates to snapshot history (#223)
* (DOCSP-20183): Updates to snapshot history * Updates per copy review
1 parent 9e2304e commit ba3123d

File tree

2 files changed

+25
-8
lines changed

2 files changed

+25
-8
lines changed

source/core/wiredtiger.txt

Lines changed: 18 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -57,10 +57,6 @@ metadata table is atomically updated to reference the new checkpoint.
5757
Once the new checkpoint is accessible, WiredTiger frees pages from the
5858
old checkpoints.
5959

60-
Starting in MongoDB 5.0, you can use the
61-
:parameter:`minSnapshotHistoryWindowInSeconds` parameter to control how
62-
long WiredTiger keeps the snapshot history.
63-
6460
Using WiredTiger, even without :ref:`journaling
6561
<storage-wiredtiger-journal>`, MongoDB can recover from the last
6662
checkpoint; however, to recover changes made after the last checkpoint,
@@ -70,6 +66,24 @@ run with :ref:`journaling <storage-wiredtiger-journal>`.
7066

7167
.. include:: /includes/wiredtiger-node-nojournal.rst
7268

69+
.. _storage-snapshot-history:
70+
71+
Snapshot History Retention
72+
~~~~~~~~~~~~~~~~~~~~~~~~~~
73+
74+
Starting in MongoDB 5.0, you can use the
75+
:parameter:`minSnapshotHistoryWindowInSeconds` parameter to specify how
76+
long WiredTiger keeps the snapshot history.
77+
78+
Increasing the value of :parameter:`minSnapshotHistoryWindowInSeconds`
79+
increases disk usage, because the server must maintain the history of
80+
older modified values within the specified time window. The amount of
81+
disk space used depends on your workload, with higher volume workloads
82+
requiring more disk space.
83+
84+
MongoDB maintains the snapshot history in the ``WiredTigerHS.wt`` file,
85+
located in your specified :setting:`~storage.dbPath`.
86+
7387
.. _storage-wiredtiger-journal:
7488

7589
Journal

source/reference/parameters.txt

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -3765,12 +3765,15 @@ Storage Parameters
37653765
.. code-block:: javascript
37663766

37673767
db.adminCommand( { setParameter: 1, minSnapshotHistoryWindowInSeconds: 600 } )
3768+
3769+
.. note::
37683770

3769-
.. seealso::
3771+
Increasing the value of
3772+
:parameter:`minSnapshotHistoryWindowInSeconds` increases disk
3773+
usage. For more information, see :ref:`storage-snapshot-history`.
37703774

3771-
- Read concern :readconcern:`"snapshot"`
3772-
- :ref:`Snapshots and Checkpoints
3773-
<storage-wiredtiger-checkpoints>`
3775+
To modify this value for a :atlas:`MongoDB Atlas </>` cluster, you
3776+
must contact :atlas:`Atlas Support </support>`.
37743777

37753778
.. parameter:: processUmask
37763779

0 commit comments

Comments
 (0)