aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
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 f57db9b..f49f4ff 100644
--- a/docs/measurements.md
+++ b/docs/measurements.md
@@ -266,6 +266,7 @@ forgotten peer's are gone).
| `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. |
+| `incidents.handshakes` | `peer_handshakes_total` | Handshakes the peer started with us (its HELLO, not a retry of one), each resetting our session with it: one per start of the peer, and one when it comes back from dormancy or heals. More than four within a minute are logged as a warning (once a minute): a restart loop, or handshakes that keep failing on its side. |
## Per peer
diff --git a/docs/openapi.yaml b/docs/openapi.yaml
index 5ca41b0..da89b6c 100644
--- a/docs/openapi.yaml
+++ b/docs/openapi.yaml
@@ -1747,7 +1747,7 @@ components:
Incidents:
type: object
- required: [replyTimeouts, heals, askedAgain, dormancies, dormantMs]
+ required: [replyTimeouts, heals, askedAgain, dormancies, dormantMs, handshakes]
properties:
replyTimeouts:
type: integer
@@ -1763,6 +1763,9 @@ components:
dormantMs:
type: integer
description: Time spent dormant up to the last return (the current dormancy isn't included).
+ handshakes:
+ type: integer
+ description: Handshakes the peer started with us (its HELLO, not a retry), each resetting our session with it.
ClockOffset:
type: object