JournalWriteFailure

data class JournalWriteFailure(val runId: RunId, val seq: Long, val phase: EntryPhase, val cause: Throwable, val timestamp: Long = System.currentTimeMillis()) : SagaEvent

Emitted when a journal append fails after the saga step's side effect has already fired.

This is a critical observability event for the EntryPhase.Effect phase: the step ran successfully but the journal write failed. The saga continues forward (or compensates based on other failures); reconciliation of the missing journal entry is the user's responsibility.

Also emitted for EntryPhase.Compensation write failures (best-effort rule).

NOT emitted for EntryPhase.Intent failures — Intent failures veto the step before it runs, so there is no side-effect to surface.

Constructors

Link copied to clipboard
constructor(runId: RunId, seq: Long, phase: EntryPhase, cause: Throwable, timestamp: Long = System.currentTimeMillis())

Properties

Link copied to clipboard

The underlying storage error.

Link copied to clipboard

The entry phase that failed (EntryPhase.Effect or EntryPhase.Compensation).

Link copied to clipboard

The run identifier for which the write failed.

Link copied to clipboard
val seq: Long

The sequence number that was attempted.

Link copied to clipboard
open override val timestamp: Long

Timestamp when the event occurred (milliseconds since epoch).