aboutsummaryrefslogtreecommitdiffstats
path: root/docs/measurements.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/measurements.md')
-rw-r--r--docs/measurements.md7
1 files changed, 6 insertions, 1 deletions
diff --git a/docs/measurements.md b/docs/measurements.md
index daf8008..81ca0fc 100644
--- a/docs/measurements.md
+++ b/docs/measurements.md
@@ -98,6 +98,9 @@ or caught up over many small messages.
| `topology.view.stable` | `stable_members` | Members whose registry entry says `stable`. |
| `topology.view.neighbours` | `neighbours` | Current neighbours: peers this node keeps alive and syncs with on its own. At least `k` (links chosen by either end count); well above `k` on a stable member that many others chose, bounded at about 8 × k. |
| `topology.view.stableNeighbours` | `stable_neighbours` | Of those, stable members. |
+| `topology.view.ownTree.members` | `own_tree_members` | Other members in this node's own writer's tree: what its writes go along ([`peers.md`](peers.md)), as this node computes it (what members beyond its neighbours reach is taken from the member list's graph). |
+| `topology.view.ownTree.depth`, `.meanDepth` | `own_tree_depth`, `own_tree_mean_depth` | The most hops along it from this node to one of them, and the mean. |
+| `topology.view.ownTree.offTree` | `own_tree_off_members` | Members it doesn't reach: no member they reach comes before them, they are below one such, or the member list's graph doesn't connect them to this node. They get its writes by announcement. |
`view` is absent until the node is ready and knows the member list; until then
everyone counts as a neighbour.
@@ -105,7 +108,9 @@ everyone counts as a neighbour.
**Interpretation.** `members − reachable − 1` is how many members are offline or
unreachable from here; if it is half or more of the electorate, no remake can commit.
`neighbours` far above `k` on one node means it is a hub (a stable member among few),
-which is by design but costs it bandwidth.
+which is by design but costs it bandwidth. A deep own tree, or members off it, means this node's
+writes take long to reach everyone: a writer behind NAT (one member reached), or
+transports bridged by few members.
## Stability