events

nixfleet_control_plane::server::routes::rollouts

Function events 

Source 
pub(in server) async fn events(
    __arg0: State<Arc<AppState>>,
    __arg1: Path<String>,
    __arg2: Query<EventsQuery>,
) -> Result<Json<RolloutEvents>, StatusCode>
Expand description

GET /v1/rollouts/{rolloutId}/events — chronological event-log stream for a rollout (RFC-0005 §10.5 + Plan 04 §“Event log schema”).

Returns every event_log row whose rollout_id matches, sorted by seq ascending. Engineer-facing surface: feed the rows through nixfleet_state_machine::step to reproduce per-host state evolution; or query for specific kinds (agent_event, effect, gate_decision, etc.) to debug a specific layer.

?limit=N caps the number of entries (default 1000 — sized for ~5–8 events per host × ~125 hosts; raise for very large rollouts).