diff options
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/measurements.md | 1 | ||||
| -rw-r--r-- | docs/openapi.yaml | 5 |
2 files changed, 5 insertions, 1 deletions
diff --git a/docs/measurements.md b/docs/measurements.md index cff7add..b5c3d6e 100644 --- a/docs/measurements.md +++ b/docs/measurements.md @@ -261,6 +261,7 @@ forgotten peer's are gone). |---|---|---| | `incidents.replyTimeouts` | `peer_reply_timeouts_total` | Our sync messages the peer didn't answer in time (10 s, 30 s with Tor enabled, doubling to 30 times that); resent. Lost messages, or a slow peer. | | `incidents.heals` | `peer_heals_total` | Re-handshakes because our heads and the peer's differed for `resync_after` with no sync between ([`peers.md`](peers.md), "Keepalive and self-healing"). Rare in a healthy swarm; frequent means sync state keeps getting out of step. | +| `incidents.askedAgain` | `peer_asked_again_total` | Times nothing answered what we sent (a keepalive, or a sync message that awaits an answer) for half the time it may before the peer counts as unreached (`unreached_after`, twice the first sync reply timeout), so a PING asked again ([`peers.md`](peers.md)). Each is a PING and its PONG on top of the keepalives. | | `incidents.dormancies` | `peer_dormancies_total` | Times the peer went dormant (nothing received for `dormant_after`). | | `incidents.dormantMs` | `peer_dormant_seconds_total` | Time it spent dormant, up to its last return. | diff --git a/docs/openapi.yaml b/docs/openapi.yaml index db73ede..f45fae7 100644 --- a/docs/openapi.yaml +++ b/docs/openapi.yaml @@ -1743,7 +1743,7 @@ components: Incidents: type: object - required: [replyTimeouts, heals, dormancies, dormantMs] + required: [replyTimeouts, heals, askedAgain, dormancies, dormantMs] properties: replyTimeouts: type: integer @@ -1751,6 +1751,9 @@ components: heals: type: integer description: Re-handshakes because documents differed while sync was idle. + askedAgain: + type: integer + description: Times nothing answered our keepalives or sync messages for a while, so a PING asked again. dormancies: type: integer dormantMs: |