调用DescribeDrdsInstanceDbMonitor接口查询数据库的性能监控数据。

功能描述

根据性能参数获取某个用户实例在某个时间段范围内的性能监控数据。根据时间段范围不同会有不同的统计周期:

  • 当时间段范围小于1天,统计周期为5分钟。
  • 当时间段范围大于1天小于2天,统计周期为10分钟。
  • 当时间段范围大于2天小于5天,统计周期为30分钟。
  • 当时间段范围大于5天小于一周,统计周期为1小时。
  • 当时间段范围大于一周,则不支持。

请求参数

参数名 类型 是否必须 描述
Action String 系统规定参数,取值:DescribeDrdsInstanceDbMonitor。
DrdsInstanceId String 数据库所属的PolarDB-X实例ID。
DbName String 数据库名称。
Key String 性能指标,多个用英文半角“,”分隔,详情请参见性能参数表。
StartTime Long 查询开始时间的毫秒级时间戳,例如:1542814801930。
EndTime Long 查询结束时间的毫秒级时间戳,例如:1542944401930。
表 1. 性能参数表
KEY-VALUE 描述
qps 每秒处理请求数。
con 连接数。
thread 活跃线程数。

返回值

参数名 类型 描述
Data List 由PartialPerformanceData组成的数组。
表 2. PartialPerformanceData组成如下:
参数名 类型 描述
Key String 性能指标,详情请参见性能参数表。例外(如果请求的性能指标时net,则返回输入流量netin和输出流量netout俩个性能数值)。
Unit String 性能数值单位。
Values List 由PerformanceValue组成的数组。包含着指定性能指标在对应时间时的数值。
表 3. PerformanceValue组成如下:
参数名 类型 描述
Date Long 毫秒级的时间戳。
Value String 时间对应的各项性能数值。

错误码

错误码 报错信息 错误描述 HTTP 状态码
ServiceUnable DRDS service is not enable for you 服务未开通。 400
ActionUnauthorized The specified action is not available for you 权限错误。 400
InvalidDRDSInstanceId.NotFound The DrdsInstanceId provided does not exist in our records. 实例ID不存在。 404
InvalidDbName.NotFound The Drds DbName provided does not exist in our records. 数据库不存在。 404
InvalidParameter.time The startTime and endTime must in one week 时间范围最大一周。 400