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

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

  • 除MySQL 5.7高可用云盘版和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 5.7高可用云盘版和MariaDB：
    • 查询范围大于30天，采集粒度为1天；
    • 查询范围大于7天小于等于30天，采集粒度为1小时；
    • 查询范围小于等于7天，采集粒度为1分钟。

调试

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

请求参数

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

系统规定参数，取值：DescribeDBInstancePerformance。

DBInstanceId String 是 rm-uf6wjk5xxxxxxx

实例ID。
Key String 是 MySQL_Sessions

想要查询的性能指标，多个值用英文逗号（,）分隔，详细参数请参见性能参数表。

说明 Key为MySQL_SpaceUsage或SQLServer_SpaceUsage时，仅支持查询1天内的监控数据。
StartTime String 是 2012-06-08T15:00Z

查询开始时间。格式：yyyy-MM-ddTHH:mmZ（UTC时间）。

EndTime String 是 2012-06-18T15:00Z

查询结束时间。格式：yyyy-MM-ddTHH:mmZ（UTC时间）。

返回数据

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

实例ID。
Engine String MySQL

数据库类型。
StartTime String 2012-06-10T15:00Z

查询开始时间。格式：yyyy-MM-ddTHH:mmZ（UTC时间）。

EndTime String 2012-06-19T15:00Z

查询结束时间。格式：yyyy-MM-ddTHH:mmZ（UTC时间）。

PerformanceKeys Array

实例性能参数列表。
PerformanceKey

实例性能参数列表。
Key String MySQL_Sessions

性能参数。
Unit String KB

数据单位。
ValueFormat String recv_k&sent_k

性能值的格式。如果性能值由多个参数构成，以“&”分隔，例如com_delete&com_insert&com_insert_select&com_replace。
Values Array

数组格式：{value1, value2, …}。
PerformanceValue

数组格式：{value1, value2, …}。
Value String 0.0&13.6

性能值。
Date String 2011-05-30T03:29:00Z

记录日期。格式：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。

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

请求ID。

示例

请求示例


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

正常返回示例

XML 格式 

<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 格式 

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

错误码

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