调用DescribeDBClusterResourcePoolPerformance接口查看AnaluticDB MySQL版弹性模式集群版(新版)的资源池监控信息。

说明 您还可以在控制台上以图表的形式查看AnaluticDB MySQL版弹性模式集群版(新版)资源池监控信息。更多详细信息,请参见查看监控信息

调试

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

请求参数

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

系统规定参数。取值:DescribeDBClusterResourcePoolPerformance

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

集群ID。

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

资源池数据监控指标。允许同时输入多个指标进行查询,多个指标间用英文逗号(,)分隔。支持监控如下指标:

  • AnalyticDB_RP_CPU :CPU平均使用率,单位:%。
  • AnalyticDB_RP_RT:查询响应时间(RT),单位:毫秒(ms)。
  • AnalyticDB_RP_QPS:每秒查询率(QPS),单位:数值。
  • AnalyticDB_RP_WaitTime:查询等待时间,单位:毫秒(ms)。
  • AnalyticDB_RP_ActualNode:资源池分时弹计划中实际生效的节点数(即执行扩容计划时实际增加的节点数),单位:数值。
  • AnalyticDB_RP_PlanNode:资源池分时弹性计划中需要增加的节点数,单位:数值。
  • AnalyticDB_RP_TotalNode:资源池拥有的总节点数,总节点数=基础节点数+分时弹性计划中实际生效的节点数。单位:数值。
  • AnalyticDB_RP_OriginalNode:资源池基础节点数。单位:数值。
说明
  • 若该参数留空,默认返回所有指标的监控数据详情。
  • 更多关于资源池弹性计划的信息,请参见资源弹性扩容
ResourcePools String TEST_POOL

目标资源池名称。允许同时输入多个资源池名称进行查询,多个名称间用英文逗号(,)分隔。

说明
  • 输入的资源池名称不区分大小写,例如USER_DEFAULTuser_default表示的是同一个资源池。
  • 若该参数留空,将返回USER_DEFAULT即默认资源池的监控信息。
StartTime String 2021-06-10T07:00Z

资源池数据监控开始时间。格式为yyyy-MM-ddTHH:mmZ(UTC时间)。

说明 仅支持查看最近2天的资源池监控信息。
EndTime String 2021-06-10T07:01Z

资源池数据监控结束时间,结束时间需晚于开始时间。格式为yyyy-MM-ddTHH:mmZ(UTC时间)。

返回数据

名称 类型 示例值 描述
EndTime String 2021-06-10T07:01:00Z

资源池数据监控结束时间,格式:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。

RequestId String C7EDB8E4-9769-4233-88C7-DCA4C9******

请求ID。

StartTime String 2021-06-10T07:00:00

资源池数据监控开始时间,格式:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。

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

集群ID。

Performances Array of PerformanceItem

以监控指标为维度的数据详情列表。

Key String AnalyticDB_RP_CPU

资源池数据监控指标。

Unit String %

监控指标的单位。

ResourcePoolPerformances Array of ResourcePoolPerformancesItem

以资源池为维度的监控数据列表。

ResourcePoolName String test_pool

资源池名称。

ResourcePoolSeries Array of ResourcePoolSeriesItem

资源池监控数据的序列列表。

Values Array of String ["2021-06-10T07:00:22.601Z","0.0000"],["2021-06-10T07:00:52.62Z","0.0312"]

不同时间点下的资源池监控项数值。

Name String cpu

监控指标名称。

示例

请求示例

http(s)://adb.aliyuncs.com/?Action=DescribeDBClusterResourcePoolPerformance
&DBClusterId=am-****************
&StartTime=2021-06-10T07:00Z
&EndTime=2021-06-10T07:01Z
&公共请求参数

正常返回示例

XML格式

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

<DescribeDBClusterResourcePoolPerformanceResponse>
    <RequestId>C7EDB8E4-9769-4233-88C7-DCA4C9******</RequestId>
    <EndTime>2021-06-10T07:01:00Z</EndTime>
    <StartTime>2021-06-10T07:00:00Z</StartTime>
    <Performances>
        <ResourcePoolPerformances>
            <ResourcePoolSeries>
                <Values>
                    <0>2021-06-10T07:00:22.601Z</0>
                    <1>0.0000</1>
                </Values>
                <Values>
                    <0>2021-06-10T07:00:52.62Z</0>
                    <1>0.0312</1>
                </Values>
                <Name>cpu</Name>
            </ResourcePoolSeries>
            <ResourcePoolName>test_pool</ResourcePoolName>
        </ResourcePoolPerformances>
        <Unit>%</Unit>
        <Key>AnalyticDB_RP_CPU</Key>
    </Performances>
</DescribeDBClusterResourcePoolPerformanceResponse>

JSON格式

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

{
  "RequestId" : "C7EDB8E4-9769-4233-88C7-DCA4C9******",
  "EndTime" : "2021-06-10T07:01:00Z",
  "StartTime" : "2021-06-10T07:00:00Z",
  "Performances" : [ {
    "ResourcePoolPerformances" : [ {
      "ResourcePoolSeries" : [ {
        "Values" : [ [ "2021-06-10T07:00:22.601Z", "0.0000" ], [ "2021-06-10T07:00:52.62Z", "0.0312" ] ],
        "Name" : "cpu"
      } ],
      "ResourcePoolName" : "test_pool"
    } ],
    "Unit" : "%",
    "Key" : "AnalyticDB_RP_CPU"
  } ]
}

错误码

HttpCode 错误码 错误信息 描述
404 InvalidDBCluster.NotFound The DBClusterId provided does not exist in our records. 您指定的 DBClusterId 不存在,请确认 DBClusterId 值是否正确。

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