调用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

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

说明 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时间)。

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

返回数据

名称 类型 示例值 描述
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
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 格式

{
    "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": []
                }
            }
        ]
    }
}

错误码

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