Skip to main content

Event Retention

EnSync stores events for up to 30 days (depending on your plan), allowing you to replay them for debugging, reconciliation, or recovering from missed events.
PlanRetention Period
Free1 day
Startup7 days
Scaleup14 days
Enterprise (Cloud)30 days
Enterprise (Self-Hosted)Configurable

Replay Metadata

Replayed events include replay_info in metadata:
{
  eventName: "order/created",
  idem: "event-idem-123",
  payload: { /* your data */ },
  metadata: {
    $internal: {
      replay_info: {
        isReplayed: true,
        replayTimestamp: 1758410511179,
        wasAcknowledged: false
      }
    }
  }
}

Replay Info Fields

FieldTypeDescription
isReplayedbooleantrue if this is a replayed event
replayTimestampnumberWhen the replay was triggered
wasAcknowledgedbooleanWhether event was previously acknowledged

Use Cases

  • Debugging: Replay events to reproduce issues
  • Data reconciliation: Reprocess events after fixing bugs
  • Missed events: Recover events if your system was down
  • Testing: Replay production events in staging
Check isReplayed flag to handle replayed events differently (e.g., skip duplicate processing).