aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/measurements.md2
-rw-r--r--docs/openapi.yaml6
2 files changed, 7 insertions, 1 deletions
diff --git a/docs/measurements.md b/docs/measurements.md
index b5c3d6e..f57db9b 100644
--- a/docs/measurements.md
+++ b/docs/measurements.md
@@ -86,6 +86,8 @@ or caught up over many small messages.
| `relay.pulls` | `pulls_total` | Pulls of changes we lacked from a neighbour that announced them. |
| `relay.pullsQueued` | `pulls_queued_total` | Announcements of heads we lacked that waited for the pull in progress. Many compared with `pulls`: changes arrive from several sides at once. |
| `relay.treeForwards` | `tree_forwards_total` | Changes passed on along writers' trees ([`peers.md`](peers.md)): a sync message per child, at once, instead of an announcement and a pull. |
+| `relay.treeFromOthers` | `tree_from_others_total` | Sync messages along a writer's tree, carrying changes, from a peer other than our parent in it: a change sent twice, or the parent and the child working out the tree differently. Near zero while the trees work; against `treeForwards` swarm-wide, the share of passes that went to the wrong child. |
+| `relay.treeMissed` | `tree_missed_total` | Changes of writers in whose trees this node has a parent that came another way (pulled, with an answer, in a delta): the tree didn't bring them, or not first. Some while members come and go; growing with every write, a tree that doesn't work here. |
| `relay.blobRequestsDropped` | `blob_requests_dropped_total` | Blob requests not answered because too many were being answered; the requester asks again or asks another peer. Also logged as a warning, at most once a minute with the count. |
## Topology
diff --git a/docs/openapi.yaml b/docs/openapi.yaml
index d9d6c04..5ca41b0 100644
--- a/docs/openapi.yaml
+++ b/docs/openapi.yaml
@@ -2050,7 +2050,7 @@ components:
type: integer
relay:
type: object
- required: [announceRounds, treelessRounds, slowRounds, pulls, pullsQueued, treeForwards, blobRequestsDropped]
+ required: [announceRounds, treelessRounds, slowRounds, pulls, pullsQueued, treeForwards, treeFromOthers, treeMissed, blobRequestsDropped]
properties:
announceRounds:
type: integer
@@ -2064,6 +2064,10 @@ components:
type: integer
treeForwards:
type: integer
+ treeFromOthers:
+ type: integer
+ treeMissed:
+ type: integer
blobRequestsDropped:
type: integer
topology: