diff options
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/measurements.md | 3 | ||||
| -rw-r--r-- | docs/openapi.yaml | 8 |
2 files changed, 10 insertions, 1 deletions
diff --git a/docs/measurements.md b/docs/measurements.md index 131adca..f93a79a 100644 --- a/docs/measurements.md +++ b/docs/measurements.md @@ -83,6 +83,9 @@ or caught up over many small messages. | `relay.announceRounds` | `announce_rounds_total` | Announcement rounds: our new heads to the neighbours after applying their changes (partial mesh only). | | `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.grafts` | `grafts_total` | Links made eager: a pull brought changes over them, which from then on the neighbour sends as it applies them ([`peers.md`](peers.md)). | +| `relay.prunes` | `prunes_total` | Links made lazy again: changes came over them that another path had brought first. Grafts and prunes growing together, long after start: links keep switching, as when writers in different places take turns. | +| `relay.eagerForwards` | `eager_forwards_total` | Changes forwarded over eager links: a sync message per neighbour, instead of an announcement and a pull. | | `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 701cdf9..c925dde 100644 --- a/docs/openapi.yaml +++ b/docs/openapi.yaml @@ -1966,7 +1966,7 @@ components: type: integer relay: type: object - required: [announceRounds, pulls, pullsQueued, blobRequestsDropped] + required: [announceRounds, pulls, pullsQueued, grafts, prunes, eagerForwards, blobRequestsDropped] properties: announceRounds: type: integer @@ -1974,6 +1974,12 @@ components: type: integer pullsQueued: type: integer + grafts: + type: integer + prunes: + type: integer + eagerForwards: + type: integer blobRequestsDropped: type: integer topology: |