Read Models

Read model configuration controls how many replay-generated read model versions Chronicle keeps when projections are replayed.

Example configuration

{
  "readModels": {
    "replayedVersionsToKeep": 1
  }
}

Property	Type	Default	Description
replayedVersionsToKeep	number	1	Number of replay-generated read model versions to keep per read model

Replay retention behavior

When a new replay starts, Chronicle applies retention before creating the next replay context:

• Keeps the latest replayedVersionsToKeep replay versions for each read model.
• Removes older replay versions.
• Deletes the associated sink container for each removed version (for example, a MongoDB collection or SQL table).

Set replayedVersionsToKeep to:

• 0 to remove all previous replay versions on each new replay.
• 1 (default) to keep only the most recent replay version.
• A higher number if you need additional replay history for diagnostics or rollback workflows.