DescribeDrdsInstanceMonitor

更新时间:
复制 MD 格式

调用DescribeDrdsInstanceMonitor接口查询PolarDB-X实例的性能监控数据。

功能描述

根据性能参数获取某个用户实例在某个时间段范围内的性能监控数据。默认情况下(不传参数PeriodMultiple的时候)根据时间段范围不同会有不同的统计周期:
  • 当时间段范围小于1天,统计周期为5分钟。
  • 当时间段范围大于1天小于2天,统计周期为10分钟。
  • 当时间段范围大于2天小于5天,统计周期为30分钟。
  • 当时间段范围大于5天小于一周,统计周期为1小时。
  • 当时间段范围大于一周,则不支持。

请求参数

参数名类型是否必须描述
ActionString是系统规定参数,取值:DescribeDrdsInstanceMonitor。
DrdsInstanceIdString是PolarDB-X实例ID。
KeyString是性能指标,多个用英文半角“,”分隔,详情请参见性能参数表。
StartTimeLong是查询开始时间的毫秒级时间戳,例如:1542814801930。
EndTimeLong是查询结束时间的毫秒级时间戳,例如:1542944401930。
PeriodMultipleInteger否统计周期倍数,指定统计周期为5分钟×PeriodMultiple。如:PeriodMultiple=2,则统计周期为10分钟,PeriodMultiple=12,则统计周期为1小时。该参数不传则默认统计周期如功能描述所规定。
表 1. 性能参数表
KEY-VALUE描述
cpuCPU使用率(单位%)
net网络流量(单位kbps)
lqps逻辑QPS
pqps物理QPS
lrt逻辑RT(ms)
prt物理RT(ms)
con连接数
thread活跃线程数

返回值

参数名类型描述
dataList由PartialPerformanceData组成的数组。
表 2. PartialPerformanceData组成如下:
参数名类型描述
KeyString性能指标,详情请参见性能参数表。
UnitString性能数值单位。
ValuesList由PerformanceValue组成的数组。包含着指定性能指标在对应时间时的数值。
表 3. PerformanceValue组成如下:
参数名类型描述
DateLong毫秒级的时间戳。
ValueString时间对应的各项性能数值。

错误码

错误码报错信息错误描述HTTP状态码
ServiceUnableDRDS service is not enable for you服务未开通。400
ActionUnauthorizedThe specified action is not available for you权限错误。400
InvalidDRDSInstanceId.NotFoundThe DrdsInstanceId provided does not exist in our records.实例ID不存在。404
InvalidParameter.timeThe startTime and endTime must in one week时间范围最大一周。400
InvalidParameter.periodMultipleThe periodMultiple is too larger than the time between startTime and endTime统计周期倍数PeriodMultiple×5分钟得出的统计周期,超出结束时间减去开始时间的统计范围。-