调用DescribeDBInstancePerformance接口查询实例性能数据。

根据性能参数查询某个实例、某时间段范围内的性能监控数据。根据版本、监控频率ModifyDBInstanceMonitor)和查询时间范围的不同,有如下几种输出形式:

  • 除MySQL高可用云盘版和MariaDB之外的版本:
    • 监控频率为5秒:
      • 查询时间范围大于7天,数据粒度为1天;
      • 查询时间范围大于1天,小于等于7天,数据粒度为1小时;
      • 查询时间范围大于等于1小时,小于等于1天,数据粒度为1分钟;
      • 查询时间范围小于1小时,数据粒度为5秒。
    • 监控频率为60秒:
      • 查询范围大于30天,数据粒度为1天;
      • 查询范围大于7天小于等于30天,数据粒度为1小时;
      • 查询范围小于等于7天,数据粒度为1分钟。
    • 监控频率为300秒:
      • 查询范围大于30天,数据粒度为1天;
      • 查询范围大于7天小于等于30天,数据粒度为1小时;
      • 查询范围小于等于7天,数据粒度为5分钟。
  • MySQL高可用云盘版和MariaDB:
    • 查询范围大于30天,数据粒度为1天;
    • 查询范围大于7天小于等于30天,数据粒度为1小时;
    • 查询范围小于等于7天,数据粒度为1分钟。
  • PostgreSQL本地盘和云盘版:
    • 查询范围小于等于1小时,数据粒度为5秒;
    • 查询范围小于等于2小时,数据粒度为10秒;
    • 查询范围小于等于6小时,数据粒度为30秒;
    • 查询范围小于等于12小时,数据粒度为1分钟;
    • 查询范围小于等于1天,数据粒度为2分钟;
    • 查询范围小于等于5天,数据粒度为10分钟;
    • 查询范围小于等于15天,数据粒度为30分钟;
    • 查询范围小于等于30天,数据粒度为1小时;

调试

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

请求参数

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

系统规定参数。取值:DescribeDBInstancePerformance

DBInstanceId String rm-uf6wjk5xxxxxxx

实例ID。可调用DescribeDBInstances获取。

Key String MySQL_Sessions

想要查询的性能指标,多个值用半角逗号(,)分隔,最多传入30个。详细参数请参见性能参数表

说明 KeyMySQL_SpaceUsageSQLServer_SpaceUsage时,仅支持查询1天内的监控数据。
StartTime String 2012-06-08T15:00Z

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

说明 开始和结束时间间隔需要大于您实例的监控频率,否则可能返回空列表。
EndTime String 2012-06-18T15:00Z

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

说明 开始和结束时间间隔需要大于您实例的监控频率,否则可能返回空列表。
NodeId String 339****

实例的唯一标识。

返回数据

名称 类型 示例值 描述
EndTime String 2012-06-19T15:00Z

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

StartTime String 2012-06-10T15:00Z

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

DBInstanceId String rm-uf6wjk5xxxxxxxxxx

实例ID。

Engine String MySQL

数据库类型。

RequestId String A5409D02-D661-4BF3-8F3D-0A814D0574E7

请求ID。

PerformanceKeys Array of PerformanceKey

实例性能参数列表。

PerformanceKey
Key String MySQL_Sessions

性能参数。

ValueFormat String recv_k&sent_k

性能值的格式。

说明 如果性能值由多个参数构成,以“&”分隔,例如com_delete&com_insert&com_insert_select&com_replace。
Unit String KB

数据单位。

Values Array of PerformanceValue

数组格式:{value1, value2, …}。

PerformanceValue
Date String 2011-05-30T03:29:00Z

记录日期。格式:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。

Value String 0.0&13.6

性能值。

示例

请求示例

http(s)://rds.aliyuncs.com/?Action=DescribeDBInstancePerformance
&DBInstanceId= rm-uf6wjk5xxxxxxx
&Key=MySQL_Sessions
&StartTime=2012-06-08T15:00Z
&EndTime=2012-06-18T15:00Z
&NodeId=339****
&公共请求参数

正常返回示例

XML格式

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

<?xml version="1.0" encoding="UTF-8" ?>
<DescribeDBInstancePerformanceResponse>
	<RequestId>A5409D02-D661-4BF3-8F3D-0A814D0574E7</RequestId>
	<DBInstanceID> rm-uf6wjk5xxxxxxx</DBInstanceID>
	<StartTime>2012-06-11T15:00Z</StartTime>
	<EndTime>2013-10-17T15:00Z</EndTime>
	<Engine>MySQL</Engine>
	<PerformanceKeys>
		<PerformanceKey>
			<Key>MySQL_NetworkTraffic</Key>
			<Unit>KB</Unit>
			<ValueFormat>recv_k&amp;sent_k</ValueFormat>
			<Values></Values>
		</PerformanceKey>
	</PerformanceKeys>
</DescribeDBInstancePerformanceResponse>

JSON格式

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

{
  "RequestId" : "A5409D02-D661-4BF3-8F3D-0A814D0574E7",
  "DBInstanceID" : " rm-uf6wjk5xxxxxxx",
  "StartTime" : "2012-06-11T15:00Z",
  "EndTime" : "2013-10-17T15:00Z",
  "Engine" : "MySQL",
  "PerformanceKeys" : {
    "PerformanceKey" : [ {
      "Key" : "MySQL_NetworkTraffic",
      "Unit" : "KB",
      "ValueFormat" : "recv_k&sent_k",
      "Values" : {
        "PerformanceValue" : [ ]
      }
    } ]
  }
}

错误码

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