diff options
| author | tv <tv@krebsco.de> | 2026-11-09 05:36:38 +0000 |
|---|---|---|
| committer | tv <tv@krebsco.de> | 2026-11-09 06:42:57 +0100 |
| commit | 8a7df0caa51fc1b01e2a744c9e48dd3a1af39296 (patch) | |
| tree | 6a9c715e840d90171a162f4c9f4300dd8eb69838 /docs/dashboard.md | |
| parent | b2c5096744c99453856f7281251b3f0cb4b9baae (diff) | |
dashboard: a subscribed node's own figures when it is in focus
A node in focus showed this node's `/peers` entry for it and the links it reports:
what this node knows of it, never what it says of itself, though the page subscribes to
it. Now a subscribed node in focus shows its own figures first (`Node:`), as this
node's are (its `/admin/stats`), then this node's entry for it (`as this node sees it`)
and its links, each a branch. A link in focus shows each end's paths to the other as
that end has them: this node's, and a subscribed node's from its `/peers`.
The page reads them from the node every 2 s while it is in focus (`readFigures`,
`figuresOf`), with its narrow token, which may look at a node as any user with a
capability may; pages of other origins may now call `/admin/stats` and `/peers`
(`cors::open`), as they do a node's links and messages. Where they can't be read, the
box says why.
Diffstat (limited to 'docs/dashboard.md')
| -rw-r--r-- | docs/dashboard.md | 17 |
1 files changed, 11 insertions, 6 deletions
diff --git a/docs/dashboard.md b/docs/dashboard.md index 590f72f..da69a16 100644 --- a/docs/dashboard.md +++ b/docs/dashboard.md @@ -287,14 +287,18 @@ What the Figures box shows is what is in focus: * **Nothing** (the default): this node's figures. * **A node** (click it on the map, or its row in Peers): this node's entry for that - peer (as `/peers` has it), and the links that member reports. Ringed on the map, + peer (as `/peers` has it), and the links that member reports. A node the page + subscribes to: its own figures first, as this node's are (its `/admin/stats`, read + from it every 2 s while in focus, with the page's token), then this node's entry for + it (`as this node sees it`) and its links, each a branch. Ringed on the map, highlighted in Peers. A second click on its row, a click beside the nodes or a click on this node goes back. * **A link** (click it): whether the member list intends it, each end's report of it (transport, relayed, round trip, dormant, its other transports, and how old the - report is), and, where this node is an end, the link as this node has it in `/peers`: - where messages go, its paths (each with its connection and round trip), and the - addresses known of the other end. Both ends are ringed. + report is), and, where this node or a node the page subscribes to is an end, the link + as that end has it in its `/peers` (a subscribed node's read from it, as its + figures): where messages go, its paths (each with its connection and round trip), + and the addresses known of the other end. Both ends are ringed. The focus is in the page's address (`#<node ID>`, or the two IDs of a link), so a reload keeps it and a link to the page can name it. @@ -321,8 +325,9 @@ The box is as tall as its rows, up to eight; then it scrolls. ## Figures The figures of what is in focus, as a tree, its keys at the top level and how many -beside the title: this node's `/admin/stats`, or a peer's `/peers` entry and, after it, -the links it reports (`links`), where the page has them. +beside the title: this node's `/admin/stats`; a subscribed node's own (`Node:`), with +this node's entry for it and its links after; or a peer's `/peers` entry and, after +it, the links it reports (`links`), where the page has them. Branches stay as opened across updates, and ages count on between them. What each figure means: [`measurements.md`](measurements.md). Some values get a reading after them, muted, in parentheses: a node ID its alias |
