调用DescribeDBClusterPerformance接口查看实例性能数据。根据性能参数查看某个实例、某时间段范围内的性能监控数据。采集粒度为30秒钟

请求参数

名称 类型 是否必选 描述
Action String 系统规定参数,取值:DescribeDBClusterPerformance
DBClusterId String 实例ID。
Key String

想要查询的性能指标,多个值用英文逗号(,)分隔。每次最多5个指标。

说明
  • CPU
    • CPU_USAGECPU使用率
      • cpu_usage
  • 内存
    • MEM_USAGE: 内存使用率
      • mem_usage
    • MEM_USAGE_SIZE: 内存使用量(单位:MB)
      • mem_usage_size
  • 磁盘
    • DISK_USAGE:磁盘使用比率
      • disk_usage
    • DISK_USAGE_SIZE: 磁盘使用量
      • disk_usage_size
    • IOPS磁盘IOPS
      • iops
    • IOPS_SIZE磁盘IOPS大小(单位MB)
      • iops_mb
  • 连接
    • CONN_USAGE:数据库连接使用比率
      • conn_usage
    • CONN_USAGE_COUNT: 数据库使用连接数
      • conn_usage_count
  • 写入
    • TPS写入TPS
      • tps
    • INSERT_ROWS:每秒写入行数
      • insert_rows
    • INSERT_SIZE:每秒写入大小(单位MB)
      • insert_mb
  • 查询
    • QPS查询QPS
      • qps
    • AVG_SEEK: 随机seek调用次数
      • seek_ps
  • WAIT
    • ZKWAIT:ZK的平均等待时长(单位ms)
      • zk_wait
    • IO_WAIT
      • io_wait: 平均IO WAIT时长(单位ms)
    • CPU_WAIT
      • cpu_wait: 平均CPU WAIT时长(单位ms)
StartTime String 查询开始时间。格式:yyyy-MM-ddTHH:mmZ。
EndTime String 查询结束时间。格式:yyyy-MM-ddTHH:mmZ。

返回参数

名称 类型 描述
DBClusterId String 实例ID。
StartTime String 查询开始时间。
EndTime String 查询结束时间。
Performances Array 实例性能参数列表。
└Key String 性能指标,如ClickHouse_CPU
└Unit String 数据单位。
Series Array 所有后端server的指标集合。
└Name String 当前series的名称,比如serverid等。
└Values Array 每个Values对应一台后端server的指标值。
└Point String[]

数组格式:如:[

[ "2019-05-06T05:17:46Z", "5.09" ]

RequestId String 请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeDBClusterPerformance
&DBClusterId=am-xxxxxxxxxx
&StartTime=2019-11-01T00:00Z
&EndTime=2019-11-01T00:05Z
&Key=AnalyticDB_DiskUsage
&<公共请求参数>

正常返回示例

XML 格式

<DescribeDBClusterPerformanceResponse>
  <EndTime>2020-03-19T07:28Z</EndTime>
  <RequestId>3019120E-125D-4FC0-B286-266A40F84716</RequestId>
  <DBClusterId>cc-t4n1w34v612qa7uk7</DBClusterId>
  <StartTime>2020-03-19T07:26Z</StartTime>
  <Performances>
    <PerformanceItem>
      <Series>
        <SeriesItem>
          <Values>
            <ValueItem>
              <Point>
                <Point>2020-03-19T07:26:00Z</Point>
                <Point>0.29</Point>
              </Point>
            </ValueItem>
            <ValueItem>
              <Point>
                <Point>2020-03-19T07:27:00Z</Point>
                <Point>0.28</Point>
              </Point>
            </ValueItem>
          </Values>
          <Name>cc-t4n1w34v612qa7uk773430</Name>
        </SeriesItem>
        <SeriesItem>
          <Values>
            <ValueItem>
              <Point>
                <Point>2020-03-19T07:26:00Z</Point>
                <Point>0.28</Point>
              </Point>
            </ValueItem>
            <ValueItem>
              <Point>
                <Point>2020-03-19T07:27:00Z</Point>
                <Point>0.21</Point>
              </Point>
            </ValueItem>
          </Values>
          <Name>cc-t4n1w34v612qa7uk773431</Name>
        </SeriesItem>
      </Series>
      <Unit>%</Unit>
      <Key>CPU_USAGE</Key>
      <Name>cpu_usage</Name>
    </PerformanceItem>
  </Performances>
</DescribeDBClusterPerformanceResponse>

JSON 格式

{
  "EndTime": "2020-03-20T00:02Z",
  "RequestId": "1D1F6CA8-6CB2-47BA-A474-DE8703636002",
  "DBClusterId": "cc-t4n1w34v612qa7uk7",
  "StartTime": "2020-03-20T00:00Z",
  "Performances": [
    {
      "Series": [
        {
          "Values": [
            {
              "Point": [
                "2020-03-20T00:00:00Z",
                "1.01"
              ]
            },
            {
              "Point": [
                "2020-03-20T00:01:00Z",
                "1.0"
              ]
            }
          ],
          "Name": "cc-t4n1w34v612qa7uk773430"
        },
        {
          "Values": [
            {
              "Point": [
                "2020-03-20T00:00:00Z",
                "1.01"
              ]
            },
            {
              "Point": [
                "2020-03-20T00:01:00Z",
                "1.01"
              ]
            }
          ],
          "Name": "cc-t4n1w34v612qa7uk773431"
        }
      ],
      "Unit": "counts",
      "Key": "INSERT_ROWS",
      "Name": "cpu_usage"
    }
  ]
}