swarm-metrics reads the swarm's VictoriaMetrics from inside an agent
container: query, query-range, series, labels and label-values, each one
GET against the store's Prometheus read API through the gateway, printing
the store's JSON. It authenticates the way swarm-logs does, with the
agent's own queue secret read from bao under the agent's leaf, sent as
a swarm-agent bearer.
On the metrics store's host the read API's auth map gains an agent arm
ahead of the Grafana one. It routes to swarm-metrics-agent-auth, a
swarm-logs-auth instance logged in under the existing swarm-metrics-auth
leaf, whose bao grant now includes swarm/agents/+/queue read. The check is
rate-limited per address like the log store's
(deploy.victoriametrics.agentAuth{Rate,Burst,VerdictTtl}).
nix/agent-modules/metrics.nix installs the wrapped binary when the hive
forwards HIVE_AGENT_METRICS_URL (from swarm.victoriametrics.domain) and a
store address, the same gate as swarm-logs. Adds the base:swarm-metrics
skill and the CLI reference with its freshness check.
Fixes #5395
28 lines
1.1 KiB
Text
28 lines
1.1 KiB
Text
# Generated by `<tool> markdown-docs` — do not format. The matching
|
|
# *-docs-fresh check in nix/checks.nix diffs each against fresh binary
|
|
# output, so any reformatting fails that check permanently: the
|
|
# generator, not the formatter, owns these files' layout. Every CLI
|
|
# reference doc belongs here — adding one and forgetting this line is
|
|
# what made swarmctl's fail.
|
|
docs/tools/hivectl-cli.md
|
|
docs/tools/swarmctl-cli.md
|
|
docs/tools/forge-cli.md
|
|
docs/tools/swarm-logs-cli.md
|
|
docs/tools/swarm-metrics-cli.md
|
|
|
|
# Files with multi-line list-item continuations that prettier strips to col 0.
|
|
# prettier's `proseWrap: "preserve"` prevents prose reflow but not list-item
|
|
# indentation normalisation, so these files need manual re-wrap before
|
|
# adding them back to the formatter scope.
|
|
CLAUDE.md
|
|
docs/agent-lifecycle/config-changes.md
|
|
docs/process/conventions.md
|
|
docs/networking/gateway.md
|
|
docs/integrations/matrix.md
|
|
docs/agent-lifecycle/persistence.md
|
|
docs/web-ui/terminal-rendering.md
|
|
docs/tools/forge.md
|
|
docs/tools/matrix.md
|
|
docs/turn-loop/README.md
|
|
docs/web-ui/agent.md
|
|
docs/web-ui/dashboard.md
|