調用DescribeDBClusterPerformance接口查詢PolarDB集群的性能數據。

  • 若監控頻率為5秒/次:
    • 當查詢時間范圍小于等于1小時,顯示粒度為5秒。
    • 當查詢時間范圍小于等于1天,顯示粒度為1分鐘。
    • 當查詢時間范圍小于等于7天,顯示粒度為10分鐘。
    • 當查詢時間范圍小于等于30天,顯示粒度為1小時。
    • 當查詢范圍大于30天,顯示粒度為1天。
  • 若監控頻率為60秒/次:
    • 當查詢范圍小于等于1天,顯示粒度為1分鐘。
    • 當查詢范圍小于等于7天,顯示粒度為10分鐘。
    • 當查詢范圍小于等于30天,顯示粒度為1小時。
    • 當查詢范圍大于30天,顯示粒度為1天。
說明 監控頻率默認為60秒/次,您可以調用ModifyDBClusterMonitor接口將其設置為5秒/次。

調試

您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。

請求參數

名稱 類型 是否必選 示例值 描述
Action String DescribeDBClusterPerformance

系統規定參數,取值為DescribeDBClusterPerformance

DBClusterId String pc-****************

集群ID。

EndTime String 2020-09-23T01:00Z

查詢結束時間。格式為yyyy-MM-ddTHH:mmZ(UTC時間)。

Key String PolarDBDiskUsage

查詢的性能指標,多個值間用英文逗號(,)分隔,詳細參數請參見性能參數表

說明 最多可傳入5個查詢的性能指標。
StartTime String 2020-09-23T01:01Z

查詢開始時間。格式為yyyy-MM-ddTHH:mmZ(UTC時間)。

返回數據

名稱 類型 示例值 描述
DBClusterId String pc-*****************

數據庫集群ID。

DBType String MySQL

兼容數據庫類型。

DBVersion String 8.0

兼容數據庫版本。

EndTime String 2020-09-23T01:01:00Z

查詢結束時間。格式:yyyy-MM-ddTHH:mm:ssZ(UTC時間)。

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

查詢開始時間。格式:yyyy-MM-ddTHH:mm:ssZ(UTC時間)。

示例

請求示例

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"
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。