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