DescribeDBClusterPerformance - 开发指南| 阿里云

调用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"
  } ]
}

错误码

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