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

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

调试

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

请求参数

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

系统规定参数,取值:DescribeDBClusterPerformance。

DBClusterId String rm-uf6wjk5xxxxxxxxxx

实例ID。

EndTime String 2012-06-18T15:00Z

查询结束时间。格式:yyyy-MM-ddTHH:mmZ。

StartTime String 2012-06-08T15:00Z

查询开始时间。格式:yyyy-MM-ddTHH:mmZ。

Key String AnalyticDB_DiskUsage

想要查询的性能指标,多个值之间用英文逗号(,)分隔。如果不指定key值则返回如下指标:

  • CPU

    AnalyticDB_CPU:CPU平均使用率。

  • 连接数

    AnalyticDB_Connections:数据库连接数。

  • 写入
    • AnalyticDB_TPS:写入TPS。
    • AnalyticDB_InsertRT:写入响应时间。
    • AnalyticDB_InsertBytes:写入吞吐量。
  • 查询
    • AnalyticDB_QPS:查询QPS。
    • AnalyticDB_QueryRT:查询响应时间。
    • AnalyticDB_QueryWaitTime:查询等待耗时。
  • 磁盘
    • AnalyticDB_IO:磁盘IO吞吐。
    • AnalyticDB_IOPS:磁盘IOPS。
    • AnalyticDB_DiskUsage:磁盘用量。
    • AnalyticDB_HotDataDiskUsage:热数据磁盘用量
    • AnalyticDB_ColdDataDiskUsage:冷数据磁盘用量

返回数据

名称 类型 示例值 描述
DBClusterId String rm-uf6wjk5xxxxxxxxxx

实例ID。

EndTime String 2012-06-18T15:00Z

查询结束时间。格式:yyyy-MM-ddTHH:mmZ。

Performances Array of PerformanceItem

实例性能参数列表。

Key String AnalyticDB_DiskUsage

性能参数。

Series Array of SeriesItem

性能数据列表。

Name String disk_used

性能值名称。

Values List [ [ "2019-05-06T05:17:46.487Z", 5 ], [ "2019-05-06T05:18:20.784Z", 5 ] ]

数组格式。

Unit String %

数据单位。

RequestId String 1AD222E9-E606-4A42-BF6D-8A4442913CEF

请求ID。

StartTime String 2012-06-08T15:00Z

查询开始时间。格式:yyyy-MM-ddTHH:mmZ。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeDBClusterPerformance
&DBClusterId=rm-uf6wjk5xxxxxxxxxx
&EndTime=2012-06-18T15:00Z
&StartTime=2012-06-08T15:00Z
&<公共请求参数>

正常返回示例

XML 格式

<Performances>
    <Key>AnalyticDB_DiskUsage</Key>
    <Series>
        <Values>
            <0>2019-11-11T00:00:27.862Z</0>
            <1>3.0026</1>
        </Values>
        <Values>
            <0>2019-11-11T00:00:57.867Z</0>
            <1>3.0026</1>
        </Values>
        <Values>
            <0>2019-11-11T00:01:27.873Z</0>
            <1>3.0026</1>
        </Values>
        <Values>
            <0>2019-11-11T00:01:57.878Z</0>
            <1>3.0026</1>
        </Values>
        <Values>
            <0>2019-11-11T00:02:27.884Z</0>
            <1>3.0026</1>
        </Values>
        <Values>
            <0>2019-11-11T00:02:57.889Z</0>
            <1>3.0026</1>
        </Values>
        <Values>
            <0>2019-11-11T00:03:27.896Z</0>
            <1>3.0026</1>
        </Values>
        <Values>
            <0>2019-11-11T00:03:57.901Z</0>
            <1>3.0026</1>
        </Values>
        <Values>
            <0>2019-11-11T00:04:27.907Z</0>
            <1>3.0026</1>
        </Values>
        <Values>
            <0>2019-11-11T00:04:57.912Z</0>
            <1>3.0026</1>
        </Values>
        <Name>disk_used</Name>
    </Series>
    <Unit>%</Unit>
</Performances>
<RequestId>2271ADDE-1F5A-4501-8683-1667DF90504E</RequestId>
<EndTime>2019-11-11T00:05:00Z</EndTime>
<StartTime>2019-11-11T00:00:00Z</StartTime>

JSON 格式

{
    "Performances": {
        "Key": "AnalyticDB_DiskUsage",
        "Series": {
            "Values": [
                {
                    "0": "2019-11-11T00:00:27.862Z",
                    "1": 3.0026
                },
                {
                    "0": "2019-11-11T00:00:57.867Z",
                    "1": 3.0026
                },
                {
                    "0": "2019-11-11T00:01:27.873Z",
                    "1": 3.0026
                },
                {
                    "0": "2019-11-11T00:01:57.878Z",
                    "1": 3.0026
                },
                {
                    "0": "2019-11-11T00:02:27.884Z",
                    "1": 3.0026
                },
                {
                    "0": "2019-11-11T00:02:57.889Z",
                    "1": 3.0026
                },
                {
                    "0": "2019-11-11T00:03:27.896Z",
                    "1": 3.0026
                },
                {
                    "0": "2019-11-11T00:03:57.901Z",
                    "1": 3.0026
                },
                {
                    "0": "2019-11-11T00:04:27.907Z",
                    "1": 3.0026
                },
                {
                    "0": "2019-11-11T00:04:57.912Z",
                    "1": 3.0026
                }
            ],
            "Name": "disk_used"
        },
        "Unit": "%"
    },
    "RequestId": "2271ADDE-1F5A-4501-8683-1667DF90504E",
    "EndTime": "2019-11-11T00:05:00Z",
    "StartTime": "2019-11-11T00:00:00Z"
}

错误码

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