API参考 - API参考 -监控管理 - DescribeDBInstancePerformance

描述

根据性能参数查看某个用户实例，某时间段范围内的性能监控数据。根据查询时间范围的不同，有如下3种输出形式：

• 当查询时间范围小于等于1天，按分钟描点性能值。[tr=transparent][/url]注意[tr=transparent]实例空间占用Key为MySQL_SpaceUsage或SQLServer_SpaceUsage，仅支持查询1天内的监控数据。
• 当查询时间范围1天到7天不支持，暂不支持。
• 当查询时间范围大于7天小于等于15天，按小时描点性能值。
• 当查询时间范围大于15天小于30天，暂不支持。
• 当查询时间范围大于等于30天小于等于1年按天描点。

请求参数

[tr=rgb(51, 205, 229)][td]名称 类型是否必须描述ActionString是系统规定参数，取值：DescribeDBInstancePerformance。DBInstanceIdString是实例名。KeyString是性能指标，多个用英文半角“,”分隔，见性能参数表。StartTimeString是查询开始时间，格式如：2012-06-11T15:00Z。EndTimeString是查询结束时间，格式如：2012-06-11T15:00Z。

返回参数

[tr=rgb(51, 205, 229)][td]名称 类型描述<公共返回参数>无详见[url=https://help.aliyun.com/document_detail/26224.html]公共参数。DBInstanceIdString实例名。EngineString数据库类型。StartTimeString查询开始时间，格式：YYYY-MM-DD’T’HH:mmZ，如2011-05-30T03:29Z。EndTimeString查询结束时间，格式：YYYY-MM-DD’T’HH:mmZ，如2011-05-30T03:29Z，大于查询开始时间。PerformanceKeysList<PerformanceKey>数组格式：{perf1, perf2, perf3, …}。

PerformanceKey参数

[tr=rgb(51, 205, 229)][td]名称 类型描述KeyString性能参数。UnitString展示单位。ValueFormatString值格式1、如果是null，则是VALUE是一个最终值2、如果不是null，则需要解析VALUE，以“&”分隔，如：com_delete&com_insert&com_insert_select&com_replace。ValuesList<PerformanceValue>数组格式：{value1, value2, …}。

PerformanceValue参数

[tr=rgb(51, 205, 229)][td]名称 类型描述ValueString性能值。DateString计算日期，格式：”yyyy-MM-dd’T’HH:mm:ssZ”，如2011-05-30T03:29:00Z。

请求示例

https://rds.aliyuncs.com/?Action=DescribeDBInstancePerformance&DBInstanceId=riauvjz6zajfiq6ba1370329449201&key= MySQL_NetworkTraffic&StartTime=2013-01-11T15:00:00Z&EndTime=2013-06-05T15:00:00Z&<公共请求参数>

返回示例

XML格式<DescribeDBInstancePerformanceResponse><RequestId>A5409D02-D661-4BF3-8F3D-0A814D0574E7</RequestId><DBInstanceID>riauvjz6zajfiq6ba1370329449201</DBInstanceID><StartTime>2013-01-11T15:00: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": riauvjz6zajfiq6ba1370329449201,"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":[]}}]}}