Overview snapshot

Included from Basic tier

The aggregated fleet snapshot behind GET /api/admin/overview (admin token): one read replacing the Overview screen's fan-out over runners + groups + N×demand + queue + agents + posture + licence + maintenance. Every number is computed from the same sources the individual endpoints serve, in one pass per source.

The v2 OpenAPI document declares this resource's schema; the resource-field coverage gate holds this page to it.

Top-level fields

Field	Type	Meaning
server	object	The replica's own status — exactly the GET /api/admin/status payload (shared builder); see the admin_status resource page. Per-replica facts (started_at, quiesce) describe the replica answering this request.
groups	array	One row per runner group — stored rows plus any group name runners carry without a stored row, so no member is invisible. Always present ([] when none). Fields below.
agents	object	Agent-plane counts: online (not stopped, polled within the 3-minute liveness window), total (registered, unrevoked), halted (per-member emergency halt in force).
queue	object	total (every queue entry, leased included) and unsatisfiable (unleased entries blocked by a runner-plane halt, licence work-stop or this replica's quiesce, or failing the placement verdict). As coded, this count does not consult the system-quiesce posture — the per-entry fleet-queue view does.
posture	object	{"runners": ..., "agents": ...} — each plane's active emergency posture, or null when the plane is normal. Posture fields below.
licence_state	string	The resolved licence lifecycle state: valid, in_grace or expired (see the licence_status resource page). Empty string when no entitlement service is wired or resolution failed.
maintenance_active	int	Count of currently active maintenance windows (at most one per quiesced node). 0 when the server runs without a PostgreSQL pool or the read failed.

groups entries

Field	Type	Meaning
name	string	The group name.
description	string	From the stored row. Absent when empty or no row exists.
exclusive	bool	The stored row's exclusive flag. Absent when false.
attributes	string map	The stored row's placement attributes. Absent when empty.
bindings	string array	The stored row's node-path bindings. Absent when empty.
drain_requested_at	timestamp	A group-wide drain is in force. Absent when not draining.
members_online	int	Member runners not stopped and polled within the 3-minute liveness window.
members_total	int	Registered member runners.
queued	int	Unleased queue entries this group's placement posture could take (same rule as the per-group demand endpoint).
running	int	Live job bindings held by the group's members.

Posture fields (posture.runners / posture.agents)

The active EmergencyPosture row, or null:

Field	Type	Meaning
id	string	The posture's identity, quoted in dispatch verdicts.
plane	string	runners or agents.
in_flight	string	The halt's declared treatment of in-flight work. Absent when empty.
reason	string	The operator's stated reason.
halted_by	string	Who applied the halt.
halted_at	timestamp	When.
resumed_by / resumed_at	string / timestamp	Set once resumed — an active posture has resumed_at null/absent (resumption is what deactivates it; the overview only ever embeds active postures).

Where the values come from

Runners, groups, agents and live jobs come from the fleet registry; queue entries from the scheduler's set-based inventory read; postures from the durable posture store; licence_state from the entitlement resolution; maintenance_active from the active-windows read. Degradations are partial, not fatal: a failed licence resolution leaves licence_state empty and a missing pool leaves maintenance_active 0, while a registry or scheduler read failure answers 500.

Related pages

• opschain docs fleet-queue — the per-entry view behind queue.
• opschain docs platform-halt — the postures embedded here.
• opschain docs entitlements — the licence state vocabulary.
• opschain docs maintenance-windows — what an active window quiesces.