add peer clock skew warning

1 files changed, 20 insertions, 0 deletions

diff --git a/docs/openapi.yaml b/docs/openapi.yaml
index d1f5935..1b20ee9 100644
--- a/docs/openapi.yaml
+++ b/docs/openapi.yaml
@@ -1802,6 +1802,26 @@ components:
                     type: [integer, 'null']
                   count:
                     type: integer
+        clock:
+          type: object
+          description: This node's clock against its active peers' (`measurements.md`, Clocks).
+          required: [peers, offsetMs, behind, ahead, off]
+          properties:
+            peers:
+              type: integer
+              description: Active peers whose clocks were compared.
+            offsetMs:
+              type: [integer, 'null']
+              description: How far ours is ahead of theirs (behind if negative), the median.
+            behind:
+              type: integer
+              description: Peers behind ours by more than --clock-skew-warn, for sure.
+            ahead:
+              type: integer
+              description: Peers ahead of ours by more than --clock-skew-warn, for sure.
+            off:
+              type: boolean
+              description: Ours differs from more than half of theirs that way.
 
     LockWaits:
       type: object