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.
dashinserve.yamlandnode.yamlconfigures 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/.