调用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分钟。
- 监控频率为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 | 想要查询的性能指标，多个值用英文逗号（,）分隔，详细参数请参见性能参数表。
说明
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 of PerformanceKey | 实例性能参数列表。 |
|
| 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 of PerformanceValue | 数组格式：{value1, value2, …}。 |
|
| PerformanceValue | |||
| 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&sent_k</ValueFormat> <Values></Values> </PerformanceKey> </PerformanceKeys> </DescribeDBInstancePerformanceResponse>
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": []
}
}
]
}
}
错误码
访问错误中心查看更多错误码。
