調(diào)用DescribeDrdsInstanceMonitor接口查詢PolarDB-X實例的性能監(jiān)控數(shù)據(jù)。

功能描述

根據(jù)性能參數(shù)獲取某個用戶實例在某個時間段范圍內(nèi)的性能監(jiān)控數(shù)據(jù)。默認情況下（不傳參數(shù)PeriodMultiple的時候）根據(jù)時間段范圍不同會有不同的統(tǒng)計周期：
  • 當時間段范圍小于1天，統(tǒng)計周期為5分鐘。
  • 當時間段范圍大于1天小于2天，統(tǒng)計周期為10分鐘。
  • 當時間段范圍大于2天小于5天，統(tǒng)計周期為30分鐘。
  • 當時間段范圍大于5天小于一周，統(tǒng)計周期為1小時。
  • 當時間段范圍大于一周，則不支持。

請求參數(shù)

參數(shù)名 類型 是否必須 描述
Action String 是 系統(tǒng)規(guī)定參數(shù)，取值：DescribeDrdsInstanceMonitor。
DrdsInstanceId String 是 PolarDB-X實例ID。
Key String 是 性能指標，多個用英文半角“,”分隔，詳情請參見表 1。
StartTime Long 是 查詢開始時間的毫秒級時間戳，例如：1542814801930。
EndTime Long 是 查詢結(jié)束時間的毫秒級時間戳，例如：1542944401930。
PeriodMultiple Integer 否 統(tǒng)計周期倍數(shù)，指定統(tǒng)計周期為5分鐘×PeriodMultiple。如：PeriodMultiple=2，則統(tǒng)計周期為10分鐘，PeriodMultiple=12，則統(tǒng)計周期為1小時。該參數(shù)不傳則默認統(tǒng)計周期如功能描述所規(guī)定。
表 1. 性能參數(shù)表
KEY-VALUE 描述
cpu CPU使用率（單位%）
net 網(wǎng)絡流量（單位kbps）
lqps 邏輯QPS
pqps 物理QPS
lrt 邏輯RT（ms）
prt 物理RT（ms）
con 連接數(shù)
thread 活躍線程數(shù)

返回值

參數(shù)名 類型 描述
data List 由PartialPerformanceData組成的數(shù)組。
表 2. PartialPerformanceData組成如下：
參數(shù)名 類型 描述
Key String 性能指標，詳情請參見表 1。
Unit String 性能數(shù)值單位。
Values List 由PerformanceValue組成的數(shù)組。包含著指定性能指標在對應時間時的數(shù)值。
表 3. PerformanceValue組成如下：
參數(shù)名 類型 描述
Date Long 毫秒級的時間戳。
Value String 時間對應的各項性能數(shù)值。

錯誤碼

錯誤碼 報錯信息 錯誤描述 HTTP狀態(tài)碼
ServiceUnable DRDS service is not enable for you 服務未開通。 400
ActionUnauthorized The specified action is not available for you 權(quán)限錯誤。 400
InvalidDRDSInstanceId.NotFound The DrdsInstanceId provided does not exist in our records. 實例ID不存在。 404
InvalidParameter.time The startTime and endTime must in one week 時間范圍最大一周。 400
InvalidParameter.periodMultiple The periodMultiple is too larger than the time between startTime and endTime 統(tǒng)計周期倍數(shù)PeriodMultiple×5分鐘得出的統(tǒng)計周期，超出結(jié)束時間減去開始時間的統(tǒng)計范圍。 -