Skip to main content

Crate orbit_event

Crate orbit_event 

Source
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§

OrbitEvent
One decoded event from the shared event ring.
OrbitEventBus
Fleet-shared raw event bus. Cheap to clone.
OrbitEventCursor
Cursor for one event subscriber.
OrbitEventPoll
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.

Type Aliases§

Result