调用DescribeInstancePerformance接口查看实例监控信息详情。

调试

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

请求参数

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

系统规定参数。取值为DescribeInstancePerformance。

DbInstanceName String 是 pxc-****************

实例ID。
RegionId String 是 cn-hangzhou

实例所在地域。
NodeId String 否 pxi-**************

实例的节点ID。
Keys String 否 cpu,old

需要查询的监控项，取值范围如下：

  • lqps：逻辑QPS
  • lrt：逻辑RT
  • con：前端连接数
  • active：活跃线程数
  • netin: 网络流量（输入）
  • netout：网络流量（输出）
  • cpu：CPU使用率
  • old：内存使用率
说明 允许同时查看多个监控项信息，多个监控项间需用英文逗号（,）分隔，更多关于实例监控项信息，请参见计算资源监控。
StartTime String 否 2020-08-12 04:59:02

监控开始时间（目标实例所在时区的时间），格式为yyyy-mm-dd hh:mm:ss。

EndTime String 否 2020-08-12 10:59:02

监控终止时间（目标实例所在时区的时间），格式为yyyy-mm-dd hh:mm:ss。

说明 监控终止时间需晚于监控开始时间。

返回数据

名称 类型 示例值 描述
Data Struct

监控数据。
PerformanceItems Array of PerformanceItem

监控项和数据。
Measurement String cpu,old

监控指标列表，取值范围如下：

  • lqps：逻辑QPS
  • lrt：逻辑RT
  • con：前端连接数
  • active：活跃线程数
  • netin: 网络流量（输入）
  • netout：网络流量（输出）
  • cpu：CPU使用率
  • old：内存使用率
说明 更多关于实例监控项信息，请参见计算资源监控。
MetricName String cpu

单个监控指标详情（如cpu）。

Points Array of Point

监控指标数据详情。

说明 若在查询时间范围内为采集到相关监控数据，则该参数列表为空。
Timestamp Long 1597201474

在查询时间范围内采集到监控数据的时间点，戳格式为Unix时间戳，单位为秒。
Value String 1

目标监控项的数值。
Message String ****

请求返回消息。

说明 请求成功时该参数为空，请求失败时会返回请求异常信息（如错误码等）。
RequestId String 88DC5709-8BEC-4D17-A6D5-4DACA9******

请求ID。
Success Boolean true

请求是否成功。

示例

请求示例

http(s)://polardbx.cn-hangzhou.aliyuncs.com/?Action=DescribeInstancePerformance
&DbInstanceName=pxc-****************
&RegionId=cn-hangzhou
&<公共请求参数>

正常返回示例

XML 格式 

<code>200</code>
<data>
    <RequestId>88DC5709-8BEC-4D17-A6D5-4DACA9******</RequestId>
    <Data>
        <PerformanceItems>
            <Measurement>cpu,old</Measurement>
            <MetricName>cpu</MetricName>
        </PerformanceItems>
        <PerformanceItems>
            <Measurement>cpu,old</Measurement>
            <MetricName>old</MetricName>
        </PerformanceItems>
    </Data>
    <Success>true</Success>
</data>
<httpStatusCode>200</httpStatusCode>
<requestId>88DC5709-8BEC-4D17-A6D5-4DACA9******</requestId>
<successResponse>true</successResponse>

JSON 格式 

{
	"code": "200",
	"data": {
		"RequestId": "88DC5709-8BEC-4D17-A6D5-4DACA9******",
		"Data": {
			"PerformanceItems": [{
				"Measurement": "cpu,old",
				"MetricName": "cpu",
				"Points": []
			}, {
				"Measurement": "cpu,old",
				"MetricName": "old",
				"Points": []
			}]
		},
		"Success": true
	},
	"httpStatusCode": "200",
	"requestId": "88DC5709-8BEC-4D17-A6D5-4DACA9******",
	"successResponse": true
}

错误码

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