@@ -50,6 +50,7 @@ Example Configuration:
5050 regex: "^manual_.*"
51515252.. DANGER::
53+5354 You might have **existing snapshots** of filesystems affected by pruning which you want to keep, i.e. not be destroyed by zrepl.
5455 Make sure to actually add the necessary ``regex`` keep rules on both sides, like with ``manual`` in the example above.
5556@@ -71,6 +72,14 @@ It only makes sense to specify this rule for the ``keep_sender``.
7172The reason is that, by definition, all snapshots on the receiver have already been replicated to there from the sender.
7273To determine whether a sender-side snapshot has already been replicated, zrepl uses the :ref:`replication cursor bookmark <replication-cursor-and-last-received-hold>` which corresponds to the most recent successfully replicated snapshot.
737475+.. ATTENTION::
76+77+ If you use ``not_replicated`` in your pruning rules, make sure to :ref:`monitor <monitoring>` replication.
78+ If your replication gets stuck then ``not_replicated`` causes snapshots to pile uip on the sender.
79+ ZFS and especially the ``zfs`` management command are known to degrade in performance with a lot of snapshots.
80+ Such degradation impacts zrepl, any other scripts, and human ability to manage your zpool.
81+82+7483.. _prune-keep-retention-grid:
75847685Policy ``grid``