Fleet docs v0.2.0-rc.448

The dashboard panels

The fleet page is one HTML page. It reads /api/state every 15 s while the tab is open. The server collects the data in the background, so a page load never waits for a collector.

Panel Shows Who sees it Turned on by
Home Your sessions, what needs you, one health line Everyone Always
This box CPU, memory, disks, network of each box Admins Always, unless the box runs no turns
Monitor Alerts and host metrics from Prometheus Admins dash.monitor_context
Claude usage Your profiles and their usage readings Everyone Always for a signed-in person
Agent graph Moved to the Graph page Everyone Always
Builds Issues by wave, with PR and agent Admins builds_file in serve.yaml
Workers Each agent: health, state, what it does (data only: the page shows it in Home and on the Graph page) Everyone Always
Projects Open issues, PRs and CI runs of each repo Admins dash.forgejo_api and dash.projects_dir
Deployed vs HEAD What runs in the cluster against the repo Admins Part of Projects, with dash.clusters
Supervisor log Agents that need attention Everyone Always

Things that apply to every panel

  • The navbar is the same on every page: Home (this dashboard), Chat, Board, Machines and Docs, with the current page marked. A yellow number on Chat counts the workers that wait for your answer. The button on the right switches the theme: system, light, dark. On a phone the bar shows the current page's name; tap it for the other pages.
  • The title line under the navbar shows the fleet's name and "updated" with the time. If the page cannot reach the server, it shows "⚠ offline · last … ago". Then the data on the page is old.
  • Sign out is on the title line only when a sign-in proxy is in front of the page. It ends the proxy session, and the proxy then starts a new sign-in.
  • A bad sign-in repairs itself. If a proxy is there and the server refuses the identity token, the page signs out and starts a new sign-in. If the session ends while the tab is open, the page reloads and the proxy starts a new sign-in. The page does this at most once in 5 minutes for each tab. If the problem comes back in that time, the page stops and shows "⚠ sign-in failed again · Sign out". With no proxy, a refused sign-in shows "⚠ sign-in refused by the server".
  • The filter (all I can see, mine, project) narrows the fleet agents. It changes the sessions, the agent graph and the log. It does not change the other panels.
  • Only Home is open at first. The other panels are folded; a panel loads its data when you open it.
  • A panel that the server does not send is hidden.
  • "waiting for first collection…" means that the collector has not finished one run.
  • "⚠ · showing data from … ago" means that the last collection failed. The panel shows the last good data.
  • "⚠ render error: …" is a fault in the page itself. Report it with the text.
  • dash in serve.yaml and node.yaml configures the collectors (fleet/internal/dash/run.go). The keys are read strictly. An unknown key is an error.

The page: fleet/internal/web/index.html. The state: fleet/internal/api/state.go. The collectors: fleet/internal/dash/.