Expand description
OrbitEventBus — append-only event stream over one Orbit ring.
Events are not cache entries and not metrics snapshots. Cache reads ask “what is the newest value for this key?” Metrics reads ask “what is the newest sample for each node?” Event reads ask “which frames have appeared since my cursor?”
One event SHM segment carries all topics, with one writer lane per fleet node. The topic is carried inside the frame payload, so adding a new event type does not allocate another SHM segment. Subscribers keep one cursor per node lane and do not assume a total order across nodes.
Structs§
- Orbit
Event - One decoded event from the shared event ring.
- Orbit
Event Bus - Fleet-shared raw event bus. Cheap to clone.
- Orbit
Event Cursor - Cursor for one event subscriber.
- Orbit
Event Poll - Result of polling an event cursor.
Enums§
- Error
- Failures produced by the Orbit event semantic layer.
Constants§
- EVENT_
PAYLOAD_ MAX - EVENT_
RING_ KIND - EVENT_
RING_ SPEC - Event frame payload limit for V0. This is the event lane’s own SHM payload capacity; non-Unix keeps the same contract so callers do not accidentally rely on unbounded in-memory frames.