调用DescribeDBClusterPerformance接口查看目标集群的性能数据。

根据性能参数查看某个集群、某时间段范围内的性能监控数据。采集粒度为30秒。支持对慢SQL进行查询,提供SQL查询时长、扫描行数、扫描量等监控内容。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeDBClusterPerformance

系统规定参数。取值:DescribeDBClusterPerformance

DBClusterId String am-************

集群ID。

说明 您可以调用DescribeDBClusters接口查看目标地域下所有AnalyticDB MySQL版集群的详情,包括集群ID。
Key String AnalyticDB_CPU

需要查询的性能指标名称,多个值之间用英文逗号(,)分隔。支持查询如下性能指标:

  • CPU
    • AnalyticDB_CPU:CPU平均使用率。
  • 连接数
    • AnalyticDB_Connections:数据库连接数。
  • 写入
    • AnalyticDB_TPS:写入TPS。
    • AnalyticDB_InsertRT:写入响应时间。
    • AnalyticDB_InsertBytes:写入吞吐量。
  • 更新
    • AnalyticDB_UpdateRT:更新响应时间。
  • 删除
    • AnalyticDB_DeleteRT:删除响应时间。
  • 查询
    • AnalyticDB_QPS:查询QPS。
    • AnalyticDB_QueryRT:查询响应时间。
    • AnalyticDB_QueryWaitTime:查询等待耗时。
  • 磁盘
    • AnalyticDB_IO:磁盘IO吞吐。
    • AnalyticDB_IO_UTIL:IO Util。
    • AnalyticDB_IO_WAIT:IO Wait。
    • AnalyticDB_IOPS:磁盘IOPS。
    • AnalyticDB_DiskUsage:磁盘用量。
    • AnalyticDB_HotDataDiskUsage:热数据磁盘用量。
    • AnalyticDB_ColdDataDiskUsage:冷数据磁盘用量。
说明 若该参数留空,默认返回上述所有性能指标的值。
StartTime String 2021-05-03T15:00Z

查询开始时间。格式为yyyy-MM-ddTHH:mmZ(UTC时间)。

EndTime String 2021-05-03T15:01Z

查询结束时间。格式为yyyy-MM-ddTHH:mmZ(UTC时间)。

说明 查询结束时间需晚于开始时间,且开始时间和结束时间的时间间隔不能超过两天。

返回数据

名称 类型 示例值 描述
EndTime String 2021-05-03T15:01:00Z

查询结束时间。格式为yyyy-MM-ddTHH:mm:ssZ(UTC时间)。

RequestId String 25B56BC7-4978-40B3-9E48-4B7067******

请求ID。

StartTime String 2021-05-03T15:00:00Z

查询开始时间。格式为yyyy-MM-ddTHH:mm:ssZ(UTC时间)。

DBClusterId String am-************

集群ID。

Performances Array of PerformanceItem

集群性能指标列表。

Key String AnalyticDB_CPU

性能指标名称。

Unit String %

数据单位。

Series Array of SeriesItem

性能数据列表。

Values Array of String [ "2021-05-03T15:00:12.72Z", "0.1250" ], [ "2021-05-03T15:00:42.739Z", "0.3125" ]

不同时间点下的性能值详情。

Name String worker_avg_cpu_used

性能值名称。

示例

请求示例

http(s)://adb.aliyuncs.com/?Action=DescribeDBClusterPerformance
&DBClusterId=am-************
&Key=AnalyticDB_CPU
&StartTime=2021-06-01T15:00Z
&EndTime=2012-06-18T15:00:00Z
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeDBClusterPerformanceResponse>
    <RequestId>25B56BC7-4978-40B3-9E48-4B7067******</RequestId>
    <EndTime>2021-05-03T15:01:00Z</EndTime>
    <DBClusterId>am-bp**************</DBClusterId>
    <StartTime>2021-05-03T15:00:00Z</StartTime>
    <Performances>
        <Series>
            <Values>
                <0>2021-05-03T15:00:12.72Z</0>
                <1>0.1875</1>
            </Values>
            <Values>
                <0>2021-05-03T15:00:42.739Z</0>
                <1>0.1250</1>
            </Values>
            <Name>worker_avg_cpu_used</Name>
        </Series>
        <Series>
            <Values>
                <0>2021-05-03T15:00:12.72Z</0>
                <1>0.1250</1>
            </Values>
            <Values>
                <0>2021-05-03T15:00:42.739Z</0>
                <1>0.3125</1>
            </Values>
            <Name>executor_avg_cpu_used</Name>
        </Series>
        <Unit>%</Unit>
        <Key>AnalyticDB_CPU</Key>
    </Performances>
</DescribeDBClusterPerformanceResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "25B56BC7-4978-40B3-9E48-4B7067******",
  "EndTime" : "2021-05-03T15:01:00Z",
  "DBClusterId" : "am-bp**************",
  "StartTime" : "2021-05-03T15:00:00Z",
  "Performances" : [ {
    "Series" : [ {
      "Values" : [ [ "2021-05-03T15:00:12.72Z", "0.1875" ], [ "2021-05-03T15:00:42.739Z", "0.1250" ] ],
      "Name" : "worker_avg_cpu_used"
    }, {
      "Values" : [ [ "2021-05-03T15:00:12.72Z", "0.1250" ], [ "2021-05-03T15:00:42.739Z", "0.3125" ] ],
      "Name" : "executor_avg_cpu_used"
    } ],
    "Unit" : "%",
    "Key" : "AnalyticDB_CPU"
  } ]
}

错误码

访问错误中心查看更多错误码。