kb-cloud-client-typescript 2.4.0-alpha.45 → 2.4.0-alpha.47

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (115) hide show
  1. package/dist/adminapi/api.d.ts +1 -0
  2. package/dist/adminapi/api.d.ts.map +1 -1
  3. package/dist/adminapi/api.js +1 -0
  4. package/dist/adminapi/api.js.map +1 -1
  5. package/dist/adminapi/apis/diagnostics-api.d.ts +229 -0
  6. package/dist/adminapi/apis/diagnostics-api.d.ts.map +1 -1
  7. package/dist/adminapi/apis/diagnostics-api.js +247 -0
  8. package/dist/adminapi/apis/diagnostics-api.js.map +1 -1
  9. package/dist/adminapi/apis/oracle-api.d.ts +422 -0
  10. package/dist/adminapi/apis/oracle-api.d.ts.map +1 -0
  11. package/dist/adminapi/apis/oracle-api.js +471 -0
  12. package/dist/adminapi/apis/oracle-api.js.map +1 -0
  13. package/dist/adminapi/models/index.d.ts +7 -0
  14. package/dist/adminapi/models/index.d.ts.map +1 -1
  15. package/dist/adminapi/models/index.js +7 -0
  16. package/dist/adminapi/models/index.js.map +1 -1
  17. package/dist/adminapi/models/oracle-tablespace-contents.d.ts +22 -0
  18. package/dist/adminapi/models/oracle-tablespace-contents.d.ts.map +1 -0
  19. package/dist/adminapi/models/oracle-tablespace-contents.js +26 -0
  20. package/dist/adminapi/models/oracle-tablespace-contents.js.map +1 -0
  21. package/dist/adminapi/models/oracle-tablespace-create.d.ts +45 -0
  22. package/dist/adminapi/models/oracle-tablespace-create.d.ts.map +1 -0
  23. package/dist/adminapi/models/oracle-tablespace-create.js +16 -0
  24. package/dist/adminapi/models/oracle-tablespace-create.js.map +1 -0
  25. package/dist/adminapi/models/oracle-tablespace-expand-action.d.ts +22 -0
  26. package/dist/adminapi/models/oracle-tablespace-expand-action.d.ts.map +1 -0
  27. package/dist/adminapi/models/oracle-tablespace-expand-action.js +26 -0
  28. package/dist/adminapi/models/oracle-tablespace-expand-action.js.map +1 -0
  29. package/dist/adminapi/models/oracle-tablespace-expand.d.ts +45 -0
  30. package/dist/adminapi/models/oracle-tablespace-expand.d.ts.map +1 -0
  31. package/dist/adminapi/models/oracle-tablespace-expand.js +16 -0
  32. package/dist/adminapi/models/oracle-tablespace-expand.js.map +1 -0
  33. package/dist/adminapi/models/oracle-tablespace-file-spec.d.ts +49 -0
  34. package/dist/adminapi/models/oracle-tablespace-file-spec.d.ts.map +1 -0
  35. package/dist/adminapi/models/oracle-tablespace-file-spec.js +16 -0
  36. package/dist/adminapi/models/oracle-tablespace-file-spec.js.map +1 -0
  37. package/dist/adminapi/models/oracle-tablespace-file.d.ts +67 -0
  38. package/dist/adminapi/models/oracle-tablespace-file.d.ts.map +1 -0
  39. package/dist/adminapi/models/oracle-tablespace-file.js +16 -0
  40. package/dist/adminapi/models/oracle-tablespace-file.js.map +1 -0
  41. package/dist/adminapi/models/oracle-tablespace.d.ts +86 -0
  42. package/dist/adminapi/models/oracle-tablespace.d.ts.map +1 -0
  43. package/dist/adminapi/models/oracle-tablespace.js +16 -0
  44. package/dist/adminapi/models/oracle-tablespace.js.map +1 -0
  45. package/dist/openapi/api.d.ts +1 -0
  46. package/dist/openapi/api.d.ts.map +1 -1
  47. package/dist/openapi/api.js +1 -0
  48. package/dist/openapi/api.js.map +1 -1
  49. package/dist/openapi/apis/diagnostics-api.d.ts +229 -0
  50. package/dist/openapi/apis/diagnostics-api.d.ts.map +1 -1
  51. package/dist/openapi/apis/diagnostics-api.js +247 -0
  52. package/dist/openapi/apis/diagnostics-api.js.map +1 -1
  53. package/dist/openapi/apis/oracle-api.d.ts +422 -0
  54. package/dist/openapi/apis/oracle-api.d.ts.map +1 -0
  55. package/dist/openapi/apis/oracle-api.js +471 -0
  56. package/dist/openapi/apis/oracle-api.js.map +1 -0
  57. package/dist/openapi/models/index.d.ts +7 -0
  58. package/dist/openapi/models/index.d.ts.map +1 -1
  59. package/dist/openapi/models/index.js +7 -0
  60. package/dist/openapi/models/index.js.map +1 -1
  61. package/dist/openapi/models/oracle-tablespace-contents.d.ts +22 -0
  62. package/dist/openapi/models/oracle-tablespace-contents.d.ts.map +1 -0
  63. package/dist/openapi/models/oracle-tablespace-contents.js +26 -0
  64. package/dist/openapi/models/oracle-tablespace-contents.js.map +1 -0
  65. package/dist/openapi/models/oracle-tablespace-create.d.ts +45 -0
  66. package/dist/openapi/models/oracle-tablespace-create.d.ts.map +1 -0
  67. package/dist/openapi/models/oracle-tablespace-create.js +16 -0
  68. package/dist/openapi/models/oracle-tablespace-create.js.map +1 -0
  69. package/dist/openapi/models/oracle-tablespace-expand-action.d.ts +22 -0
  70. package/dist/openapi/models/oracle-tablespace-expand-action.d.ts.map +1 -0
  71. package/dist/openapi/models/oracle-tablespace-expand-action.js +26 -0
  72. package/dist/openapi/models/oracle-tablespace-expand-action.js.map +1 -0
  73. package/dist/openapi/models/oracle-tablespace-expand.d.ts +45 -0
  74. package/dist/openapi/models/oracle-tablespace-expand.d.ts.map +1 -0
  75. package/dist/openapi/models/oracle-tablespace-expand.js +16 -0
  76. package/dist/openapi/models/oracle-tablespace-expand.js.map +1 -0
  77. package/dist/openapi/models/oracle-tablespace-file-spec.d.ts +49 -0
  78. package/dist/openapi/models/oracle-tablespace-file-spec.d.ts.map +1 -0
  79. package/dist/openapi/models/oracle-tablespace-file-spec.js +16 -0
  80. package/dist/openapi/models/oracle-tablespace-file-spec.js.map +1 -0
  81. package/dist/openapi/models/oracle-tablespace-file.d.ts +67 -0
  82. package/dist/openapi/models/oracle-tablespace-file.d.ts.map +1 -0
  83. package/dist/openapi/models/oracle-tablespace-file.js +16 -0
  84. package/dist/openapi/models/oracle-tablespace-file.js.map +1 -0
  85. package/dist/openapi/models/oracle-tablespace.d.ts +86 -0
  86. package/dist/openapi/models/oracle-tablespace.d.ts.map +1 -0
  87. package/dist/openapi/models/oracle-tablespace.js +16 -0
  88. package/dist/openapi/models/oracle-tablespace.js.map +1 -0
  89. package/package.json +1 -1
  90. package/src/adminapi/.openapi-generator/FILES +8 -0
  91. package/src/adminapi/api.ts +1 -0
  92. package/src/adminapi/apis/diagnostics-api.ts +401 -0
  93. package/src/adminapi/apis/oracle-api.ts +726 -0
  94. package/src/adminapi/models/index.ts +7 -0
  95. package/src/adminapi/models/oracle-tablespace-contents.ts +31 -0
  96. package/src/adminapi/models/oracle-tablespace-create.ts +56 -0
  97. package/src/adminapi/models/oracle-tablespace-expand-action.ts +31 -0
  98. package/src/adminapi/models/oracle-tablespace-expand.ts +56 -0
  99. package/src/adminapi/models/oracle-tablespace-file-spec.ts +54 -0
  100. package/src/adminapi/models/oracle-tablespace-file.ts +72 -0
  101. package/src/adminapi/models/oracle-tablespace.ts +93 -0
  102. package/src/adminapi.yaml +966 -449
  103. package/src/openapi/.openapi-generator/FILES +8 -0
  104. package/src/openapi/api.ts +1 -0
  105. package/src/openapi/apis/diagnostics-api.ts +401 -0
  106. package/src/openapi/apis/oracle-api.ts +726 -0
  107. package/src/openapi/models/index.ts +7 -0
  108. package/src/openapi/models/oracle-tablespace-contents.ts +31 -0
  109. package/src/openapi/models/oracle-tablespace-create.ts +56 -0
  110. package/src/openapi/models/oracle-tablespace-expand-action.ts +31 -0
  111. package/src/openapi/models/oracle-tablespace-expand.ts +56 -0
  112. package/src/openapi/models/oracle-tablespace-file-spec.ts +54 -0
  113. package/src/openapi/models/oracle-tablespace-file.ts +72 -0
  114. package/src/openapi/models/oracle-tablespace.ts +93 -0
  115. package/src/openapi.yaml +1668 -1151
package/src/adminapi.yaml CHANGED
@@ -20751,6 +20751,228 @@ paths:
20751
20751
  $ref: '#/components/responses/404'
20752
20752
  '500':
20753
20753
  $ref: '#/components/responses/500'
20754
+ /admin/v1/data/oracle/organizations/{orgName}/clusters/{clusterName}/tablespaces:
20755
+ get:
20756
+ tags:
20757
+ - oracle
20758
+ summary: List Oracle tablespaces
20759
+ description: List tablespaces for a Oracle cluster.
20760
+ operationId: listOracleTablespaces
20761
+ parameters:
20762
+ - name: orgName
20763
+ in: path
20764
+ required: true
20765
+ schema:
20766
+ type: string
20767
+ description: Organization name
20768
+ - name: clusterName
20769
+ in: path
20770
+ required: true
20771
+ schema:
20772
+ type: string
20773
+ description: Cluster name
20774
+ responses:
20775
+ '200':
20776
+ content:
20777
+ application/json:
20778
+ schema:
20779
+ type: array
20780
+ items:
20781
+ $ref: '#/components/schemas/OracleTablespace'
20782
+ description: A successful response.
20783
+ '400':
20784
+ $ref: '#/components/responses/400'
20785
+ '401':
20786
+ $ref: '#/components/responses/401'
20787
+ '403':
20788
+ $ref: '#/components/responses/403'
20789
+ '404':
20790
+ $ref: '#/components/responses/404'
20791
+ '500':
20792
+ $ref: '#/components/responses/500'
20793
+ post:
20794
+ tags:
20795
+ - oracle
20796
+ summary: Create Oracle tablespace
20797
+ description: Create tablespace for a Oracle cluster.
20798
+ operationId: createOracleTablespace
20799
+ parameters:
20800
+ - name: orgName
20801
+ in: path
20802
+ required: true
20803
+ schema:
20804
+ type: string
20805
+ description: Organization name
20806
+ - name: clusterName
20807
+ in: path
20808
+ required: true
20809
+ schema:
20810
+ type: string
20811
+ description: Cluster name
20812
+ requestBody:
20813
+ required: true
20814
+ content:
20815
+ application/json:
20816
+ schema:
20817
+ $ref: '#/components/schemas/OracleTablespaceCreate'
20818
+ responses:
20819
+ '200':
20820
+ content:
20821
+ application/json:
20822
+ schema:
20823
+ $ref: '#/components/schemas/OracleTablespace'
20824
+ description: A successful response.
20825
+ '400':
20826
+ $ref: '#/components/responses/400'
20827
+ '401':
20828
+ $ref: '#/components/responses/401'
20829
+ '403':
20830
+ $ref: '#/components/responses/403'
20831
+ '404':
20832
+ $ref: '#/components/responses/404'
20833
+ '500':
20834
+ $ref: '#/components/responses/500'
20835
+ /admin/v1/data/oracle/organizations/{orgName}/clusters/{clusterName}/tablespaces/{tablespaceName}:
20836
+ get:
20837
+ tags:
20838
+ - oracle
20839
+ summary: Get Oracle tablespace info
20840
+ operationId: getOracleTablespace
20841
+ parameters:
20842
+ - name: orgName
20843
+ in: path
20844
+ required: true
20845
+ schema:
20846
+ type: string
20847
+ description: Organization name
20848
+ - name: clusterName
20849
+ in: path
20850
+ required: true
20851
+ schema:
20852
+ type: string
20853
+ description: Cluster name
20854
+ - name: tablespaceName
20855
+ in: path
20856
+ required: true
20857
+ schema:
20858
+ type: string
20859
+ description: Tablespace name
20860
+ responses:
20861
+ '200':
20862
+ content:
20863
+ application/json:
20864
+ schema:
20865
+ $ref: '#/components/schemas/OracleTablespace'
20866
+ description: A successful response.
20867
+ '400':
20868
+ $ref: '#/components/responses/400'
20869
+ '401':
20870
+ $ref: '#/components/responses/401'
20871
+ '403':
20872
+ $ref: '#/components/responses/403'
20873
+ '404':
20874
+ $ref: '#/components/responses/404'
20875
+ '500':
20876
+ $ref: '#/components/responses/500'
20877
+ delete:
20878
+ tags:
20879
+ - oracle
20880
+ summary: Delete Oracle tablespace
20881
+ description: Delete tablespace for a Oracle cluster.
20882
+ operationId: deleteOracleTablespace
20883
+ parameters:
20884
+ - name: orgName
20885
+ in: path
20886
+ required: true
20887
+ schema:
20888
+ type: string
20889
+ description: Organization name
20890
+ - name: clusterName
20891
+ in: path
20892
+ required: true
20893
+ schema:
20894
+ type: string
20895
+ description: Cluster name
20896
+ - name: tablespaceName
20897
+ in: path
20898
+ required: true
20899
+ schema:
20900
+ type: string
20901
+ description: Tablespace name
20902
+ - name: includingContents
20903
+ in: query
20904
+ schema:
20905
+ type: boolean
20906
+ default: false
20907
+ description: Explicitly delete all objects in the tablespace. Without this flag Oracle rejects nonempty tablespaces.
20908
+ - name: deleteDatafiles
20909
+ in: query
20910
+ schema:
20911
+ type: boolean
20912
+ default: false
20913
+ description: Also remove physical files. Requires includingContents. Otherwise manually managed files are retained.
20914
+ responses:
20915
+ '204':
20916
+ content: {}
20917
+ description: A successful response.
20918
+ '400':
20919
+ $ref: '#/components/responses/400'
20920
+ '401':
20921
+ $ref: '#/components/responses/401'
20922
+ '403':
20923
+ $ref: '#/components/responses/403'
20924
+ '404':
20925
+ $ref: '#/components/responses/404'
20926
+ '500':
20927
+ $ref: '#/components/responses/500'
20928
+ patch:
20929
+ tags:
20930
+ - oracle
20931
+ summary: Expand Oracle tablespace
20932
+ description: Expand one existing datafile/tempfile or add one file in the current container.
20933
+ operationId: expandOracleTablespace
20934
+ parameters:
20935
+ - name: orgName
20936
+ in: path
20937
+ required: true
20938
+ schema:
20939
+ type: string
20940
+ description: Organization name
20941
+ - name: clusterName
20942
+ in: path
20943
+ required: true
20944
+ schema:
20945
+ type: string
20946
+ description: Cluster name
20947
+ - name: tablespaceName
20948
+ in: path
20949
+ required: true
20950
+ schema:
20951
+ type: string
20952
+ description: Tablespace name
20953
+ requestBody:
20954
+ required: true
20955
+ content:
20956
+ application/json:
20957
+ schema:
20958
+ $ref: '#/components/schemas/OracleTablespaceExpand'
20959
+ responses:
20960
+ '200':
20961
+ content:
20962
+ application/json:
20963
+ schema:
20964
+ $ref: '#/components/schemas/OracleTablespace'
20965
+ description: A successful response.
20966
+ '400':
20967
+ $ref: '#/components/responses/400'
20968
+ '401':
20969
+ $ref: '#/components/responses/401'
20970
+ '403':
20971
+ $ref: '#/components/responses/403'
20972
+ '404':
20973
+ $ref: '#/components/responses/404'
20974
+ '500':
20975
+ $ref: '#/components/responses/500'
20754
20976
  /admin/v1/data/damengdb/organizations/{orgName}/clusters/{clusterName}/tablespaces:
20755
20977
  get:
20756
20978
  tags:
@@ -22144,13 +22366,13 @@ paths:
22144
22366
  - session
22145
22367
  - rdbms
22146
22368
  - shared
22147
- /admin/v1/organizations/{orgName}/clusters/{clusterName}/diagnostics/mysql/spaceAnalysis:
22369
+ /admin/v1/organizations/{orgName}/clusters/{clusterName}/diagnostics/mariadb/spaceAnalysis:
22148
22370
  get:
22149
22371
  tags:
22150
22372
  - diagnostics
22151
- summary: Get MySQL space analysis
22152
- description: Get a read-only MySQL 5.7, 8.0, or 8.4 compatible space snapshot and fixed backend-owned storage metrics.
22153
- operationId: getDiagnosticsMysqlSpaceAnalysis
22373
+ summary: Get MariaDB space analysis
22374
+ description: Get a read-only MariaDB compatible space snapshot and fixed backend-owned storage metrics.
22375
+ operationId: getDiagnosticsMariaDBSpaceAnalysis
22154
22376
  parameters:
22155
22377
  - name: orgName
22156
22378
  in: path
@@ -22185,39 +22407,46 @@ paths:
22185
22407
  $ref: '#/components/responses/404'
22186
22408
  '500':
22187
22409
  $ref: '#/components/responses/500'
22188
- /admin/v1/organizations/{orgName}/clusters/{clusterName}/diagnostics/mssql/sessions:
22410
+ /admin/v1/organizations/{orgName}/clusters/{clusterName}/diagnostics/mariadb/sqlAnalysis:
22189
22411
  get:
22190
22412
  tags:
22191
22413
  - diagnostics
22192
- operationId: listDiagnosticsMssqlSessions
22193
- summary: List SQL Server sessions
22414
+ summary: Get MariaDB SQL analysis
22415
+ description: Get a read-only MariaDB SQL fingerprint ranking from Performance Schema statement digests. The response does not expose raw SQL text, time-window aggregation, execution plans, or remediation actions.
22416
+ operationId: getDiagnosticsMariaDBSQLAnalysis
22194
22417
  parameters:
22195
22418
  - name: orgName
22196
22419
  in: path
22420
+ description: Organization name
22197
22421
  required: true
22198
22422
  schema:
22199
22423
  type: string
22200
22424
  - name: clusterName
22201
22425
  in: path
22426
+ description: Cluster name
22202
22427
  required: true
22203
22428
  schema:
22204
22429
  type: string
22205
22430
  - name: limit
22206
22431
  in: query
22432
+ description: Maximum number of SQL fingerprints to return. The backend applies its own upper bound.
22207
22433
  required: false
22208
22434
  schema:
22209
22435
  type: integer
22210
22436
  format: int64
22211
- minimum: 1
22212
- maximum: 1000
22213
- default: 500
22437
+ - name: orderBy
22438
+ in: query
22439
+ description: Sort key. Allowed values are totalTime, meanTime, maxTime, and calls. Defaults to totalTime.
22440
+ required: false
22441
+ schema:
22442
+ type: string
22214
22443
  responses:
22215
22444
  '200':
22216
22445
  description: OK
22217
22446
  content:
22218
22447
  application/json:
22219
22448
  schema:
22220
- $ref: '#/components/schemas/mssqlSessionSnapshot'
22449
+ $ref: '#/components/schemas/mysqlSQLAnalysis'
22221
22450
  '400':
22222
22451
  $ref: '#/components/responses/400'
22223
22452
  '401':
@@ -22228,34 +22457,36 @@ paths:
22228
22457
  $ref: '#/components/responses/404'
22229
22458
  '500':
22230
22459
  $ref: '#/components/responses/500'
22231
- /admin/v1/organizations/{orgName}/clusters/{clusterName}/diagnostics/mssql/sessions/{sessionId}:
22460
+ /admin/v1/organizations/{orgName}/clusters/{clusterName}/diagnostics/mariadb/performanceTrends:
22232
22461
  get:
22233
22462
  tags:
22234
22463
  - diagnostics
22235
- operationId: getDiagnosticsMssqlSession
22236
- summary: Get a SQL Server session
22464
+ summary: Get MariaDB performance trends
22465
+ description: Get read-only MariaDB performance trends from backend-owned metrics and database capability checks. The response does not expose SQL, PromQL, internal endpoints, or credentials.
22466
+ operationId: getDiagnosticsMariaDBPerformanceTrends
22237
22467
  parameters:
22238
22468
  - name: orgName
22239
22469
  in: path
22470
+ description: Organization name
22240
22471
  required: true
22241
22472
  schema:
22242
22473
  type: string
22243
22474
  - name: clusterName
22244
22475
  in: path
22476
+ description: Cluster name
22245
22477
  required: true
22246
22478
  schema:
22247
22479
  type: string
22248
- - name: sessionId
22249
- in: path
22250
- required: true
22480
+ - name: range
22481
+ in: query
22482
+ description: Controlled query range. Allowed values are 1h, 6h, 24h, and 7d. Defaults to 1h.
22483
+ required: false
22251
22484
  schema:
22252
- type: integer
22253
- format: int64
22254
- minimum: 1
22255
- maximum: 32767
22256
- - name: startedAt
22485
+ type: string
22486
+ - name: step
22257
22487
  in: query
22258
- required: true
22488
+ description: Controlled query granularity. Allowed values are 1m, 5m, 15m, and 1h.
22489
+ required: false
22259
22490
  schema:
22260
22491
  type: string
22261
22492
  responses:
@@ -22264,23 +22495,22 @@ paths:
22264
22495
  content:
22265
22496
  application/json:
22266
22497
  schema:
22267
- $ref: '#/components/schemas/mssqlSession'
22498
+ $ref: '#/components/schemas/performanceTrends'
22268
22499
  '400':
22269
22500
  $ref: '#/components/responses/400'
22270
22501
  '401':
22271
22502
  $ref: '#/components/responses/401'
22272
22503
  '403':
22273
22504
  $ref: '#/components/responses/403'
22274
- '404':
22275
- $ref: '#/components/responses/404'
22276
22505
  '500':
22277
22506
  $ref: '#/components/responses/500'
22278
- /admin/v1/organizations/{orgName}/clusters/{clusterName}/diagnostics/mssql/sessions/{sessionId}/lockAnalysis:
22507
+ /admin/v1/organizations/{orgName}/clusters/{clusterName}/diagnostics/mysql/spaceAnalysis:
22279
22508
  get:
22280
22509
  tags:
22281
22510
  - diagnostics
22282
- operationId: getDiagnosticsMssqlSessionLockAnalysis
22283
- summary: Get SQL Server blocking and locks
22511
+ summary: Get MySQL space analysis
22512
+ description: Get a read-only MySQL 5.7, 8.0, or 8.4 compatible space snapshot and fixed backend-owned storage metrics.
22513
+ operationId: getDiagnosticsMysqlSpaceAnalysis
22284
22514
  parameters:
22285
22515
  - name: orgName
22286
22516
  in: path
@@ -22292,17 +22522,147 @@ paths:
22292
22522
  required: true
22293
22523
  schema:
22294
22524
  type: string
22295
- - name: sessionId
22296
- in: path
22297
- required: true
22298
- schema:
22299
- type: integer
22300
- format: int64
22301
- minimum: 1
22302
- maximum: 32767
22303
- - name: startedAt
22525
+ - name: databaseName
22304
22526
  in: query
22305
- required: true
22527
+ description: Optional database name for table and index details. When omitted, the largest non-system database is selected.
22528
+ required: false
22529
+ schema:
22530
+ type: string
22531
+ responses:
22532
+ '200':
22533
+ description: OK
22534
+ content:
22535
+ application/json:
22536
+ schema:
22537
+ $ref: '#/components/schemas/mysqlSpaceAnalysis'
22538
+ '400':
22539
+ $ref: '#/components/responses/400'
22540
+ '401':
22541
+ $ref: '#/components/responses/401'
22542
+ '403':
22543
+ $ref: '#/components/responses/403'
22544
+ '404':
22545
+ $ref: '#/components/responses/404'
22546
+ '500':
22547
+ $ref: '#/components/responses/500'
22548
+ /admin/v1/organizations/{orgName}/clusters/{clusterName}/diagnostics/mssql/sessions:
22549
+ get:
22550
+ tags:
22551
+ - diagnostics
22552
+ operationId: listDiagnosticsMssqlSessions
22553
+ summary: List SQL Server sessions
22554
+ parameters:
22555
+ - name: orgName
22556
+ in: path
22557
+ required: true
22558
+ schema:
22559
+ type: string
22560
+ - name: clusterName
22561
+ in: path
22562
+ required: true
22563
+ schema:
22564
+ type: string
22565
+ - name: limit
22566
+ in: query
22567
+ required: false
22568
+ schema:
22569
+ type: integer
22570
+ format: int64
22571
+ minimum: 1
22572
+ maximum: 1000
22573
+ default: 500
22574
+ responses:
22575
+ '200':
22576
+ description: OK
22577
+ content:
22578
+ application/json:
22579
+ schema:
22580
+ $ref: '#/components/schemas/mssqlSessionSnapshot'
22581
+ '400':
22582
+ $ref: '#/components/responses/400'
22583
+ '401':
22584
+ $ref: '#/components/responses/401'
22585
+ '403':
22586
+ $ref: '#/components/responses/403'
22587
+ '404':
22588
+ $ref: '#/components/responses/404'
22589
+ '500':
22590
+ $ref: '#/components/responses/500'
22591
+ /admin/v1/organizations/{orgName}/clusters/{clusterName}/diagnostics/mssql/sessions/{sessionId}:
22592
+ get:
22593
+ tags:
22594
+ - diagnostics
22595
+ operationId: getDiagnosticsMssqlSession
22596
+ summary: Get a SQL Server session
22597
+ parameters:
22598
+ - name: orgName
22599
+ in: path
22600
+ required: true
22601
+ schema:
22602
+ type: string
22603
+ - name: clusterName
22604
+ in: path
22605
+ required: true
22606
+ schema:
22607
+ type: string
22608
+ - name: sessionId
22609
+ in: path
22610
+ required: true
22611
+ schema:
22612
+ type: integer
22613
+ format: int64
22614
+ minimum: 1
22615
+ maximum: 32767
22616
+ - name: startedAt
22617
+ in: query
22618
+ required: true
22619
+ schema:
22620
+ type: string
22621
+ responses:
22622
+ '200':
22623
+ description: OK
22624
+ content:
22625
+ application/json:
22626
+ schema:
22627
+ $ref: '#/components/schemas/mssqlSession'
22628
+ '400':
22629
+ $ref: '#/components/responses/400'
22630
+ '401':
22631
+ $ref: '#/components/responses/401'
22632
+ '403':
22633
+ $ref: '#/components/responses/403'
22634
+ '404':
22635
+ $ref: '#/components/responses/404'
22636
+ '500':
22637
+ $ref: '#/components/responses/500'
22638
+ /admin/v1/organizations/{orgName}/clusters/{clusterName}/diagnostics/mssql/sessions/{sessionId}/lockAnalysis:
22639
+ get:
22640
+ tags:
22641
+ - diagnostics
22642
+ operationId: getDiagnosticsMssqlSessionLockAnalysis
22643
+ summary: Get SQL Server blocking and locks
22644
+ parameters:
22645
+ - name: orgName
22646
+ in: path
22647
+ required: true
22648
+ schema:
22649
+ type: string
22650
+ - name: clusterName
22651
+ in: path
22652
+ required: true
22653
+ schema:
22654
+ type: string
22655
+ - name: sessionId
22656
+ in: path
22657
+ required: true
22658
+ schema:
22659
+ type: integer
22660
+ format: int64
22661
+ minimum: 1
22662
+ maximum: 32767
22663
+ - name: startedAt
22664
+ in: query
22665
+ required: true
22306
22666
  schema:
22307
22667
  type: string
22308
22668
  responses:
@@ -42452,6 +42812,163 @@ components:
42452
42812
  type: array
42453
42813
  items:
42454
42814
  $ref: '#/components/schemas/RbmqExchange'
42815
+ OracleTablespaceFile:
42816
+ type: object
42817
+ required:
42818
+ - id
42819
+ - name
42820
+ - status
42821
+ - allocatedSizeMB
42822
+ - usedSizeMB
42823
+ - autoExtend
42824
+ - nextSizeMB
42825
+ - maxSizeMB
42826
+ properties:
42827
+ id:
42828
+ type: integer
42829
+ format: int64
42830
+ name:
42831
+ type: string
42832
+ status:
42833
+ type: string
42834
+ allocatedSizeMB:
42835
+ type: number
42836
+ format: double
42837
+ usedSizeMB:
42838
+ type: number
42839
+ format: double
42840
+ autoExtend:
42841
+ type: boolean
42842
+ nextSizeMB:
42843
+ type: number
42844
+ format: double
42845
+ maxSizeMB:
42846
+ type: number
42847
+ format: double
42848
+ OracleTablespace:
42849
+ type: object
42850
+ description: Oracle tablespace in the datasource connection's current container. Sizes are in MiB. Supports Oracle 12c and 19c.
42851
+ required:
42852
+ - name
42853
+ - contents
42854
+ - status
42855
+ - bigfile
42856
+ - blockSize
42857
+ - containerName
42858
+ - isDefault
42859
+ - allocatedSizeMB
42860
+ - usedSizeMB
42861
+ - maxSizeMB
42862
+ - files
42863
+ properties:
42864
+ name:
42865
+ type: string
42866
+ contents:
42867
+ type: string
42868
+ description: PERMANENT, TEMPORARY, or UNDO.
42869
+ status:
42870
+ type: string
42871
+ bigfile:
42872
+ type: boolean
42873
+ blockSize:
42874
+ type: integer
42875
+ format: int64
42876
+ containerName:
42877
+ type: string
42878
+ isDefault:
42879
+ type: boolean
42880
+ description: Whether this is a default permanent or temporary tablespace, including default temporary group members.
42881
+ allocatedSizeMB:
42882
+ type: number
42883
+ format: double
42884
+ usedSizeMB:
42885
+ type: number
42886
+ format: double
42887
+ description: Allocated file space minus free extents, or temporary file space currently allocated to temporary segments.
42888
+ maxSizeMB:
42889
+ type: number
42890
+ format: double
42891
+ description: Configured file growth limit; does not imply available disk capacity.
42892
+ files:
42893
+ type: array
42894
+ items:
42895
+ $ref: '#/components/schemas/OracleTablespaceFile'
42896
+ OracleTablespaceContents:
42897
+ type: string
42898
+ enum:
42899
+ - PERMANENT
42900
+ - TEMPORARY
42901
+ description: New tablespaces default to PERMANENT when omitted.
42902
+ OracleTablespaceFileSpec:
42903
+ type: object
42904
+ required:
42905
+ - sizeMB
42906
+ properties:
42907
+ name:
42908
+ type: string
42909
+ description: Absolute database-server file path or ASM destination. Omit to use Oracle Managed Files (DB_CREATE_FILE_DEST must be configured). Existing files are never reused.
42910
+ maxLength: 1024
42911
+ sizeMB:
42912
+ type: integer
42913
+ format: int64
42914
+ minimum: 1
42915
+ autoExtend:
42916
+ type: boolean
42917
+ default: false
42918
+ nextSizeMB:
42919
+ type: integer
42920
+ format: int64
42921
+ minimum: 0
42922
+ description: Required positive increment when autoExtend is true; otherwise omit.
42923
+ maxSizeMB:
42924
+ type: integer
42925
+ format: int64
42926
+ minimum: 0
42927
+ description: Maximum size when autoExtend is true; zero or omitted means UNLIMITED. Otherwise omit.
42928
+ OracleTablespaceCreate:
42929
+ type: object
42930
+ required:
42931
+ - name
42932
+ - files
42933
+ properties:
42934
+ name:
42935
+ type: string
42936
+ pattern: ^[A-Za-z][A-Za-z0-9_$#]{0,29}$
42937
+ description: Converted to uppercase. Limited to 30 ASCII bytes for compatibility with Oracle 12.1.
42938
+ contents:
42939
+ $ref: '#/components/schemas/OracleTablespaceContents'
42940
+ bigfile:
42941
+ type: boolean
42942
+ default: false
42943
+ files:
42944
+ type: array
42945
+ minItems: 1
42946
+ description: Exactly one file for BIGFILE tablespaces.
42947
+ items:
42948
+ $ref: '#/components/schemas/OracleTablespaceFileSpec'
42949
+ OracleTablespaceExpandAction:
42950
+ type: string
42951
+ enum:
42952
+ - resize
42953
+ - addFile
42954
+ OracleTablespaceExpand:
42955
+ type: object
42956
+ description: One DDL operation per request. Use resize with fileId and sizeMB, or addFile with file. Shrinking and adding files to BIGFILE tablespaces are rejected.
42957
+ required:
42958
+ - action
42959
+ properties:
42960
+ action:
42961
+ $ref: '#/components/schemas/OracleTablespaceExpandAction'
42962
+ fileId:
42963
+ type: integer
42964
+ format: int64
42965
+ minimum: 1
42966
+ sizeMB:
42967
+ type: integer
42968
+ format: int64
42969
+ minimum: 1
42970
+ file:
42971
+ $ref: '#/components/schemas/OracleTablespaceFileSpec'
42455
42972
  DmFile:
42456
42973
  type: object
42457
42974
  required:
@@ -42970,21 +43487,362 @@ components:
42970
43487
  collectedAt:
42971
43488
  type: string
42972
43489
  description: Backend collection timestamp in UTC.
42973
- mssqlRequest:
43490
+ mysqlSQLFingerprint:
42974
43491
  type: object
42975
43492
  required:
42976
- - requestId
42977
- - startedAt
42978
- - status
42979
- - command
42980
- - database
42981
- - sql
42982
- - sqlTruncated
42983
- - elapsedMs
42984
- - cpuMs
42985
- - reads
42986
- - logicalReads
42987
- - writes
43493
+ - queryID
43494
+ - fingerprint
43495
+ - querySummary
43496
+ - calls
43497
+ - totalTimeMs
43498
+ - meanTimeMs
43499
+ - maxTimeMs
43500
+ - rows
43501
+ - rowsSent
43502
+ - rowsAffected
43503
+ - rowsExamined
43504
+ - lockTimeMs
43505
+ - errors
43506
+ - warnings
43507
+ - tmpTables
43508
+ - tmpDiskTables
43509
+ - noIndexUsed
43510
+ - noGoodIndexUsed
43511
+ - database
43512
+ properties:
43513
+ queryID:
43514
+ type: string
43515
+ description: MySQL Performance Schema DIGEST value.
43516
+ fingerprint:
43517
+ type: string
43518
+ description: Stable SQL fingerprint identifier. M1 uses DIGEST.
43519
+ querySummary:
43520
+ type: string
43521
+ description: Normalized DIGEST_TEXT. Raw SQL text is intentionally not returned.
43522
+ calls:
43523
+ type: integer
43524
+ format: int64
43525
+ description: Number of executions accumulated in the current digest row.
43526
+ totalTimeMs:
43527
+ type: number
43528
+ format: double
43529
+ description: Total statement wait time in milliseconds.
43530
+ meanTimeMs:
43531
+ type: number
43532
+ format: double
43533
+ description: Mean statement wait time in milliseconds.
43534
+ maxTimeMs:
43535
+ type: number
43536
+ format: double
43537
+ description: Maximum statement wait time in milliseconds.
43538
+ rows:
43539
+ type: integer
43540
+ format: int64
43541
+ description: Sum of rows sent and rows affected.
43542
+ rowsSent:
43543
+ type: integer
43544
+ format: int64
43545
+ description: Total rows sent to clients.
43546
+ rowsAffected:
43547
+ type: integer
43548
+ format: int64
43549
+ description: Total rows affected by statements.
43550
+ rowsExamined:
43551
+ type: integer
43552
+ format: int64
43553
+ description: Total rows examined by statements.
43554
+ lockTimeMs:
43555
+ type: number
43556
+ format: double
43557
+ description: Total statement lock time in milliseconds.
43558
+ errors:
43559
+ type: integer
43560
+ format: int64
43561
+ description: Total statement errors.
43562
+ warnings:
43563
+ type: integer
43564
+ format: int64
43565
+ description: Total statement warnings.
43566
+ tmpTables:
43567
+ type: integer
43568
+ format: int64
43569
+ description: Total internal temporary tables created.
43570
+ tmpDiskTables:
43571
+ type: integer
43572
+ format: int64
43573
+ description: Total internal on-disk temporary tables created.
43574
+ noIndexUsed:
43575
+ type: integer
43576
+ format: int64
43577
+ description: Executions that used no index.
43578
+ noGoodIndexUsed:
43579
+ type: integer
43580
+ format: int64
43581
+ description: Executions for which no good index was found.
43582
+ database:
43583
+ type: string
43584
+ description: Default schema name associated with the digest row.
43585
+ firstSeen:
43586
+ type: string
43587
+ description: UTC timestamp when the digest was first observed.
43588
+ lastSeen:
43589
+ type: string
43590
+ description: UTC timestamp when the digest was most recently observed.
43591
+ mysqlSQLAnalysis:
43592
+ type: object
43593
+ required:
43594
+ - source
43595
+ - status
43596
+ - collectedAt
43597
+ - limit
43598
+ - orderBy
43599
+ - items
43600
+ properties:
43601
+ source:
43602
+ type: string
43603
+ description: Data source. M1 uses performance_schema.events_statements_summary_by_digest.
43604
+ status:
43605
+ type: string
43606
+ description: Source status. Expected values are available or unavailable.
43607
+ unavailableReason:
43608
+ type: string
43609
+ description: Reason when status is unavailable, such as performance_schema_disabled, digest_consumer_disabled, permission_denied, or query_failed.
43610
+ message:
43611
+ type: string
43612
+ description: User-facing recovery guidance when SQL analysis is unavailable.
43613
+ collectedAt:
43614
+ type: string
43615
+ description: Backend collection timestamp in UTC. It is not a sampling-window end time.
43616
+ firstSeen:
43617
+ type: string
43618
+ description: Earliest FIRST_SEEN timestamp across currently visible digest rows, when available.
43619
+ lastSeen:
43620
+ type: string
43621
+ description: Latest LAST_SEEN timestamp across currently visible digest rows, when available.
43622
+ limit:
43623
+ type: integer
43624
+ format: int64
43625
+ description: Effective row limit after backend normalization.
43626
+ orderBy:
43627
+ type: string
43628
+ description: Effective sort key. Expected values are totalTime, meanTime, maxTime, or calls.
43629
+ totalTimeMsAll:
43630
+ type: number
43631
+ format: double
43632
+ x-nullable: true
43633
+ description: Total execution time in milliseconds across all visible digest rows, not limited to the returned top-N items.
43634
+ callsAll:
43635
+ type: integer
43636
+ format: int64
43637
+ x-nullable: true
43638
+ description: Total execution count across all visible digest rows, not limited to the returned top-N items.
43639
+ digestLost:
43640
+ type: integer
43641
+ format: int64
43642
+ x-nullable: true
43643
+ description: Number of statement digests not recorded because the digest table was full, when exposed by the server.
43644
+ items:
43645
+ type: array
43646
+ description: SQL fingerprint ranking rows from Performance Schema. The list may be empty when no statement statistics exist.
43647
+ items:
43648
+ $ref: '#/components/schemas/mysqlSQLFingerprint'
43649
+ performanceTrendRange:
43650
+ type: object
43651
+ required:
43652
+ - label
43653
+ - start
43654
+ - end
43655
+ - durationSeconds
43656
+ properties:
43657
+ label:
43658
+ type: string
43659
+ description: Controlled query range label. Values are 1h, 6h, 24h, or 7d.
43660
+ start:
43661
+ type: string
43662
+ end:
43663
+ type: string
43664
+ durationSeconds:
43665
+ type: integer
43666
+ format: int64
43667
+ performanceTrendSummary:
43668
+ type: object
43669
+ required:
43670
+ - metric
43671
+ - displayName
43672
+ - category
43673
+ - unit
43674
+ - min
43675
+ - max
43676
+ - avg
43677
+ - latest
43678
+ properties:
43679
+ metric:
43680
+ type: string
43681
+ displayName:
43682
+ $ref: '#/components/schemas/localizedDescription'
43683
+ category:
43684
+ type: string
43685
+ description: Metric category. Values include availability, performance, connections, resource, capacity, innodb, and vacuumWraparound.
43686
+ dimension:
43687
+ type: string
43688
+ description: Optional series dimension. Values include cluster, instance, pvc, and database.
43689
+ labels:
43690
+ type: object
43691
+ additionalProperties:
43692
+ type: string
43693
+ description: Optional dimension labels, for example instance, pvc, role, or datname.
43694
+ unit:
43695
+ type: string
43696
+ warnThreshold:
43697
+ type: number
43698
+ format: double
43699
+ description: Optional warning threshold in the same unit as this metric.
43700
+ critThreshold:
43701
+ type: number
43702
+ format: double
43703
+ description: Optional critical threshold in the same unit as this metric.
43704
+ thresholdDirection:
43705
+ type: string
43706
+ description: Optional threshold direction. Values are above, below, or boolean.
43707
+ min:
43708
+ type: number
43709
+ format: double
43710
+ max:
43711
+ type: number
43712
+ format: double
43713
+ avg:
43714
+ type: number
43715
+ format: double
43716
+ latest:
43717
+ type: number
43718
+ format: double
43719
+ changeDirection:
43720
+ type: string
43721
+ description: Change direction when at least two samples exist. Values are increasing, decreasing, or stable.
43722
+ performanceTrendPoint:
43723
+ type: object
43724
+ required:
43725
+ - timestamp
43726
+ - value
43727
+ properties:
43728
+ timestamp:
43729
+ type: string
43730
+ value:
43731
+ type: number
43732
+ format: double
43733
+ performanceTrendSeries:
43734
+ type: object
43735
+ required:
43736
+ - metric
43737
+ - displayName
43738
+ - category
43739
+ - unit
43740
+ - points
43741
+ properties:
43742
+ metric:
43743
+ type: string
43744
+ displayName:
43745
+ $ref: '#/components/schemas/localizedDescription'
43746
+ category:
43747
+ type: string
43748
+ description: Metric category. Values include availability, performance, connections, resource, capacity, innodb, and vacuumWraparound.
43749
+ dimension:
43750
+ type: string
43751
+ description: Optional series dimension. Values include cluster, instance, pvc, and database.
43752
+ labels:
43753
+ type: object
43754
+ additionalProperties:
43755
+ type: string
43756
+ description: Optional dimension labels, for example instance, pvc, role, or datname.
43757
+ unit:
43758
+ type: string
43759
+ warnThreshold:
43760
+ type: number
43761
+ format: double
43762
+ description: Optional warning threshold in the same unit as this metric.
43763
+ critThreshold:
43764
+ type: number
43765
+ format: double
43766
+ description: Optional critical threshold in the same unit as this metric.
43767
+ thresholdDirection:
43768
+ type: string
43769
+ description: Optional threshold direction. Values are above, below, or boolean.
43770
+ points:
43771
+ type: array
43772
+ items:
43773
+ $ref: '#/components/schemas/performanceTrendPoint'
43774
+ performanceTrendSource:
43775
+ type: object
43776
+ required:
43777
+ - name
43778
+ - kind
43779
+ - status
43780
+ - collectedAt
43781
+ properties:
43782
+ name:
43783
+ type: string
43784
+ kind:
43785
+ type: string
43786
+ status:
43787
+ type: string
43788
+ description: Coarse source status. Values are success, partial, failed, skipped, or noData.
43789
+ collectedAt:
43790
+ type: string
43791
+ message:
43792
+ type: string
43793
+ performanceTrends:
43794
+ type: object
43795
+ required:
43796
+ - range
43797
+ - granularity
43798
+ - summary
43799
+ - series
43800
+ - sources
43801
+ - warnings
43802
+ - collectedAt
43803
+ properties:
43804
+ range:
43805
+ $ref: '#/components/schemas/performanceTrendRange'
43806
+ granularity:
43807
+ type: string
43808
+ description: Controlled backend query step.
43809
+ summary:
43810
+ type: array
43811
+ description: Per-series numeric summary. changeDirection is present only when at least two points exist.
43812
+ items:
43813
+ $ref: '#/components/schemas/performanceTrendSummary'
43814
+ series:
43815
+ type: array
43816
+ description: Successfully collected and displayable metric series only. Unsupported, empty, or failed metrics are not represented as per-metric entries.
43817
+ items:
43818
+ $ref: '#/components/schemas/performanceTrendSeries'
43819
+ sources:
43820
+ type: array
43821
+ description: Coarse collection source status. Messages are sanitized and do not expose PromQL, endpoints, credentials, or raw internal errors.
43822
+ items:
43823
+ $ref: '#/components/schemas/performanceTrendSource'
43824
+ warnings:
43825
+ type: array
43826
+ items:
43827
+ type: string
43828
+ collectedAt:
43829
+ type: string
43830
+ description: Backend collection timestamp in UTC.
43831
+ mssqlRequest:
43832
+ type: object
43833
+ required:
43834
+ - requestId
43835
+ - startedAt
43836
+ - status
43837
+ - command
43838
+ - database
43839
+ - sql
43840
+ - sqlTruncated
43841
+ - elapsedMs
43842
+ - cpuMs
43843
+ - reads
43844
+ - logicalReads
43845
+ - writes
42988
43846
  - waitType
42989
43847
  - waitMs
42990
43848
  - waitResource
@@ -43565,214 +44423,17 @@ components:
43565
44423
  rows:
43566
44424
  type: integer
43567
44425
  format: int64
43568
- description: Rows returned or affected by the fingerprint, as reported by pg_stat_statements.
43569
- database:
43570
- type: string
43571
- description: Database name resolved from pg_stat_statements.dbid when visible.
43572
- user:
43573
- type: string
43574
- description: Database user name resolved from pg_stat_statements.userid when visible.
43575
- topLevel:
43576
- type: boolean
43577
- description: Whether pg_stat_statements recorded the statement as top-level. Legacy PostgreSQL versions without the toplevel column report true.
43578
- postgresqlSQLAnalysis:
43579
- type: object
43580
- required:
43581
- - source
43582
- - status
43583
- - collectedAt
43584
- - limit
43585
- - orderBy
43586
- - items
43587
- properties:
43588
- source:
43589
- type: string
43590
- description: Data source. M1 uses pg_stat_statements only.
43591
- status:
43592
- type: string
43593
- description: Source status. Expected values are available or unavailable.
43594
- unavailableReason:
43595
- type: string
43596
- description: Reason when status is unavailable, such as extension_disabled, permission_denied, or query_failed.
43597
- statsReset:
43598
- type: string
43599
- description: UTC timestamp reported by pg_stat_statements_info.stats_reset when available. Empty means the source did not expose this timestamp.
43600
- collectedAt:
43601
- type: string
43602
- description: Backend collection timestamp in UTC. It is not a sampling-window end time.
43603
- limit:
43604
- type: integer
43605
- format: int64
43606
- description: Effective row limit after backend normalization.
43607
- orderBy:
43608
- type: string
43609
- description: Effective sort key. Expected values are totalTime, meanTime, maxTime, or calls.
43610
- totalTimeMsAll:
43611
- type: number
43612
- format: double
43613
- x-nullable: true
43614
- description: Total execution time in milliseconds across all visible pg_stat_statements rows, not limited to the returned top-N items. Present only when the source is available.
43615
- callsAll:
43616
- type: integer
43617
- format: int64
43618
- x-nullable: true
43619
- description: Total execution count across all visible pg_stat_statements rows, not limited to the returned top-N items. Present only when the source is available.
43620
- items:
43621
- type: array
43622
- description: SQL fingerprint ranking rows from pg_stat_statements. The list may be empty when no statement statistics exist.
43623
- items:
43624
- $ref: '#/components/schemas/postgresqlSQLFingerprint'
43625
- postgresqlSQLFingerprintExplainResponse:
43626
- type: object
43627
- required:
43628
- - queryID
43629
- - fingerprint
43630
- - database
43631
- - user
43632
- - topLevel
43633
- - planMode
43634
- - parameterized
43635
- - explainResult
43636
- properties:
43637
- queryID:
43638
- type: string
43639
- description: PostgreSQL pg_stat_statements queryid represented as a string.
43640
- fingerprint:
43641
- type: string
43642
- description: Stable SQL fingerprint identifier for UI grouping. Currently aligned with PostgreSQL pg_stat_statements queryid.
43643
- database:
43644
- type: string
43645
- description: Database name from the requested SQL fingerprint identity.
43646
- user:
43647
- type: string
43648
- description: Database user from the requested SQL fingerprint identity.
43649
- topLevel:
43650
- type: boolean
43651
- description: Top-level flag from the requested SQL fingerprint identity.
43652
- statementSource:
43653
- type: string
43654
- description: Server-side source used to resolve the parameterized SQL statement. Raw SQL is not returned.
43655
- statementResolvedAt:
43656
- type: string
43657
- description: Timestamp when the parameterized SQL statement was resolved.
43658
- planMode:
43659
- $ref: '#/components/schemas/DmsExecutionPlanPlanningMode'
43660
- description: Whether DMS produced a standard estimated plan or a generic parameterized estimated plan.
43661
- parameterized:
43662
- type: boolean
43663
- description: Whether generic parameterized planning was used (planMode is generic). False means standard planning, not that historical parameter values were used. This endpoint never retrieves historical parameter values.
43664
- x-omitempty: false
43665
- parameterCount:
43666
- type: integer
43667
- format: int64
43668
- nullable: true
43669
- x-omitempty: true
43670
- description: Number of parameters when DMS can determine it. It may be omitted for PostgreSQL generic-plan paths that do not expose the count.
43671
- explainResult:
43672
- $ref: '#/components/schemas/DmsExecutionPlanResult'
43673
- description: Normalized DMS estimated visual plan. The resolved statement and generated EXPLAIN SQL are intentionally removed.
43674
- mysqlSQLFingerprint:
43675
- type: object
43676
- required:
43677
- - queryID
43678
- - fingerprint
43679
- - querySummary
43680
- - calls
43681
- - totalTimeMs
43682
- - meanTimeMs
43683
- - maxTimeMs
43684
- - rows
43685
- - rowsSent
43686
- - rowsAffected
43687
- - rowsExamined
43688
- - lockTimeMs
43689
- - errors
43690
- - warnings
43691
- - tmpTables
43692
- - tmpDiskTables
43693
- - noIndexUsed
43694
- - noGoodIndexUsed
43695
- - database
43696
- properties:
43697
- queryID:
43698
- type: string
43699
- description: MySQL Performance Schema DIGEST value.
43700
- fingerprint:
43701
- type: string
43702
- description: Stable SQL fingerprint identifier. M1 uses DIGEST.
43703
- querySummary:
43704
- type: string
43705
- description: Normalized DIGEST_TEXT. Raw SQL text is intentionally not returned.
43706
- calls:
43707
- type: integer
43708
- format: int64
43709
- description: Number of executions accumulated in the current digest row.
43710
- totalTimeMs:
43711
- type: number
43712
- format: double
43713
- description: Total statement wait time in milliseconds.
43714
- meanTimeMs:
43715
- type: number
43716
- format: double
43717
- description: Mean statement wait time in milliseconds.
43718
- maxTimeMs:
43719
- type: number
43720
- format: double
43721
- description: Maximum statement wait time in milliseconds.
43722
- rows:
43723
- type: integer
43724
- format: int64
43725
- description: Sum of rows sent and rows affected.
43726
- rowsSent:
43727
- type: integer
43728
- format: int64
43729
- description: Total rows sent to clients.
43730
- rowsAffected:
43731
- type: integer
43732
- format: int64
43733
- description: Total rows affected by statements.
43734
- rowsExamined:
43735
- type: integer
43736
- format: int64
43737
- description: Total rows examined by statements.
43738
- lockTimeMs:
43739
- type: number
43740
- format: double
43741
- description: Total statement lock time in milliseconds.
43742
- errors:
43743
- type: integer
43744
- format: int64
43745
- description: Total statement errors.
43746
- warnings:
43747
- type: integer
43748
- format: int64
43749
- description: Total statement warnings.
43750
- tmpTables:
43751
- type: integer
43752
- format: int64
43753
- description: Total internal temporary tables created.
43754
- tmpDiskTables:
43755
- type: integer
43756
- format: int64
43757
- description: Total internal on-disk temporary tables created.
43758
- noIndexUsed:
43759
- type: integer
43760
- format: int64
43761
- description: Executions that used no index.
43762
- noGoodIndexUsed:
43763
- type: integer
43764
- format: int64
43765
- description: Executions for which no good index was found.
44426
+ description: Rows returned or affected by the fingerprint, as reported by pg_stat_statements.
43766
44427
  database:
43767
44428
  type: string
43768
- description: Default schema name associated with the digest row.
43769
- firstSeen:
43770
- type: string
43771
- description: UTC timestamp when the digest was first observed.
43772
- lastSeen:
44429
+ description: Database name resolved from pg_stat_statements.dbid when visible.
44430
+ user:
43773
44431
  type: string
43774
- description: UTC timestamp when the digest was most recently observed.
43775
- mysqlSQLAnalysis:
44432
+ description: Database user name resolved from pg_stat_statements.userid when visible.
44433
+ topLevel:
44434
+ type: boolean
44435
+ description: Whether pg_stat_statements recorded the statement as top-level. Legacy PostgreSQL versions without the toplevel column report true.
44436
+ postgresqlSQLAnalysis:
43776
44437
  type: object
43777
44438
  required:
43778
44439
  - source
@@ -43784,25 +44445,19 @@ components:
43784
44445
  properties:
43785
44446
  source:
43786
44447
  type: string
43787
- description: Data source. M1 uses performance_schema.events_statements_summary_by_digest.
44448
+ description: Data source. M1 uses pg_stat_statements only.
43788
44449
  status:
43789
44450
  type: string
43790
44451
  description: Source status. Expected values are available or unavailable.
43791
44452
  unavailableReason:
43792
44453
  type: string
43793
- description: Reason when status is unavailable, such as performance_schema_disabled, digest_consumer_disabled, permission_denied, or query_failed.
43794
- message:
44454
+ description: Reason when status is unavailable, such as extension_disabled, permission_denied, or query_failed.
44455
+ statsReset:
43795
44456
  type: string
43796
- description: User-facing recovery guidance when SQL analysis is unavailable.
44457
+ description: UTC timestamp reported by pg_stat_statements_info.stats_reset when available. Empty means the source did not expose this timestamp.
43797
44458
  collectedAt:
43798
44459
  type: string
43799
44460
  description: Backend collection timestamp in UTC. It is not a sampling-window end time.
43800
- firstSeen:
43801
- type: string
43802
- description: Earliest FIRST_SEEN timestamp across currently visible digest rows, when available.
43803
- lastSeen:
43804
- type: string
43805
- description: Latest LAST_SEEN timestamp across currently visible digest rows, when available.
43806
44461
  limit:
43807
44462
  type: integer
43808
44463
  format: int64
@@ -43814,204 +44469,66 @@ components:
43814
44469
  type: number
43815
44470
  format: double
43816
44471
  x-nullable: true
43817
- description: Total execution time in milliseconds across all visible digest rows, not limited to the returned top-N items.
44472
+ description: Total execution time in milliseconds across all visible pg_stat_statements rows, not limited to the returned top-N items. Present only when the source is available.
43818
44473
  callsAll:
43819
44474
  type: integer
43820
44475
  format: int64
43821
44476
  x-nullable: true
43822
- description: Total execution count across all visible digest rows, not limited to the returned top-N items.
43823
- digestLost:
43824
- type: integer
43825
- format: int64
43826
- x-nullable: true
43827
- description: Number of statement digests not recorded because the digest table was full, when exposed by the server.
44477
+ description: Total execution count across all visible pg_stat_statements rows, not limited to the returned top-N items. Present only when the source is available.
43828
44478
  items:
43829
44479
  type: array
43830
- description: SQL fingerprint ranking rows from Performance Schema. The list may be empty when no statement statistics exist.
43831
- items:
43832
- $ref: '#/components/schemas/mysqlSQLFingerprint'
43833
- performanceTrendRange:
43834
- type: object
43835
- required:
43836
- - label
43837
- - start
43838
- - end
43839
- - durationSeconds
43840
- properties:
43841
- label:
43842
- type: string
43843
- description: Controlled query range label. Values are 1h, 6h, 24h, or 7d.
43844
- start:
43845
- type: string
43846
- end:
43847
- type: string
43848
- durationSeconds:
43849
- type: integer
43850
- format: int64
43851
- performanceTrendSummary:
43852
- type: object
43853
- required:
43854
- - metric
43855
- - displayName
43856
- - category
43857
- - unit
43858
- - min
43859
- - max
43860
- - avg
43861
- - latest
43862
- properties:
43863
- metric:
43864
- type: string
43865
- displayName:
43866
- $ref: '#/components/schemas/localizedDescription'
43867
- category:
43868
- type: string
43869
- description: Metric category. Values include availability, performance, connections, resource, capacity, innodb, and vacuumWraparound.
43870
- dimension:
43871
- type: string
43872
- description: Optional series dimension. Values include cluster, instance, pvc, and database.
43873
- labels:
43874
- type: object
43875
- additionalProperties:
43876
- type: string
43877
- description: Optional dimension labels, for example instance, pvc, role, or datname.
43878
- unit:
43879
- type: string
43880
- warnThreshold:
43881
- type: number
43882
- format: double
43883
- description: Optional warning threshold in the same unit as this metric.
43884
- critThreshold:
43885
- type: number
43886
- format: double
43887
- description: Optional critical threshold in the same unit as this metric.
43888
- thresholdDirection:
43889
- type: string
43890
- description: Optional threshold direction. Values are above, below, or boolean.
43891
- min:
43892
- type: number
43893
- format: double
43894
- max:
43895
- type: number
43896
- format: double
43897
- avg:
43898
- type: number
43899
- format: double
43900
- latest:
43901
- type: number
43902
- format: double
43903
- changeDirection:
43904
- type: string
43905
- description: Change direction when at least two samples exist. Values are increasing, decreasing, or stable.
43906
- performanceTrendPoint:
43907
- type: object
43908
- required:
43909
- - timestamp
43910
- - value
43911
- properties:
43912
- timestamp:
43913
- type: string
43914
- value:
43915
- type: number
43916
- format: double
43917
- performanceTrendSeries:
43918
- type: object
43919
- required:
43920
- - metric
43921
- - displayName
43922
- - category
43923
- - unit
43924
- - points
43925
- properties:
43926
- metric:
43927
- type: string
43928
- displayName:
43929
- $ref: '#/components/schemas/localizedDescription'
43930
- category:
43931
- type: string
43932
- description: Metric category. Values include availability, performance, connections, resource, capacity, innodb, and vacuumWraparound.
43933
- dimension:
43934
- type: string
43935
- description: Optional series dimension. Values include cluster, instance, pvc, and database.
43936
- labels:
43937
- type: object
43938
- additionalProperties:
43939
- type: string
43940
- description: Optional dimension labels, for example instance, pvc, role, or datname.
43941
- unit:
43942
- type: string
43943
- warnThreshold:
43944
- type: number
43945
- format: double
43946
- description: Optional warning threshold in the same unit as this metric.
43947
- critThreshold:
43948
- type: number
43949
- format: double
43950
- description: Optional critical threshold in the same unit as this metric.
43951
- thresholdDirection:
43952
- type: string
43953
- description: Optional threshold direction. Values are above, below, or boolean.
43954
- points:
43955
- type: array
44480
+ description: SQL fingerprint ranking rows from pg_stat_statements. The list may be empty when no statement statistics exist.
43956
44481
  items:
43957
- $ref: '#/components/schemas/performanceTrendPoint'
43958
- performanceTrendSource:
44482
+ $ref: '#/components/schemas/postgresqlSQLFingerprint'
44483
+ postgresqlSQLFingerprintExplainResponse:
43959
44484
  type: object
43960
44485
  required:
43961
- - name
43962
- - kind
43963
- - status
43964
- - collectedAt
44486
+ - queryID
44487
+ - fingerprint
44488
+ - database
44489
+ - user
44490
+ - topLevel
44491
+ - planMode
44492
+ - parameterized
44493
+ - explainResult
43965
44494
  properties:
43966
- name:
43967
- type: string
43968
- kind:
44495
+ queryID:
43969
44496
  type: string
43970
- status:
44497
+ description: PostgreSQL pg_stat_statements queryid represented as a string.
44498
+ fingerprint:
43971
44499
  type: string
43972
- description: Coarse source status. Values are success, partial, failed, skipped, or noData.
43973
- collectedAt:
44500
+ description: Stable SQL fingerprint identifier for UI grouping. Currently aligned with PostgreSQL pg_stat_statements queryid.
44501
+ database:
43974
44502
  type: string
43975
- message:
44503
+ description: Database name from the requested SQL fingerprint identity.
44504
+ user:
43976
44505
  type: string
43977
- performanceTrends:
43978
- type: object
43979
- required:
43980
- - range
43981
- - granularity
43982
- - summary
43983
- - series
43984
- - sources
43985
- - warnings
43986
- - collectedAt
43987
- properties:
43988
- range:
43989
- $ref: '#/components/schemas/performanceTrendRange'
43990
- granularity:
44506
+ description: Database user from the requested SQL fingerprint identity.
44507
+ topLevel:
44508
+ type: boolean
44509
+ description: Top-level flag from the requested SQL fingerprint identity.
44510
+ statementSource:
43991
44511
  type: string
43992
- description: Controlled backend query step.
43993
- summary:
43994
- type: array
43995
- description: Per-series numeric summary. changeDirection is present only when at least two points exist.
43996
- items:
43997
- $ref: '#/components/schemas/performanceTrendSummary'
43998
- series:
43999
- type: array
44000
- description: Successfully collected and displayable metric series only. Unsupported, empty, or failed metrics are not represented as per-metric entries.
44001
- items:
44002
- $ref: '#/components/schemas/performanceTrendSeries'
44003
- sources:
44004
- type: array
44005
- description: Coarse collection source status. Messages are sanitized and do not expose PromQL, endpoints, credentials, or raw internal errors.
44006
- items:
44007
- $ref: '#/components/schemas/performanceTrendSource'
44008
- warnings:
44009
- type: array
44010
- items:
44011
- type: string
44012
- collectedAt:
44512
+ description: Server-side source used to resolve the parameterized SQL statement. Raw SQL is not returned.
44513
+ statementResolvedAt:
44013
44514
  type: string
44014
- description: Backend collection timestamp in UTC.
44515
+ description: Timestamp when the parameterized SQL statement was resolved.
44516
+ planMode:
44517
+ $ref: '#/components/schemas/DmsExecutionPlanPlanningMode'
44518
+ description: Whether DMS produced a standard estimated plan or a generic parameterized estimated plan.
44519
+ parameterized:
44520
+ type: boolean
44521
+ description: Whether generic parameterized planning was used (planMode is generic). False means standard planning, not that historical parameter values were used. This endpoint never retrieves historical parameter values.
44522
+ x-omitempty: false
44523
+ parameterCount:
44524
+ type: integer
44525
+ format: int64
44526
+ nullable: true
44527
+ x-omitempty: true
44528
+ description: Number of parameters when DMS can determine it. It may be omitted for PostgreSQL generic-plan paths that do not expose the count.
44529
+ explainResult:
44530
+ $ref: '#/components/schemas/DmsExecutionPlanResult'
44531
+ description: Normalized DMS estimated visual plan. The resolved statement and generated EXPLAIN SQL are intentionally removed.
44015
44532
  elasticsearchHotThreadsType:
44016
44533
  type: string
44017
44534
  enum: