全部產品
Search
文件中心

:DescribeDBClusterPerformance - 查看效能資料

更新時間:Nov 03, 2025

調用DescribeDBClusterPerformance介面查看雲資料庫ClickHouse社區相容版叢集的效能資料。

介面說明

根據績效參數查看指定叢集在某時間段範圍內的效能監控資料。採集粒度為 30 秒。

說明

該介面僅支援 2021 年 12 月 01 日之前建立的雲資料庫 ClickHouse 社區相容版叢集。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊,可以在RAM權限原則語句的Action元素中使用,用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下:

  • 操作:是指具體的許可權點。

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

  • 資源類型:是指操作中支援授權的資源類型。具體說明如下:

    • 對於必選的資源類型,用前面加 * 表示。

    • 對於不支援資源級授權的操作,用全部資源表示。

  • 條件關鍵字:是指雲產品自身定義的條件關鍵字。

  • 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

clickhouse:DescribeDBClusterPerformance

get

*全部資源

*

請求參數

名稱

類型

必填

描述

樣本值

DBClusterId

string

叢集 ID。

cc-bp125e3uu94wo****

Key

string

需要查詢的效能指標名稱,多個值之間用英文逗號(,)分隔。每次最多支援查詢 5 個效能指標。支援查詢如下效能指標:

說明

Key 為必填項。

  • CPU
    • CPU_USAGE:CPU 使用率。

  • 記憶體
    • MEM_USAGE:記憶體使用量率。

    • MEM_USAGE_SIZE:記憶體使用量量(單位:MB)。

  • 磁碟
    • DISK_USAGE:磁碟使用率。

    • DISK_USAGE_SIZE:磁碟使用量(單位:MB)。

    • IOPS:磁碟 IOPS。

  • 串連
    • CONN_USAGE:資料庫連接使用率。

    • CONN_USAGE_COUNT:資料庫使用串連數。

  • 寫入
    • TPS:每秒寫入行數。

    • INSERT_SIZE:每秒寫入大小(單位:MB)。

  • 查詢
    • QPS:查詢 QPS。

    • AVG_SEEK:隨機 SEEK 調用次數。

  • WAIT
    • ZK_WAIT:ZK 的平均等待時間長度(單位:ms)。

    • IO_WAIT:IO_WAIT 的平均等待時間長度(單位:ms)。

    • CPU_WAIT:CPU_WAIT 的平均等待時間長度(單位:ms)。

MEM_USAGE

StartTime

string

查詢開始時間。格式:yyyy-MM-ddTHH:mmZ(UTC 時間)。

2021-11-27T16:37Z

EndTime

string

查詢結束時間。格式:yyyy-MM-ddTHH:mmZ(UTC 時間)。

說明

查詢結束時間需晚於開始時間,且開始時間和結束時間的時間間隔不能超過 32 天。

2021-11-27T16:38Z

返回參數

名稱

類型

描述

樣本值

object

EndTime

string

查詢結束時間。格式:yyyy-MM-ddTHH:mmZ(UTC 時間)。

2021-11-27T16:38Z

RequestId

string

請求 ID。

FE242962-6DA3-5FC8-9691-37B62A3210F7

StartTime

string

查詢開始時間。格式:yyyy-MM-ddTHH:mmZ(UTC 時間)。

2021-11-27T16:37Z

DBClusterId

string

叢集 ID。

cc-bp125e3uu94wo****

Performances

array<object>

叢集績效參數值列表。

array<object>

效能值

Key

string

效能指標名稱。

MEM_USAGE

Unit

string

資料單位。

%

Series

array<object>

績效參數集合。

array<object>

指標資訊。

Values

array<object>

績效參數值,每個值對應一個採集時間點。

object

指標值。

Point

array

效能值

string

不同時間點下的效能值詳情。

[ "2021-11-26T16:39:00Z","15.08" ]

Name

string

效能資料列表的名稱。

cc-bp125e3uu94wo1s0k16****

Name

string

效能值名稱。

mem_usage

樣本

正常返回樣本

JSON格式

{
  "EndTime": "2021-11-27T16:38Z",
  "RequestId": "FE242962-6DA3-5FC8-9691-37B62A3210F7",
  "StartTime": "2021-11-27T16:37Z",
  "DBClusterId": "cc-bp125e3uu94wo****",
  "Performances": [
    {
      "Key": "MEM_USAGE",
      "Unit": "%",
      "Series": [
        {
          "Values": [
            {
              "Point": [
                "[ \"2021-11-26T16:39:00Z\",\"15.08\" ]"
              ]
            }
          ],
          "Name": "cc-bp125e3uu94wo1s0k16****"
        }
      ],
      "Name": "mem_usage"
    }
  ]
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情