aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authortv <tv@krebsco.de>2026-11-18 18:50:46 +0000
committertv <tv@krebsco.de>2026-11-18 20:31:30 +0100
commit56837530e17d95814d21076c527c8577f0a6da97 (patch)
treee9d48d3645c188e07a0e12b75f8805a1ad0f8e83
parentc64fcc05d8c53bee99ab039bd709039afb730cdd (diff)
dashboard: the event a federation's store stopped at
The federation view shows, below this node's party, the event its store stopped at (`stopped` in `GET /events`), why, and how many events it holds back, with what to do: run a continuum that reads it, or drop it. The page check renders one.
-rw-r--r--docs/dashboard.md4
-rw-r--r--docs/guides/federation/watching.md5
-rw-r--r--src/api/dashboard/check.js12
-rw-r--r--src/api/dashboard/dashboard.html11
4 files changed, 24 insertions, 8 deletions
diff --git a/docs/dashboard.md b/docs/dashboard.md
index 009ac03..a5676ce 100644
--- a/docs/dashboard.md
+++ b/docs/dashboard.md
@@ -400,7 +400,9 @@ federation again; the page keeps the choice. While shown, it is read every 5 s:
* the current version, by its number and hash; the store, its checkpoint (`the root`
until the store moved to one) and how many events it took after it; the party this
- node is of, and whether it votes for it by itself;
+ node is of, and whether it votes for it by itself; where the store stopped at a
+ version this continuum doesn't read, that event, why, and how many events it holds
+ back ([A node stopped](guides/federation/when-things-go-wrong.md#a-node-stopped));
* **parties**: each party's keys and nodes, as they count, each node with its alias and
whether it is a member;
* **rules**: in order, each rule's path and who writes there;
diff --git a/docs/guides/federation/watching.md b/docs/guides/federation/watching.md
index ec7ce6a..a54dd7f 100644
--- a/docs/guides/federation/watching.md
+++ b/docs/guides/federation/watching.md
@@ -32,8 +32,9 @@ store, through its API and its log.
## On the dashboard
A node's dashboard (`/admin/dashboard`) shows the same in its document box, read every
-5 s: the version, the parties and which of their nodes are members, the values, the
-proposals with who voted what and what each changes, and what the node refused
+5 s: the version, where the store stopped, the parties and which of their nodes are
+members, the values, the proposals with who voted what and what each changes, and what
+the node refused
([`dashboard.md`](../../dashboard.md), [Federation](../../dashboard.md#federation)).
## In the log
diff --git a/src/api/dashboard/check.js b/src/api/dashboard/check.js
index 4292e7d..125fc3b 100644
--- a/src/api/dashboard/check.js
+++ b/src/api/dashboard/check.js
@@ -95,7 +95,7 @@ const check = (ok, what) => {
peers: { localReaches: [], peers: {} }, graph: { members: {}, intended: {}, measured: {} } };
federationTimer = 1;
federation.summary = { store: "aa", checkpoint: "aa", heads: ["bb"], taken: 3,
- party: "tv", votesByItself: true };
+ stopped: null, party: "tv", votesByItself: true };
federation.heads = "bb";
federation.counts = { version: { number: 0, hash: "11", version },
parties: { tv: { keys: ["ssh-ed25519 AAAA1"], nodes: ["continuum:a"] },
@@ -109,10 +109,15 @@ const check = (ok, what) => {
showFederation();
renderFederation(true);
const tree = document.getElementById("federation");
- return { writers, title: document.getElementById("document-title").textContent,
+ const shown = { writers, title: document.getElementById("document-title").textContent,
shown: !document.getElementById("federation-scroll").hidden
&& document.getElementById("document-scroll").hidden,
text: tree.textContent, votes: tree.querySelectorAll(".votes button").length };
+ federation.summary = { ...federation.summary,
+ stopped: { id: "ee", why: "version 22 passed, and doesn't read as one here", heldBack: 4 } };
+ renderFederation(true);
+ shown.stopped = tree.textContent;
+ return shown;
});
check(JSON.stringify(federated.writers) === JSON.stringify(["tv", null, null, "tv", null]),
"who writes at a place is the first rule matching it: " + JSON.stringify(federated.writers));
@@ -124,6 +129,9 @@ const check = (ok, what) => {
+ '{"keys":["ssh-ed25519 AAAA3"],"since":1}'),
"a proposal: where it stands, and what its version changes, party by party");
check(federated.votes === 2, "a proposal that can still pass has a vote of each kind");
+ check(!federated.text.includes("stopped at") && federated.stopped.includes("stopped at ee")
+ && federated.stopped.includes("4 held back"),
+ "a store that stopped: the event it stopped at, why, and how many it holds back");
await tab.waitForTimeout(500);
check(errors.length === 0, "no errors on the page" + (errors.length ? ": " + errors : ""));
diff --git a/src/api/dashboard/dashboard.html b/src/api/dashboard/dashboard.html
index a918532..f5d258b 100644
--- a/src/api/dashboard/dashboard.html
+++ b/src/api/dashboard/dashboard.html
@@ -4249,9 +4249,10 @@ function connect() {
// --- The federation: in a swarm holding a store (the snapshot names the node's party),
// the box shows what counts as this node reads it (`GET /events`, `/events/counts`,
// `/events/refused`; docs/guides/federation/) instead of the document, until `document`
-// says otherwise: the current version, the parties, the rules, the values at places (each
-// with who writes there), the proposals on the version (where each stands, who voted
-// what, and what its version changes) and what the node refused. A vote goes through
+// says otherwise: the current version, the event the store stopped at, if any, the
+// parties, the rules, the values at places (each with who writes there), the proposals on
+// the version (where each stands, who voted what, and what its version changes) and what
+// the node refused. A vote goes through
// this node (`POST /admin/events/vote`), which casts it only where it votes for its party
// by itself (`votesByItself`). Read every 5 s while shown, what counts anew where the
// store's heads changed. Writing values takes a key of the party, which the page has
@@ -4574,6 +4575,10 @@ function renderFederation(force = false) {
summary.store),
federationLeaf("this node", "of " + summary.party + (summary.votesByItself
? ", voting for it by itself" : ", not voting for it by itself")),
+ ...(summary.stopped ? [federationLeaf(el("span", { class: "error" }, "stopped at "
+ + short(summary.stopped.id)), summary.stopped.why + " ยท " + summary.stopped.heldBack
+ + " held back: run a continuum that reads it, or drop it "
+ + "(docs/guides/federation/when-things-go-wrong.md)", summary.stopped.id)] : []),
federationBranch("parties", ["parties ", el("span", { class: "gloss" }, parties.length)],
() => parties.map(party => {
const keys = counts.parties[party].keys, nodes = counts.parties[party].nodes;