diff options
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/access.md | 6 | ||||
| -rw-r--r-- | docs/measurements.md | 1 |
2 files changed, 6 insertions, 1 deletions
diff --git a/docs/access.md b/docs/access.md index 5983c7c..a8dfed4 100644 --- a/docs/access.md +++ b/docs/access.md @@ -296,7 +296,11 @@ every 30 seconds). The peer doesn't take the word for it: it judges each it hold itself, by its rules as they are now. If they refuse one too, it drops it with everything built on it, its document becoming what it would be without them, and puts its own writes among them in the quarantine (`GET /admin/quarantine`), to be replayed -or discarded; what it writes from then on goes everywhere. If its rules take the +or discarded, and the others' among the refused (`GET /admin/refused`, "taken +unjudged, dropped"); what it writes from then on goes everywhere. A drop taking more +than 100 changes, or more than ten and a tenth of the document, waits until a second member says so too: +its own rules and one peer's word could both be off (logged as an error, counted in +`/admin/stats` as `sync.dropsHeld`). If its rules take the change, the two policies disagree, which it logs. A change whose dependencies haven't come yet waits for them. diff --git a/docs/measurements.md b/docs/measurements.md index 4550357..c377d9c 100644 --- a/docs/measurements.md +++ b/docs/measurements.md @@ -79,6 +79,7 @@ or caught up over many small messages. | `sync.lastFromNeighbourSecs` | `last_sync_from_neighbour_seconds` | Since a sync message from any neighbour was applied. Growing without bound while others write: the node is cut off from the swarm's changes. | | `sync.divergedPeers` | `diverged_peers` | Peers whose heads differ from ours with no sync message in between. | | `sync.refusedPeers` | `refused_peers` | Peers refused as a whole, their own changes having broken the swarm's rules ([`access.md`](access.md)): sent nothing. | +| `sync.dropsHeld` | `drops_held` | Changes a peer says the swarm's rules refuse, which this node took unjudged and its rules refuse too, whose drop would take much: held until a second member says so ([`access.md`](access.md)). Above 0: look at the log (`dropping it takes much`). | | `sync.largestReceivedBytes` | `largest_sync_received_bytes` | The largest sync message received since start. Larger transfers come as deltas (blobs of 16 chunks or more, [`peers.md`](peers.md)), so this stays below 16 × `--blob-chunk` from nodes of this version. | | `relay.announceRounds` | `announce_rounds_total` | Announcement rounds: our new heads to the neighbours after applying their changes (the quick round to those writers' trees leave out, or to all for changes no tree carries, and the slow round to the others; [`peers.md`](peers.md)). | | `relay.treelessRounds` | `treeless_rounds_total` | Of those, quick rounds to all neighbours: some change came that no writer's tree carries (pulled, a delta, from a node with no part in its tree). Many, with every node on the member list: trees miss often. | |