Skip to main content

Crate orbit_events

Crate orbit_events 

Source
Expand description

FleetEventBus — 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§

DefaultEventLayout
The fleet’s default event ring: kind 220, geometry from ORBIT_EVENT_RING_CAPACITY and ORBIT_EVENT_RING_PAYLOAD_CAPACITY.
FleetEvent
One decoded event from the shared event ring.
FleetEventBus
Fleet-shared raw event bus over the ring named by L. Cheap to clone.
FleetEventCursor
Cursor for one event subscriber.
FleetEventPoll
Result of polling an event cursor.

Enums§

Error
Failures produced by the Orbit event semantic layer.

Constants§

EVENT_PAYLOAD_MAX
EVENT_RING_CAPACITY
Event frame payload limit for the default ring. 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.
EVENT_RING_KIND
EVENT_RING_PAYLOAD_CAPACITY
EVENT_RING_SPEC

Traits§

EventLayout
The Orbit ring one event bus publishes into and polls from.

Type Aliases§

Result