Skip to content
04 Provenance and Audit Trails

Nine terms that are not synonyms

Most arguments about audit systems are vocabulary collisions. Fixing the words fixes half the disagreement.

Lesson 01 of 06 · 8 min
TermWhat it actually is
Event logAn ordered sequence of facts, written once, only growing. A storage and consistency mechanism.
Audit trailA rendering, for a human, of who did what, when, under what authority, and why. A product surface.
ProvenanceThe record of entities, activities and agents involved in producing a particular thing. Value-level.
LineageThe structural dependency graph between artifacts. Schema-level. Holds for every row of a run, so explains none of them.
ImmutableA property of a record: its bytes never change. Says nothing about deletion.
Append-onlyA property of a collection: it only grows. Says nothing about member immutability.
Tamper-evidentModification is detectable after the fact by someone doing verification work.
BitemporalTwo independent time axes: valid time (true in the world) and transaction time (recorded in the database).
Decision timeThe knowledge cutoff a particular actor used when they acted. The axis nobody has a column for.
Predict

You have an "immutable audit log" in a Postgres table. Which property do you actually have?

The rest of this lesson unlocks when you commit above.