add document lock stats

1 files changed, 30 insertions, 0 deletions

diff --git a/docs/openapi.yaml b/docs/openapi.yaml
index d7a3faa..bb3e176 100644
--- a/docs/openapi.yaml
+++ b/docs/openapi.yaml
@@ -1305,6 +1305,15 @@ components:
               type: [integer, 'null']
             savedBytesTookMs:
               type: [integer, 'null']
+            lockWait:
+              type: object
+              description: How long takers of the document's lock waited for it, since start, by mode.
+              required: [read, write]
+              properties:
+                read:
+                  $ref: '#/components/schemas/LockWaits'
+                write:
+                  $ref: '#/components/schemas/LockWaits'
         catchUp:
           type: object
           required: [sources]
@@ -1573,6 +1582,27 @@ components:
                   count:
                     type: integer
 
+    LockWaits:
+      type: object
+      required: [count, sumUs, maxUs, buckets]
+      properties:
+        count:
+          type: integer
+        sumUs:
+          type: integer
+        maxUs:
+          type: integer
+        buckets:
+          type: array
+          description: Not cumulative; the last bucket has no bound.
+          items:
+            type: object
+            required: [leUs, count]
+            properties:
+              leUs:
+                type: [integer, 'null']
+              count:
+                type: integer
     Retention:
       type: object
       description: Kept until every given limit has passed (as reports show it).