调用DescribeDBClusterPerformance查询PolarDB集群的性能数据(O引擎)_云原生数据库 PolarDB(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"
}

错误码

访问错误中心查看更多错误码。