kb-cloud-client-typescript 2.3.21 → 2.3.23

package/src/openapi.yaml

@@ -5127,6 +5127,144 @@ paths:
         - cluster
         - shared
       x-codegen-request-body-name: body
+  /api/v1/organizations/{orgName}/clusters/{clusterName}/diagnostics/mariadb/spaceAnalysis:
+    get:
+      tags:
+        - diagnostics
+      summary: Get MariaDB space analysis
+      description: Get a read-only MariaDB compatible space snapshot and fixed backend-owned storage metrics.
+      operationId: getDiagnosticsMariaDBSpaceAnalysis
+      parameters:
+        - name: orgName
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: clusterName
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: databaseName
+          in: query
+          description: Optional database name for table and index details. When omitted, the largest non-system database is selected.
+          required: false
+          schema:
+            type: string
+      responses:
+        '200':
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/mysqlSpaceAnalysis'
+        '400':
+          $ref: '#/components/responses/400'
+        '401':
+          $ref: '#/components/responses/401'
+        '403':
+          $ref: '#/components/responses/403'
+        '404':
+          $ref: '#/components/responses/404'
+        '500':
+          $ref: '#/components/responses/500'
+  /api/v1/organizations/{orgName}/clusters/{clusterName}/diagnostics/mariadb/sqlAnalysis:
+    get:
+      tags:
+        - diagnostics
+      summary: Get MariaDB SQL analysis
+      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.
+      operationId: getDiagnosticsMariaDBSQLAnalysis
+      parameters:
+        - name: orgName
+          in: path
+          description: Organization name
+          required: true
+          schema:
+            type: string
+        - name: clusterName
+          in: path
+          description: Cluster name
+          required: true
+          schema:
+            type: string
+        - name: limit
+          in: query
+          description: Maximum number of SQL fingerprints to return. The backend applies its own upper bound.
+          required: false
+          schema:
+            type: integer
+            format: int64
+        - name: orderBy
+          in: query
+          description: Sort key. Allowed values are totalTime, meanTime, maxTime, and calls. Defaults to totalTime.
+          required: false
+          schema:
+            type: string
+      responses:
+        '200':
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/mysqlSQLAnalysis'
+        '400':
+          $ref: '#/components/responses/400'
+        '401':
+          $ref: '#/components/responses/401'
+        '403':
+          $ref: '#/components/responses/403'
+        '404':
+          $ref: '#/components/responses/404'
+        '500':
+          $ref: '#/components/responses/500'
+  /api/v1/organizations/{orgName}/clusters/{clusterName}/diagnostics/mariadb/performanceTrends:
+    get:
+      tags:
+        - diagnostics
+      summary: Get MariaDB performance trends
+      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.
+      operationId: getDiagnosticsMariaDBPerformanceTrends
+      parameters:
+        - name: orgName
+          in: path
+          description: Organization name
+          required: true
+          schema:
+            type: string
+        - name: clusterName
+          in: path
+          description: Cluster name
+          required: true
+          schema:
+            type: string
+        - name: range
+          in: query
+          description: Controlled query range. Allowed values are 1h, 6h, 24h, and 7d. Defaults to 1h.
+          required: false
+          schema:
+            type: string
+        - name: step
+          in: query
+          description: Controlled query granularity. Allowed values are 1m, 5m, 15m, and 1h.
+          required: false
+          schema:
+            type: string
+      responses:
+        '200':
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/performanceTrends'
+        '400':
+          $ref: '#/components/responses/400'
+        '401':
+          $ref: '#/components/responses/401'
+        '403':
+          $ref: '#/components/responses/403'
+        '500':
+          $ref: '#/components/responses/500'
   /api/v1/organizations/{orgName}/clusters/{clusterName}/diagnostics/mysql/spaceAnalysis:
     get:
       tags:
@@ -26294,500 +26432,841 @@ components:
         collectedAt:
           type: string
           description: Backend collection timestamp in UTC.
-    mssqlRequest:
+    mysqlSQLFingerprint:
       type: object
       required:
-        - requestId
-        - startedAt
-        - status
-        - command
+        - queryID
+        - fingerprint
+        - querySummary
+        - calls
+        - totalTimeMs
+        - meanTimeMs
+        - maxTimeMs
+        - rows
+        - rowsSent
+        - rowsAffected
+        - rowsExamined
+        - lockTimeMs
+        - errors
+        - warnings
+        - tmpTables
+        - tmpDiskTables
+        - noIndexUsed
+        - noGoodIndexUsed
         - database
-        - sql
-        - sqlTruncated
-        - elapsedMs
-        - cpuMs
-        - reads
-        - logicalReads
-        - writes
-        - waitType
-        - waitMs
-        - waitResource
-        - blockingSessionId
       properties:
-        requestId:
-          type: integer
-          format: int64
-        startedAt:
-          type: string
-          description: Opaque SQL Server local start time, used to detect session or request reuse. Pass back unchanged; it is not a UTC timestamp.
-        status:
-          type: string
-        command:
+        queryID:
           type: string
-        database:
+          description: MySQL Performance Schema DIGEST value.
+        fingerprint:
           type: string
-        sql:
+          description: Stable SQL fingerprint identifier. M1 uses DIGEST.
+        querySummary:
           type: string
-          description: Current statement extracted with byte offsets. Truncated to 8192 characters.
-        sqlTruncated:
-          type: boolean
-        elapsedMs:
+          description: Normalized DIGEST_TEXT. Raw SQL text is intentionally not returned.
+        calls:
           type: integer
           format: int64
-        cpuMs:
+          description: Number of executions accumulated in the current digest row.
+        totalTimeMs:
+          type: number
+          format: double
+          description: Total statement wait time in milliseconds.
+        meanTimeMs:
+          type: number
+          format: double
+          description: Mean statement wait time in milliseconds.
+        maxTimeMs:
+          type: number
+          format: double
+          description: Maximum statement wait time in milliseconds.
+        rows:
           type: integer
           format: int64
-        reads:
+          description: Sum of rows sent and rows affected.
+        rowsSent:
           type: integer
           format: int64
-        logicalReads:
+          description: Total rows sent to clients.
+        rowsAffected:
           type: integer
           format: int64
-        writes:
+          description: Total rows affected by statements.
+        rowsExamined:
           type: integer
           format: int64
-        waitType:
-          type: string
-        waitMs:
+          description: Total rows examined by statements.
+        lockTimeMs:
+          type: number
+          format: double
+          description: Total statement lock time in milliseconds.
+        errors:
           type: integer
           format: int64
-        waitResource:
-          type: string
-        blockingSessionId:
+          description: Total statement errors.
+        warnings:
           type: integer
           format: int64
-    mssqlSession:
+          description: Total statement warnings.
+        tmpTables:
+          type: integer
+          format: int64
+          description: Total internal temporary tables created.
+        tmpDiskTables:
+          type: integer
+          format: int64
+          description: Total internal on-disk temporary tables created.
+        noIndexUsed:
+          type: integer
+          format: int64
+          description: Executions that used no index.
+        noGoodIndexUsed:
+          type: integer
+          format: int64
+          description: Executions for which no good index was found.
+        database:
+          type: string
+          description: Default schema name associated with the digest row.
+        firstSeen:
+          type: string
+          description: UTC timestamp when the digest was first observed.
+        lastSeen:
+          type: string
+          description: UTC timestamp when the digest was most recently observed.
+    mysqlSQLAnalysis:
       type: object
       required:
-        - sessionId
-        - startedAt
+        - source
         - status
-        - user
-        - host
-        - application
-        - client
-        - database
-        - openTransactions
-        - transactionSeconds
-        - lastSql
-        - lastSqlTruncated
-        - requests
-        - requestsTruncated
+        - collectedAt
+        - limit
+        - orderBy
+        - items
       properties:
-        sessionId:
-          type: integer
-          format: int64
-        startedAt:
+        source:
           type: string
-          description: Opaque SQL Server local start time, used to detect session or request reuse. Pass back unchanged; it is not a UTC timestamp.
+          description: Data source. M1 uses performance_schema.events_statements_summary_by_digest.
         status:
           type: string
-        user:
+          description: Source status. Expected values are available or unavailable.
+        unavailableReason:
           type: string
-        host:
+          description: Reason when status is unavailable, such as performance_schema_disabled, digest_consumer_disabled, permission_denied, or query_failed.
+        message:
           type: string
-        application:
+          description: User-facing recovery guidance when SQL analysis is unavailable.
+        collectedAt:
           type: string
-        client:
+          description: Backend collection timestamp in UTC. It is not a sampling-window end time.
+        firstSeen:
           type: string
-        database:
+          description: Earliest FIRST_SEEN timestamp across currently visible digest rows, when available.
+        lastSeen:
           type: string
-        openTransactions:
+          description: Latest LAST_SEEN timestamp across currently visible digest rows, when available.
+        limit:
           type: integer
           format: int64
-        transactionSeconds:
+          description: Effective row limit after backend normalization.
+        orderBy:
+          type: string
+          description: Effective sort key. Expected values are totalTime, meanTime, maxTime, or calls.
+        totalTimeMsAll:
+          type: number
+          format: double
+          x-nullable: true
+          description: Total execution time in milliseconds across all visible digest rows, not limited to the returned top-N items.
+        callsAll:
           type: integer
           format: int64
-        lastSql:
-          type: string
-          description: Most recent batch on the connection, not necessarily the SQL that acquired its locks. Truncated to 8192 characters.
-        lastSqlTruncated:
-          type: boolean
-        requests:
+          x-nullable: true
+          description: Total execution count across all visible digest rows, not limited to the returned top-N items.
+        digestLost:
+          type: integer
+          format: int64
+          x-nullable: true
+          description: Number of statement digests not recorded because the digest table was full, when exposed by the server.
+        items:
           type: array
+          description: SQL fingerprint ranking rows from Performance Schema. The list may be empty when no statement statistics exist.
           items:
-            $ref: '#/components/schemas/mssqlRequest'
-        requestsTruncated:
-          type: boolean
-    mssqlSessionSnapshot:
+            $ref: '#/components/schemas/mysqlSQLFingerprint'
+    performanceTrendRange:
       type: object
       required:
-        - capturedAt
-        - sessions
-        - truncated
+        - label
+        - start
+        - end
+        - durationSeconds
       properties:
-        capturedAt:
+        label:
           type: string
-        sessions:
-          type: array
-          items:
-            $ref: '#/components/schemas/mssqlSession'
-        truncated:
-          type: boolean
-    mssqlWait:
-      type: object
-      required:
-        - sessionId
-        - requestId
-        - blockingSessionId
-        - waitType
-        - waitMs
-        - resource
-        - source
-      properties:
-        sessionId:
-          type: integer
-          format: int64
-        requestId:
-          type: integer
-          format: int64
-          description: Request ID, or -1 when a waiting task cannot be associated with a live request.
-        blockingSessionId:
-          type: integer
-          format: int64
-          description: SQL Server blocking owner. Negative values are special owners, not session IDs.
-        waitType:
+          description: Controlled query range label. Values are 1h, 6h, 24h, or 7d.
+        start:
           type: string
-        waitMs:
+        end:
+          type: string
+        durationSeconds:
           type: integer
           format: int64
-        resource:
-          type: string
-        source:
-          type: string
-    mssqlLock:
+    performanceTrendSummary:
       type: object
       required:
-        - sessionId
-        - requestId
-        - database
-        - resourceType
-        - resource
-        - entityId
-        - mode
-        - status
-        - ownerType
+        - metric
+        - displayName
+        - category
+        - unit
+        - min
+        - max
+        - avg
+        - latest
       properties:
-        sessionId:
-          type: integer
-          format: int64
-        requestId:
-          type: integer
-          format: int64
-        database:
-          type: string
-        resourceType:
+        metric:
           type: string
-        resource:
+        displayName:
+          $ref: '#/components/schemas/localizedDescription'
+        category:
           type: string
-        entityId:
+          description: Metric category. Values include availability, performance, connections, resource, capacity, innodb, and vacuumWraparound.
+        dimension:
           type: string
-        mode:
+          description: Optional series dimension. Values include cluster, instance, pvc, and database.
+        labels:
+          type: object
+          additionalProperties:
+            type: string
+          description: Optional dimension labels, for example instance, pvc, role, or datname.
+        unit:
           type: string
-        status:
+        warnThreshold:
+          type: number
+          format: double
+          description: Optional warning threshold in the same unit as this metric.
+        critThreshold:
+          type: number
+          format: double
+          description: Optional critical threshold in the same unit as this metric.
+        thresholdDirection:
           type: string
-        ownerType:
+          description: Optional threshold direction. Values are above, below, or boolean.
+        min:
+          type: number
+          format: double
+        max:
+          type: number
+          format: double
+        avg:
+          type: number
+          format: double
+        latest:
+          type: number
+          format: double
+        changeDirection:
           type: string
-    mssqlLockSnapshot:
+          description: Change direction when at least two samples exist. Values are increasing, decreasing, or stable.
+    performanceTrendPoint:
       type: object
       required:
-        - capturedAt
-        - sessions
-        - waits
-        - locks
-        - truncated
+        - timestamp
+        - value
       properties:
-        capturedAt:
+        timestamp:
           type: string
-        sessions:
-          type: array
-          items:
-            $ref: '#/components/schemas/mssqlSession'
-        waits:
-          type: array
-          items:
-            $ref: '#/components/schemas/mssqlWait'
-        locks:
-          type: array
-          items:
-            $ref: '#/components/schemas/mssqlLock'
-        truncated:
-          type: boolean
-      description: Bounded live DMV observations. Edges are SQL Server reported blocking identifiers. Collection is not atomic; graph cycles are not historical deadlock evidence.
-    mssqlCachedPlan:
+        value:
+          type: number
+          format: double
+    performanceTrendSeries:
       type: object
       required:
-        - capturedAt
-        - xml
-        - available
+        - metric
+        - displayName
+        - category
+        - unit
+        - points
       properties:
-        capturedAt:
+        metric:
           type: string
-        xml:
+        displayName:
+          $ref: '#/components/schemas/localizedDescription'
+        category:
           type: string
-        available:
-          type: boolean
-      description: Cached compiled plan for the selected live request. No captured SQL is executed. This is not an actual runtime plan.
-    postgresqlSession:
-      type: object
-      required:
-        - pid
-        - user
-        - database
-        - applicationName
-        - clientAddr
-        - clientPort
-        - state
-        - waitEventType
-        - waitEvent
-        - durationSeconds
-        - xactDurationSeconds
-        - queryDigest
-        - querySummary
-        - backendType
-      properties:
-        pid:
-          type: integer
-          format: int64
-        user:
-          type: string
-        database:
+          description: Metric category. Values include availability, performance, connections, resource, capacity, innodb, and vacuumWraparound.
+        dimension:
           type: string
-        applicationName:
+          description: Optional series dimension. Values include cluster, instance, pvc, and database.
+        labels:
+          type: object
+          additionalProperties:
+            type: string
+          description: Optional dimension labels, for example instance, pvc, role, or datname.
+        unit:
           type: string
-        clientAddr:
+        warnThreshold:
+          type: number
+          format: double
+          description: Optional warning threshold in the same unit as this metric.
+        critThreshold:
+          type: number
+          format: double
+          description: Optional critical threshold in the same unit as this metric.
+        thresholdDirection:
           type: string
-          description: Client address.
-        clientPort:
+          description: Optional threshold direction. Values are above, below, or boolean.
+        points:
+          type: array
+          items:
+            $ref: '#/components/schemas/performanceTrendPoint'
+    performanceTrendSource:
+      type: object
+      required:
+        - name
+        - kind
+        - status
+        - collectedAt
+      properties:
+        name:
           type: string
-          description: Client port.
-        state:
+        kind:
           type: string
-        waitEventType:
+        status:
           type: string
-        waitEvent:
+          description: Coarse source status. Values are success, partial, failed, skipped, or noData.
+        collectedAt:
           type: string
-        backendStart:
+        message:
           type: string
-          description: Backend start timestamp if available.
-        queryStart:
+    performanceTrends:
+      type: object
+      required:
+        - range
+        - granularity
+        - summary
+        - series
+        - sources
+        - warnings
+        - collectedAt
+      properties:
+        range:
+          $ref: '#/components/schemas/performanceTrendRange'
+        granularity:
           type: string
-          description: Query start timestamp if available.
-        xactStart:
+          description: Controlled backend query step.
+        summary:
+          type: array
+          description: Per-series numeric summary. changeDirection is present only when at least two points exist.
+          items:
+            $ref: '#/components/schemas/performanceTrendSummary'
+        series:
+          type: array
+          description: Successfully collected and displayable metric series only. Unsupported, empty, or failed metrics are not represented as per-metric entries.
+          items:
+            $ref: '#/components/schemas/performanceTrendSeries'
+        sources:
+          type: array
+          description: Coarse collection source status. Messages are sanitized and do not expose PromQL, endpoints, credentials, or raw internal errors.
+          items:
+            $ref: '#/components/schemas/performanceTrendSource'
+        warnings:
+          type: array
+          items:
+            type: string
+        collectedAt:
           type: string
-          description: Transaction start timestamp if available.
-        durationSeconds:
-          type: integer
-          format: int64
-        xactDurationSeconds:
+          description: Backend collection timestamp in UTC.
+    mssqlRequest:
+      type: object
+      required:
+        - requestId
+        - startedAt
+        - status
+        - command
+        - database
+        - sql
+        - sqlTruncated
+        - elapsedMs
+        - cpuMs
+        - reads
+        - logicalReads
+        - writes
+        - waitType
+        - waitMs
+        - waitResource
+        - blockingSessionId
+      properties:
+        requestId:
           type: integer
           format: int64
-        queryDigest:
+        startedAt:
           type: string
-        querySummary:
+          description: Opaque SQL Server local start time, used to detect session or request reuse. Pass back unchanged; it is not a UTC timestamp.
+        status:
           type: string
-        backendType:
+        command:
           type: string
-    postgresqlSessionList:
-      type: array
-      items:
-        $ref: '#/components/schemas/postgresqlSession'
-    postgresqlSpaceSummary:
-      type: object
-      required:
-        - tableCount
-        - indexCount
-        - toastRelationCount
-        - tableListTruncated
-        - indexListTruncated
-      properties:
-        databaseName:
+        database:
           type: string
-        databaseSizeBytes:
+        sql:
+          type: string
+          description: Current statement extracted with byte offsets. Truncated to 8192 characters.
+        sqlTruncated:
+          type: boolean
+        elapsedMs:
           type: integer
           format: int64
-        tableCount:
+        cpuMs:
           type: integer
           format: int64
-        indexCount:
+        reads:
           type: integer
           format: int64
-        toastRelationCount:
+        logicalReads:
           type: integer
           format: int64
-        largestTableBytes:
+        writes:
           type: integer
           format: int64
-        largestIndexBytes:
+        waitType:
+          type: string
+        waitMs:
           type: integer
           format: int64
-        tableListTruncated:
-          type: boolean
-        indexListTruncated:
-          type: boolean
-    postgresqlStorageInstanceUsage:
+        waitResource:
+          type: string
+        blockingSessionId:
+          type: integer
+          format: int64
+    mssqlSession:
       type: object
+      required:
+        - sessionId
+        - startedAt
+        - status
+        - user
+        - host
+        - application
+        - client
+        - database
+        - openTransactions
+        - transactionSeconds
+        - lastSql
+        - lastSqlTruncated
+        - requests
+        - requestsTruncated
       properties:
-        instanceName:
+        sessionId:
+          type: integer
+          format: int64
+        startedAt:
           type: string
-          description: Kubernetes pod name for this PostgreSQL replica storage sample.
-        pvcName:
+          description: Opaque SQL Server local start time, used to detect session or request reuse. Pass back unchanged; it is not a UTC timestamp.
+        status:
           type: string
-          description: PersistentVolumeClaim name when it can be read from metrics labels.
-        role:
+        user:
           type: string
-          description: Raw PostgreSQL replica role value read from metrics labels, kept aligned with instance detail display.
-        componentName:
+        host:
           type: string
-          description: Optional KubeBlocks component name when it can be read from metrics labels.
-        totalBytes:
-          type: integer
-          format: int64
-          description: Physical PVC capacity in bytes for this replica storage sample.
-        usedBytes:
+        application:
+          type: string
+        client:
+          type: string
+        database:
+          type: string
+        openTransactions:
           type: integer
           format: int64
-          description: Physical PVC used bytes for this replica storage sample.
-        availableBytes:
+        transactionSeconds:
           type: integer
           format: int64
-          description: Available bytes derived from totalBytes - usedBytes when both values are available.
-        usageRatio:
-          type: number
-          format: double
-          nullable: true
-          description: usedBytes / totalBytes for this replica storage sample when both values are available.
-        updatedAt:
-          type: string
-          description: Metrics collection timestamp in UTC.
-        source:
+        lastSql:
           type: string
-    postgresqlStorageOverview:
+          description: Most recent batch on the connection, not necessarily the SQL that acquired its locks. Truncated to 8192 characters.
+        lastSqlTruncated:
+          type: boolean
+        requests:
+          type: array
+          items:
+            $ref: '#/components/schemas/mssqlRequest'
+        requestsTruncated:
+          type: boolean
+    mssqlSessionSnapshot:
       type: object
       required:
-        - source
-        - instances
+        - capturedAt
+        - sessions
+        - truncated
       properties:
-        source:
+        capturedAt:
           type: string
-        instances:
+        sessions:
           type: array
-          description: Physical PostgreSQL replica storage usage split by pod/PVC/role.
           items:
-            $ref: '#/components/schemas/postgresqlStorageInstanceUsage'
-    postgresqlDatabaseSpace:
-      type: object
-      properties:
-        name:
-          type: string
-        sizeBytes:
-          type: integer
-          format: int64
-    postgresqlTableSpace:
+            $ref: '#/components/schemas/mssqlSession'
+        truncated:
+          type: boolean
+    mssqlWait:
       type: object
+      required:
+        - sessionId
+        - requestId
+        - blockingSessionId
+        - waitType
+        - waitMs
+        - resource
+        - source
       properties:
-        database:
-          type: string
-        schema:
-          type: string
-        name:
-          type: string
-        relationOid:
-          type: integer
-          format: int64
-        totalBytes:
+        sessionId:
           type: integer
           format: int64
-        tableBytes:
+        requestId:
           type: integer
           format: int64
-        indexBytes:
+          description: Request ID, or -1 when a waiting task cannot be associated with a live request.
+        blockingSessionId:
           type: integer
           format: int64
-        toastBytes:
+          description: SQL Server blocking owner. Negative values are special owners, not session IDs.
+        waitType:
+          type: string
+        waitMs:
           type: integer
           format: int64
-        toastRelationOid:
+        resource:
+          type: string
+        source:
+          type: string
+    mssqlLock:
+      type: object
+      required:
+        - sessionId
+        - requestId
+        - database
+        - resourceType
+        - resource
+        - entityId
+        - mode
+        - status
+        - ownerType
+      properties:
+        sessionId:
           type: integer
           format: int64
-        liveTuples:
+        requestId:
           type: integer
           format: int64
-        deadTuples:
+        database:
+          type: string
+        resourceType:
+          type: string
+        resource:
+          type: string
+        entityId:
+          type: string
+        mode:
+          type: string
+        status:
+          type: string
+        ownerType:
+          type: string
+    mssqlLockSnapshot:
+      type: object
+      required:
+        - capturedAt
+        - sessions
+        - waits
+        - locks
+        - truncated
+      properties:
+        capturedAt:
+          type: string
+        sessions:
+          type: array
+          items:
+            $ref: '#/components/schemas/mssqlSession'
+        waits:
+          type: array
+          items:
+            $ref: '#/components/schemas/mssqlWait'
+        locks:
+          type: array
+          items:
+            $ref: '#/components/schemas/mssqlLock'
+        truncated:
+          type: boolean
+      description: Bounded live DMV observations. Edges are SQL Server reported blocking identifiers. Collection is not atomic; graph cycles are not historical deadlock evidence.
+    mssqlCachedPlan:
+      type: object
+      required:
+        - capturedAt
+        - xml
+        - available
+      properties:
+        capturedAt:
+          type: string
+        xml:
+          type: string
+        available:
+          type: boolean
+      description: Cached compiled plan for the selected live request. No captured SQL is executed. This is not an actual runtime plan.
+    postgresqlSession:
+      type: object
+      required:
+        - pid
+        - user
+        - database
+        - applicationName
+        - clientAddr
+        - clientPort
+        - state
+        - waitEventType
+        - waitEvent
+        - durationSeconds
+        - xactDurationSeconds
+        - queryDigest
+        - querySummary
+        - backendType
+      properties:
+        pid:
           type: integer
           format: int64
-        seqScan:
+        user:
+          type: string
+        database:
+          type: string
+        applicationName:
+          type: string
+        clientAddr:
+          type: string
+          description: Client address.
+        clientPort:
+          type: string
+          description: Client port.
+        state:
+          type: string
+        waitEventType:
+          type: string
+        waitEvent:
+          type: string
+        backendStart:
+          type: string
+          description: Backend start timestamp if available.
+        queryStart:
+          type: string
+          description: Query start timestamp if available.
+        xactStart:
+          type: string
+          description: Transaction start timestamp if available.
+        durationSeconds:
           type: integer
           format: int64
-        indexScan:
+        xactDurationSeconds:
           type: integer
           format: int64
-        lastVacuum:
-          type: string
-        lastAutoVacuum:
+        queryDigest:
           type: string
-        lastAnalyze:
+        querySummary:
           type: string
-        lastAutoAnalyze:
+        backendType:
           type: string
-    postgresqlIndexSpace:
+    postgresqlSessionList:
+      type: array
+      items:
+        $ref: '#/components/schemas/postgresqlSession'
+    postgresqlSpaceSummary:
       type: object
+      required:
+        - tableCount
+        - indexCount
+        - toastRelationCount
+        - tableListTruncated
+        - indexListTruncated
       properties:
-        database:
-          type: string
-        schema:
-          type: string
-        table:
-          type: string
-        name:
+        databaseName:
           type: string
-        tableRelationOid:
+        databaseSizeBytes:
           type: integer
           format: int64
-        relationOid:
+        tableCount:
           type: integer
           format: int64
-        sizeBytes:
+        indexCount:
           type: integer
           format: int64
-        isPrimary:
-          type: boolean
-        isUnique:
-          type: boolean
-        scanCount:
+        toastRelationCount:
           type: integer
           format: int64
-        tuplesRead:
+        largestTableBytes:
           type: integer
           format: int64
-        tuplesFetch:
+        largestIndexBytes:
           type: integer
           format: int64
-    postgresqlToastRelationSpace:
+        tableListTruncated:
+          type: boolean
+        indexListTruncated:
+          type: boolean
+    postgresqlStorageInstanceUsage:
       type: object
       properties:
-        database:
+        instanceName:
           type: string
-        schema:
+          description: Kubernetes pod name for this PostgreSQL replica storage sample.
+        pvcName:
           type: string
-        table:
+          description: PersistentVolumeClaim name when it can be read from metrics labels.
+        role:
           type: string
-        tableRelationOid:
+          description: Raw PostgreSQL replica role value read from metrics labels, kept aligned with instance detail display.
+        componentName:
+          type: string
+          description: Optional KubeBlocks component name when it can be read from metrics labels.
+        totalBytes:
           type: integer
           format: int64
-        toastRelationOid:
+          description: Physical PVC capacity in bytes for this replica storage sample.
+        usedBytes:
           type: integer
           format: int64
-        toastBytes:
+          description: Physical PVC used bytes for this replica storage sample.
+        availableBytes:
           type: integer
           format: int64
-    postgresqlSpaceSource:
+          description: Available bytes derived from totalBytes - usedBytes when both values are available.
+        usageRatio:
+          type: number
+          format: double
+          nullable: true
+          description: usedBytes / totalBytes for this replica storage sample when both values are available.
+        updatedAt:
+          type: string
+          description: Metrics collection timestamp in UTC.
+        source:
+          type: string
+    postgresqlStorageOverview:
       type: object
       required:
-        - name
-        - kind
-        - status
-        - collectedAt
+        - source
+        - instances
+      properties:
+        source:
+          type: string
+        instances:
+          type: array
+          description: Physical PostgreSQL replica storage usage split by pod/PVC/role.
+          items:
+            $ref: '#/components/schemas/postgresqlStorageInstanceUsage'
+    postgresqlDatabaseSpace:
+      type: object
+      properties:
+        name:
+          type: string
+        sizeBytes:
+          type: integer
+          format: int64
+    postgresqlTableSpace:
+      type: object
+      properties:
+        database:
+          type: string
+        schema:
+          type: string
+        name:
+          type: string
+        relationOid:
+          type: integer
+          format: int64
+        totalBytes:
+          type: integer
+          format: int64
+        tableBytes:
+          type: integer
+          format: int64
+        indexBytes:
+          type: integer
+          format: int64
+        toastBytes:
+          type: integer
+          format: int64
+        toastRelationOid:
+          type: integer
+          format: int64
+        liveTuples:
+          type: integer
+          format: int64
+        deadTuples:
+          type: integer
+          format: int64
+        seqScan:
+          type: integer
+          format: int64
+        indexScan:
+          type: integer
+          format: int64
+        lastVacuum:
+          type: string
+        lastAutoVacuum:
+          type: string
+        lastAnalyze:
+          type: string
+        lastAutoAnalyze:
+          type: string
+    postgresqlIndexSpace:
+      type: object
+      properties:
+        database:
+          type: string
+        schema:
+          type: string
+        table:
+          type: string
+        name:
+          type: string
+        tableRelationOid:
+          type: integer
+          format: int64
+        relationOid:
+          type: integer
+          format: int64
+        sizeBytes:
+          type: integer
+          format: int64
+        isPrimary:
+          type: boolean
+        isUnique:
+          type: boolean
+        scanCount:
+          type: integer
+          format: int64
+        tuplesRead:
+          type: integer
+          format: int64
+        tuplesFetch:
+          type: integer
+          format: int64
+    postgresqlToastRelationSpace:
+      type: object
+      properties:
+        database:
+          type: string
+        schema:
+          type: string
+        table:
+          type: string
+        tableRelationOid:
+          type: integer
+          format: int64
+        toastRelationOid:
+          type: integer
+          format: int64
+        toastBytes:
+          type: integer
+          format: int64
+    postgresqlSpaceSource:
+      type: object
+      required:
+        - name
+        - kind
+        - status
+        - collectedAt
       properties:
         name:
           type: string
@@ -27334,347 +27813,6 @@ components:
         explainResult:
           $ref: '#/components/schemas/DmsExecutionPlanResult'
           description: Normalized DMS estimated visual plan. The resolved statement and generated EXPLAIN SQL are intentionally removed.
-    mysqlSQLFingerprint:
-      type: object
-      required:
-        - queryID
-        - fingerprint
-        - querySummary
-        - calls
-        - totalTimeMs
-        - meanTimeMs
-        - maxTimeMs
-        - rows
-        - rowsSent
-        - rowsAffected
-        - rowsExamined
-        - lockTimeMs
-        - errors
-        - warnings
-        - tmpTables
-        - tmpDiskTables
-        - noIndexUsed
-        - noGoodIndexUsed
-        - database
-      properties:
-        queryID:
-          type: string
-          description: MySQL Performance Schema DIGEST value.
-        fingerprint:
-          type: string
-          description: Stable SQL fingerprint identifier. M1 uses DIGEST.
-        querySummary:
-          type: string
-          description: Normalized DIGEST_TEXT. Raw SQL text is intentionally not returned.
-        calls:
-          type: integer
-          format: int64
-          description: Number of executions accumulated in the current digest row.
-        totalTimeMs:
-          type: number
-          format: double
-          description: Total statement wait time in milliseconds.
-        meanTimeMs:
-          type: number
-          format: double
-          description: Mean statement wait time in milliseconds.
-        maxTimeMs:
-          type: number
-          format: double
-          description: Maximum statement wait time in milliseconds.
-        rows:
-          type: integer
-          format: int64
-          description: Sum of rows sent and rows affected.
-        rowsSent:
-          type: integer
-          format: int64
-          description: Total rows sent to clients.
-        rowsAffected:
-          type: integer
-          format: int64
-          description: Total rows affected by statements.
-        rowsExamined:
-          type: integer
-          format: int64
-          description: Total rows examined by statements.
-        lockTimeMs:
-          type: number
-          format: double
-          description: Total statement lock time in milliseconds.
-        errors:
-          type: integer
-          format: int64
-          description: Total statement errors.
-        warnings:
-          type: integer
-          format: int64
-          description: Total statement warnings.
-        tmpTables:
-          type: integer
-          format: int64
-          description: Total internal temporary tables created.
-        tmpDiskTables:
-          type: integer
-          format: int64
-          description: Total internal on-disk temporary tables created.
-        noIndexUsed:
-          type: integer
-          format: int64
-          description: Executions that used no index.
-        noGoodIndexUsed:
-          type: integer
-          format: int64
-          description: Executions for which no good index was found.
-        database:
-          type: string
-          description: Default schema name associated with the digest row.
-        firstSeen:
-          type: string
-          description: UTC timestamp when the digest was first observed.
-        lastSeen:
-          type: string
-          description: UTC timestamp when the digest was most recently observed.
-    mysqlSQLAnalysis:
-      type: object
-      required:
-        - source
-        - status
-        - collectedAt
-        - limit
-        - orderBy
-        - items
-      properties:
-        source:
-          type: string
-          description: Data source. M1 uses performance_schema.events_statements_summary_by_digest.
-        status:
-          type: string
-          description: Source status. Expected values are available or unavailable.
-        unavailableReason:
-          type: string
-          description: Reason when status is unavailable, such as performance_schema_disabled, digest_consumer_disabled, permission_denied, or query_failed.
-        message:
-          type: string
-          description: User-facing recovery guidance when SQL analysis is unavailable.
-        collectedAt:
-          type: string
-          description: Backend collection timestamp in UTC. It is not a sampling-window end time.
-        firstSeen:
-          type: string
-          description: Earliest FIRST_SEEN timestamp across currently visible digest rows, when available.
-        lastSeen:
-          type: string
-          description: Latest LAST_SEEN timestamp across currently visible digest rows, when available.
-        limit:
-          type: integer
-          format: int64
-          description: Effective row limit after backend normalization.
-        orderBy:
-          type: string
-          description: Effective sort key. Expected values are totalTime, meanTime, maxTime, or calls.
-        totalTimeMsAll:
-          type: number
-          format: double
-          x-nullable: true
-          description: Total execution time in milliseconds across all visible digest rows, not limited to the returned top-N items.
-        callsAll:
-          type: integer
-          format: int64
-          x-nullable: true
-          description: Total execution count across all visible digest rows, not limited to the returned top-N items.
-        digestLost:
-          type: integer
-          format: int64
-          x-nullable: true
-          description: Number of statement digests not recorded because the digest table was full, when exposed by the server.
-        items:
-          type: array
-          description: SQL fingerprint ranking rows from Performance Schema. The list may be empty when no statement statistics exist.
-          items:
-            $ref: '#/components/schemas/mysqlSQLFingerprint'
-    performanceTrendRange:
-      type: object
-      required:
-        - label
-        - start
-        - end
-        - durationSeconds
-      properties:
-        label:
-          type: string
-          description: Controlled query range label. Values are 1h, 6h, 24h, or 7d.
-        start:
-          type: string
-        end:
-          type: string
-        durationSeconds:
-          type: integer
-          format: int64
-    performanceTrendSummary:
-      type: object
-      required:
-        - metric
-        - displayName
-        - category
-        - unit
-        - min
-        - max
-        - avg
-        - latest
-      properties:
-        metric:
-          type: string
-        displayName:
-          $ref: '#/components/schemas/localizedDescription'
-        category:
-          type: string
-          description: Metric category. Values include availability, performance, connections, resource, capacity, innodb, and vacuumWraparound.
-        dimension:
-          type: string
-          description: Optional series dimension. Values include cluster, instance, pvc, and database.
-        labels:
-          type: object
-          additionalProperties:
-            type: string
-          description: Optional dimension labels, for example instance, pvc, role, or datname.
-        unit:
-          type: string
-        warnThreshold:
-          type: number
-          format: double
-          description: Optional warning threshold in the same unit as this metric.
-        critThreshold:
-          type: number
-          format: double
-          description: Optional critical threshold in the same unit as this metric.
-        thresholdDirection:
-          type: string
-          description: Optional threshold direction. Values are above, below, or boolean.
-        min:
-          type: number
-          format: double
-        max:
-          type: number
-          format: double
-        avg:
-          type: number
-          format: double
-        latest:
-          type: number
-          format: double
-        changeDirection:
-          type: string
-          description: Change direction when at least two samples exist. Values are increasing, decreasing, or stable.
-    performanceTrendPoint:
-      type: object
-      required:
-        - timestamp
-        - value
-      properties:
-        timestamp:
-          type: string
-        value:
-          type: number
-          format: double
-    performanceTrendSeries:
-      type: object
-      required:
-        - metric
-        - displayName
-        - category
-        - unit
-        - points
-      properties:
-        metric:
-          type: string
-        displayName:
-          $ref: '#/components/schemas/localizedDescription'
-        category:
-          type: string
-          description: Metric category. Values include availability, performance, connections, resource, capacity, innodb, and vacuumWraparound.
-        dimension:
-          type: string
-          description: Optional series dimension. Values include cluster, instance, pvc, and database.
-        labels:
-          type: object
-          additionalProperties:
-            type: string
-          description: Optional dimension labels, for example instance, pvc, role, or datname.
-        unit:
-          type: string
-        warnThreshold:
-          type: number
-          format: double
-          description: Optional warning threshold in the same unit as this metric.
-        critThreshold:
-          type: number
-          format: double
-          description: Optional critical threshold in the same unit as this metric.
-        thresholdDirection:
-          type: string
-          description: Optional threshold direction. Values are above, below, or boolean.
-        points:
-          type: array
-          items:
-            $ref: '#/components/schemas/performanceTrendPoint'
-    performanceTrendSource:
-      type: object
-      required:
-        - name
-        - kind
-        - status
-        - collectedAt
-      properties:
-        name:
-          type: string
-        kind:
-          type: string
-        status:
-          type: string
-          description: Coarse source status. Values are success, partial, failed, skipped, or noData.
-        collectedAt:
-          type: string
-        message:
-          type: string
-    performanceTrends:
-      type: object
-      required:
-        - range
-        - granularity
-        - summary
-        - series
-        - sources
-        - warnings
-        - collectedAt
-      properties:
-        range:
-          $ref: '#/components/schemas/performanceTrendRange'
-        granularity:
-          type: string
-          description: Controlled backend query step.
-        summary:
-          type: array
-          description: Per-series numeric summary. changeDirection is present only when at least two points exist.
-          items:
-            $ref: '#/components/schemas/performanceTrendSummary'
-        series:
-          type: array
-          description: Successfully collected and displayable metric series only. Unsupported, empty, or failed metrics are not represented as per-metric entries.
-          items:
-            $ref: '#/components/schemas/performanceTrendSeries'
-        sources:
-          type: array
-          description: Coarse collection source status. Messages are sanitized and do not expose PromQL, endpoints, credentials, or raw internal errors.
-          items:
-            $ref: '#/components/schemas/performanceTrendSource'
-        warnings:
-          type: array
-          items:
-            type: string
-        collectedAt:
-          type: string
-          description: Backend collection timestamp in UTC.
     elasticsearchHotThreadsType:
       type: string
       enum: