diff --git a/docs/reference/configuration/properties.md b/docs/reference/configuration/properties.md index 02b8d3d..538205a 100644 --- a/docs/reference/configuration/properties.md +++ b/docs/reference/configuration/properties.md @@ -779,7 +779,7 @@ Defines the duration in milliseconds for which leadership leases are acquired. **`dt.dex-engine.maintenance.run-deletion-batch-size`** [¶](#dtdex-enginemaintenancerun-deletion-batch-size){ .headerlink } -Defines the maximum number of completed workflow runs to delete during a single execution of the maintenance worker. Deletion of large volumes of runs in one pass can lead to I/O spikes and increased table bloat.

If retention is not able to keep up with the volumes of runs, consider increasing the interval of the maintenance worker first. +Defines the maximum number of completed workflow runs to delete in a single batch. Deletion of large volumes of runs in one pass can lead to I/O spikes and increased table bloat.

Each maintenance cycle executes up to [`dt.dex-engine.maintenance.run-deletion-max-batches-per-cycle`](#dtdex-enginemaintenancerun-deletion-max-batches-per-cycle) batches.

If retention is not able to keep up with the volumes of runs, consider increasing the interval of the maintenance worker, or the number of batches per cycle first. @@ -787,6 +787,16 @@ Defines the maximum number of completed workflow runs to delete during a single
Typeinteger
ENVDT_DEX_ENGINE_MAINTENANCE_RUN_DELETION_BATCH_SIZE
+**`dt.dex-engine.maintenance.run-deletion-max-batches-per-cycle`** [¶](#dtdex-enginemaintenancerun-deletion-max-batches-per-cycle){ .headerlink } + +Defines the maximum number of deletion batches the maintenance worker executes per cycle.

Bounds the WAL burst when draining a large backlog. A backlog exceeding [`dt.dex-engine.maintenance.run-deletion-batch-size`](#dtdex-enginemaintenancerun-deletion-batch-size) * [`dt.dex-engine.maintenance.run-deletion-max-batches-per-cycle`](#dtdex-enginemaintenancerun-deletion-max-batches-per-cycle) is drained across multiple cycles. + + + + + +
Typeinteger
Default100
ENVDT_DEX_ENGINE_MAINTENANCE_RUN_DELETION_MAX_BATCHES_PER_CYCLE
+ **`dt.dex-engine.maintenance.run-retention-ms`** [¶](#dtdex-enginemaintenancerun-retention-ms){ .headerlink } Defines the duration in milliseconds after which completed workflow runs become eligible for deletion.