2acde41e54
The hive dashboard and the per-agent page lose their control-by-control UI description and endpoint tables from the handbook. The full text moves to 4-implementation/web-ui/dashboard.md and agent-page.md, and the handbook pages keep what an operator needs to find and use them. Code comments that named the old sections point at the new pages.
33 lines
1.8 KiB
Markdown
33 lines
1.8 KiB
Markdown
# Dashboard layout
|
|
|
|
> Part of [Hives](README.md). See also: [Per-agent page](../agents/web-page.md)
|
|
|
|
The hive dashboard is the per-hive UI that hive-c0re serves at `/`. The
|
|
[swarm UI](../swarm/ui.md) holds everything swarm-wide (the agent roster, agent
|
|
creation, linking external forge and matrix accounts, the controller's job
|
|
graph) and is where you do day-to-day work. The hive dashboard keeps shrinking:
|
|
parts of it go, bit by bit.
|
|
|
|
A fixed header holds the tab strip, a **pages** menu with links to the API docs
|
|
and the swarm UI, and a profile menu with your authelia settings and sign-out.
|
|
The URL hash (`#agents`, `#rebuild`, `#kept`) picks the tab.
|
|
|
|
- **4G3NTS** lists the hive's containers, one row each, sorted by name, with
|
|
the agent's status and the actions on it: rebuild, start, stop, destroy. A red
|
|
banner at the top says two agents hash to the same port. Rename one and
|
|
rebuild.
|
|
- **R3BU1LD QU3U3** shows the rebuild queue and each build's log.
|
|
- **K3PT ST4T3** lists agents with kept state and no container, with their size
|
|
and age. **PURG3** wipes one's state directory. The list also shows an agent
|
|
that's part-way through a spawn, because both look the same on disk: the row
|
|
says `offline` and the tab carries a warning.
|
|
|
|
Per-container CPU, memory and disk figures aren't shown here. They go out as
|
|
metrics and appear in Grafana, and you set an agent's CPU and memory caps per
|
|
agent in the swarm UI. The dashboard shows no hive warnings either; they show up
|
|
as metrics and Grafana alerts (see
|
|
[observability](../../4-implementation/scheduler/observability.md#hive-scoped-metrics-hive-c0re)).
|
|
|
|
The container row, status badges, dialogs, the selection bar, the API endpoints
|
|
and the event channel are in
|
|
[the dashboard reference](../../4-implementation/web-ui/dashboard.md).
|