REFERENCE
Exception event stream fields
π TL;DR / Quick Summary <div style="background: rgba(0,0,0,0.3); border: 1px dashed rgba(255,255,255,0.2); padding: 15px; border-radius: 8px; color: rgba(255,255,255,0.7); margin-bottom: 30px;"> The fields of the exception event stream as rebuilt after launch night. Fictional product. Written the day after auto-triage came back, from the timeline in π Write up the launch incident with Priya, while I still knew why each field exists. </div>
π οΈ Instructions / Core Material
event_id: one per message. Unique, and now actually checked.exception_id: the exception this event belongs to. Many events, one exception.shipment_id: what it is about.type_code: one of the 23 codes.occurred_at: when it happened in the world.received_at: when we heard. The gap between 5 and 6 is the delay nobody owns.source: carrier feed, scan, manual entry or a rule.dedupe_key: shipment, code and the hour it occurred. New. Two events with the same key are one exception. This field is the whole of the fix.status: open, acknowledged, resolved, closed untouched.triaged_by: a rule or a person.rule_id: which rule, if it was a rule. Empty between 12 and 20 March.dispatcher_id: whose list it is on.
Used by everything in π Exceptions Inbox general availability from 20 March on.
β οΈ Key Warnings / Constraints
- Before 12 March there is no
dedupe_key. Do not count exceptions across that date without saying so. occurred_atis in the carrier's local time on two feeds. Mikkel SΓΈrensen has the list of which.- Closed untouched is a status, not a failure. Some exceptions resolve themselves, and that is information too.
π Related Entities & Resources
- π Write up the launch incident with Priya: the timeline these fields were written from
- π Exceptions Inbox general availability: the launch that reads this stream
- Halden Flow exception codes: what the values of the type field mean
- Incident and rollback playbook: what to do when the stream misbehaves again