aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authortv <tv@krebsco.de>2026-11-05 00:56:51 +0100
committertv <tv@krebsco.de>2026-11-05 00:56:51 +0100
commit63871240278181f14af9d561f30b428d5db5e34a (patch)
tree946ac238d40cbb2766886339337d954c3b933b56 /docs
parent4da17a5e40e34aea27a34241b4f692ae0c827f57 (diff)
asked again counter
Diffstat (limited to 'docs')
-rw-r--r--docs/measurements.md1
-rw-r--r--docs/openapi.yaml5
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: