7ba684a1da
Roster named the permissions page, the hive's topology file and the swarm's list of agents without saying which. The page and its links are renamed; the implementation docs and UI text follow separately.
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 list, 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).
|