調用DescribeDBClusterPerformance接口查詢PolarDB集群的性能數據。
- 若監控頻率為5秒/次:
- 當查詢時間范圍小于等于1小時,顯示粒度為5秒。
- 當查詢時間范圍小于等于1天,顯示粒度為1分鐘。
- 當查詢時間范圍小于等于7天,顯示粒度為10分鐘。
- 當查詢時間范圍小于等于30天,顯示粒度為1小時。
- 當查詢范圍大于30天,顯示粒度為1天。
- 若監控頻率為60秒/次:
- 當查詢范圍小于等于1天,顯示粒度為1分鐘。
- 當查詢范圍小于等于7天,顯示粒度為10分鐘。
- 當查詢范圍小于等于30天,顯示粒度為1小時。
- 當查詢范圍大于30天,顯示粒度為1天。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
請求參數
名稱 | 類型 | 是否必選 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 否 | DescribeDBClusterPerformance |
系統規定參數,取值為DescribeDBClusterPerformance。 |
DBClusterId | String | 是 | pc-**************** |
集群ID。 |
EndTime | String | 是 | 2020-09-23T01:00Z |
查詢結束時間。格式為 |
Key | String | 是 | PolarDBDiskUsage |
查詢的性能指標,多個值間用英文逗號(,)分隔,詳細參數請參見性能參數表。 說明 最多可傳入5個查詢的性能指標。
|
StartTime | String | 是 | 2020-09-23T01:01Z |
查詢開始時間。格式為 |
返回數據
名稱 | 類型 | 示例值 | 描述 |
---|---|---|---|
DBClusterId | String | pc-***************** |
數據庫集群ID。 |
DBType | String | MySQL |
兼容數據庫類型。 |
DBVersion | String | 8.0 |
兼容數據庫版本。 |
EndTime | String | 2020-09-23T01:01:00Z |
查詢結束時間。格式: |
PerformanceKeys | Array of PerformanceItem |
集群性能數據列表。 |
|
PerformanceItem | |||
DBNodeId | String | pi-************* |
數據庫集群節點ID。 說明 當請求參數中
Key 的值設置為PolarDBDiskUsage 時,不會返回該參數。
|
Measurement | String | PolarDBDiskUsage |
性能指標。 |
MetricName | String | mean_data_size |
具體的性能指標度量名稱。 |
Points | Array of PerformanceItemValue |
性能數據數組。 |
|
PerformanceItemValue | |||
Timestamp | Long | 1600822800000 |
監控指標的具體時間點,格式為時間戳,單位為毫秒。 |
Value | String | 42.38 |
監控指標數據值。 |
RequestId | String | 35D3E3DA-4650-407A-BFF5-59BFF1****** |
請求ID。 |
StartTime | String | 2020-09-23T01:00:00Z |
查詢開始時間。格式: |
示例
請求示例
http(s)://polardb.aliyuncs.com/?Action=DescribeDBClusterPerformance
&DBClusterId=pc-****************
&EndTime=2020-09-23T01:00Z
&Key=PolarDBDiskUsage
&StartTime=2020-09-23T01:01Z
&<公共請求參數>
正常返回示例
XML
格式
<DescribeDBClusterPerformanceResponse>
<PerformanceKeys>
<PerformanceItem>
<Measurement>PolarDBDiskUsage</Measurement>
<MetricName>mean_binlog_size</MetricName>
<Points>
<PerformanceItemValue>
<Value>0.00</Value>
<Timestamp>1600822800000</Timestamp>
</PerformanceItemValue>
</Points>
</PerformanceItem>
<PerformanceItem>
<Measurement>PolarDBDiskUsage</Measurement>
<MetricName>mean_data_size</MetricName>
<Points>
<PerformanceItemValue>
<Value>42.38</Value>
<Timestamp>1600822800000</Timestamp>
</PerformanceItemValue>
</Points>
</PerformanceItem>
<PerformanceItem>
<Measurement>PolarDBDiskUsage</Measurement>
<MetricName>mean_log_size</MetricName>
<Points>
<PerformanceItemValue>
<Value>4393.63</Value>
<Timestamp>1600822800000</Timestamp>
</PerformanceItemValue>
</Points>
</PerformanceItem>
<PerformanceItem>
<Measurement>PolarDBDiskUsage</Measurement>
<MetricName>mean_other_log_size</MetricName>
<Points>
<PerformanceItemValue>
<Value>1.63</Value>
<Timestamp>1600822800000</Timestamp>
</PerformanceItemValue>
</Points>
</PerformanceItem>
<PerformanceItem>
<Measurement>PolarDBDiskUsage</Measurement>
<MetricName>mean_redolog_size</MetricName>
<Points>
<PerformanceItemValue>
<Value>4096.00</Value>
<Timestamp>1600822800000</Timestamp>
</PerformanceItemValue>
</Points>
</PerformanceItem>
<PerformanceItem>
<Measurement>PolarDBDiskUsage</Measurement>
<MetricName>mean_sys_dir_size</MetricName>
<Points>
<PerformanceItemValue>
<Value>11.47</Value>
<Timestamp>1600822800000</Timestamp>
</PerformanceItemValue>
</Points>
</PerformanceItem>
<PerformanceItem>
<Measurement>PolarDBDiskUsage</Measurement>
<MetricName>mean_tmp_dir_size</MetricName>
<Points>
<PerformanceItemValue>
<Value>0.00</Value>
<Timestamp>1600822800000</Timestamp>
</PerformanceItemValue>
</Points>
</PerformanceItem>
<PerformanceItem>
<Measurement>PolarDBDiskUsage</Measurement>
<MetricName>mean_undolog_size</MetricName>
<Points>
<PerformanceItemValue>
<Value>296.00</Value>
<Timestamp>1600822800000</Timestamp>
</PerformanceItemValue>
</Points>
</PerformanceItem>
</PerformanceKeys>
<DBVersion>8.0</DBVersion>
<RequestId>35D3E3DA-4650-407A-BFF5-59BFF1******</RequestId>
<EndTime>2020-09-23T01:01:00Z</EndTime>
<DBClusterId>pc-*****************</DBClusterId>
<StartTime>2020-09-23T01:00:00Z</StartTime>
<DBType>MySQL</DBType>
</DescribeDBClusterPerformanceResponse>
JSON
格式
{
"PerformanceKeys": {
"PerformanceItem": [
{
"Measurement": "PolarDBDiskUsage",
"MetricName": "mean_binlog_size",
"Points": {
"PerformanceItemValue": [
{
"Value": "0.00",
"Timestamp": 1600822800000
}
]
}
},
{
"Measurement": "PolarDBDiskUsage",
"MetricName": "mean_data_size",
"Points": {
"PerformanceItemValue": [
{
"Value": "42.38",
"Timestamp": 1600822800000
}
]
}
},
{
"Measurement": "PolarDBDiskUsage",
"MetricName": "mean_log_size",
"Points": {
"PerformanceItemValue": [
{
"Value": "4393.63",
"Timestamp": 1600822800000
}
]
}
},
{
"Measurement": "PolarDBDiskUsage",
"MetricName": "mean_other_log_size",
"Points": {
"PerformanceItemValue": [
{
"Value": "1.63",
"Timestamp": 1600822800000
}
]
}
},
{
"Measurement": "PolarDBDiskUsage",
"MetricName": "mean_redolog_size",
"Points": {
"PerformanceItemValue": [
{
"Value": "4096.00",
"Timestamp": 1600822800000
}
]
}
},
{
"Measurement": "PolarDBDiskUsage",
"MetricName": "mean_sys_dir_size",
"Points": {
"PerformanceItemValue": [
{
"Value": "11.47",
"Timestamp": 1600822800000
}
]
}
},
{
"Measurement": "PolarDBDiskUsage",
"MetricName": "mean_tmp_dir_size",
"Points": {
"PerformanceItemValue": [
{
"Value": "0.00",
"Timestamp": 1600822800000
}
]
}
},
{
"Measurement": "PolarDBDiskUsage",
"MetricName": "mean_undolog_size",
"Points": {
"PerformanceItemValue": [
{
"Value": "296.00",
"Timestamp": 1600822800000
}
]
}
}
]
},
"DBVersion": "8.0",
"RequestId": "35D3E3DA-4650-407A-BFF5-59BFF1******",
"EndTime": "2020-09-23T01:01:00Z",
"DBClusterId": "pc-*****************",
"StartTime": "2020-09-23T01:00:00Z",
"DBType": "MySQL"
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。