DescribeDBInstancePerformance - 查询实例性能数据_关系型数据库-阿里云帮助中心

调用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代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作	访问级别	资源类型	条件关键字	关联操作
rds:DescribeDBInstancePerformance	READ	RDS acs:rds:{#regionId}:{#accountId}:dbinstance/{#dbinstanceId}	rds:ResourceTag	无

请求参数

名称	类型	必填	描述	示例值
DBInstanceId	string	是	实例ID。可调用DescribeDBInstances获取。	rm-uf6wjk5xxxxxxx
Key	string	是	想要查询的性能指标，多个值用半角逗号（,）分隔，最多传入30个。详细参数请参见性能参数表。说明Key为MySQL_SpaceUsage或SQLServer_SpaceUsage时，仅支持查询1天内的监控数据。	MySQL_Sessions
StartTime	string	是	查询开始时间。格式：yyyy-MM-ddTHH:mmZ（UTC时间）。说明开始和结束时间间隔需要大于您实例的监控频率，否则可能返回空列表。	2012-06-08T15:00Z
EndTime	string	是	查询结束时间。格式：yyyy-MM-ddTHH:mmZ（UTC时间）。说明开始和结束时间间隔需要大于您实例的监控频率，否则可能返回空列表。	2012-06-18T15:00Z
NodeId	string	否	实例的唯一标识。	339****

返回参数

名称	类型	描述	示例值
	object	返回参数详情如下。
EndTime	string	查询结束时间。格式：yyyy-MM-ddTHH:mmZ（UTC时间）。	2012-06-19T15:00Z
StartTime	string	查询开始时间。格式：yyyy-MM-ddTHH:mmZ（UTC时间）。	2012-06-10T15:00Z
DBInstanceId	string	实例ID。	rm-uf6wjk5xxxxxxxxxx
Engine	string	数据库类型。	MySQL
RequestId	string	请求ID。	A5409D02-D661-4BF3-8F3D-0A814D0574E7
PerformanceKeys	object []	实例性能参数列表。
Key	string	性能参数。	MySQL_Sessions
ValueFormat	string	性能值的格式。说明如果性能值由多个参数构成，以“&”分隔，例如com_delete&com_insert&com_insert_select&com_replace。	recv_k&sent_k
Unit	string	数据单位。	KB
Values	object []	数组格式：{value1, value2, …}。
Date	string	记录日期。格式：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。	2011-05-30T03:29:00Z
Value	string	性能值。	0.0&13.6

示例

正常返回示例

JSON格式

{
  "EndTime": "2012-06-19T15:00Z",
  "StartTime": "2012-06-10T15:00Z",
  "DBInstanceId": "rm-uf6wjk5xxxxxxxxxx",
  "Engine": "MySQL",
  "RequestId": "A5409D02-D661-4BF3-8F3D-0A814D0574E7",
  "PerformanceKeys": {
    "PerformanceKey": [
      {
        "Key": "MySQL_Sessions",
        "ValueFormat": "recv_k&sent_k",
        "Unit": "KB",
        "Values": {
          "PerformanceValue": [
            {
              "Date": "2011-05-30T03:29:00Z",
              "Value": "0.0&13.6"
            }
          ]
        }
      }
    ]
  }
}

错误码

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