Skip to content

Commit 82b92c3

Browse files
committed
docs: add clock assumptions on restart.
Signed-off-by: Teryl Taylor <terylt@ibm.com>
1 parent 1660773 commit 82b92c3

1 file changed

Lines changed: 5 additions & 1 deletion

File tree

docs/content/docs/auditing.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -182,7 +182,11 @@ for the other's job:
182182
emission_seq)` is a total order across restarts. Detecting loss of the *tail*
183183
of a previous epoch (a crash between emit and persist) is not possible from
184184
the counters alone — that is what a durable sink (an append-only ledger) is
185-
for.
185+
for. **Assumption:** the host clock does not step backward across a restart
186+
(an NTP correction or VM snapshot restore). Because `epoch` is boot-time,
187+
a non-increasing value would make two boots share one chain scope; if you
188+
need strict monotonicity regardless of the clock, back it with a persisted
189+
counter or a ULID instead.
186190

187191
### Destinations
188192

0 commit comments

Comments
 (0)