調用CES API查看數據倉庫服務（DWS）監控指導

調用CES API查看dws監控指導

首先要獲取用戶的token，詳細創建步驟如下：

1 獲取IAM用戶Token（使用密碼）

該接口可以用于通過用戶名/密碼的方式進行認證來獲取IAM用戶Token。

Token是系統頒發給IAM用戶的訪問令牌，承載用戶的身份、權限等信息。調用IAM以及其他云服務的接口時，可以使用本接口獲取的IAM用戶token進行鑒權。

POST /v3/auth/tokens

參數

是否必選

參數類型

描述

domain

是

Object

IAM用戶所屬賬號信息。

name

是

String

IAM用戶名。

password

是

String

IAM用戶的登錄密碼。

在節點的運維容器中執行。

curl -i -H 'Connection:keep-alive' -H 'Content-Type:application/json;charset=UTF-8' -H 'Accept:application/json'-d '{

"auth": {

"identity": {

"methods": [

"password"

],

"password": {

"user": {

"domain": {

"name": "IAMDomain"

},

"name": "IAMUser",

"password": "IAMPassword"

}

}

},

"scope": {

"project": {

"name": "cn-north-1(regionName)"

}

}

}

}' -k ?https://{iam域名}:31943/v3/auth/tokens

2 獲取IAM用戶Token（使用AK、SK。天翼云目前租戶側不支持通過密碼的方式獲取token，只能使用這種方式）

該接口可以用于通過用AK SK的方式進行認證來獲取IAM用戶Token。

Token是系統頒發給IAM用戶的訪問令牌，承載用戶的身份、權限等信息。調用IAM以及其他云服務的接口時，可以使用本接口獲取的IAM用戶token進行鑒權。

POST /v3/auth/tokens

參數

是否必選

參數類型

描述

access

是

String

IAM用戶AK。（console的身份憑證中可以查詢到）

secret

是

String

IAM用戶SK。（創建ak時會生成對應的sk）

在節點的運維容器中執行。

curl -i -X POST -H 'Connection:keep-alive' -H 'Content-Type:application/json;charset=UTF-8' -H 'Accept:application/json' -d '{

"auth": {

"identity": {

"methods": ["hw_ak_sk"],

"hw_ak_sk": {

"access": {

"key": ""

},

"secret": {

"key": ""

}

}

},

"scope": {

"project": {

"name": "cn-north-1(regionName)"

}

}

}

}' -k ?https://{iam域名}:31943/v3/auth/tokens

3 查詢CES dws的監控數據

查詢指定時間范圍指定指標的指定粒度的監控數據，可以通過參數指定需要查詢的數據維度。

GET /V1.0/{project_id}/metric-data?namespace={namespace}&metric_name={metric_name}&dim.{i}=key,value&from={from}&to={to}&period={period}&filter={filter}

名稱

是否必選

參數類型

說明

project_id

是

String

·???????? 項目ID

namespace

是

String

默認：SYS.DWS

metric_name

是

String

指標名稱，可通過3.4集群監控指標獲取已有的告警規則的指標名。

from

是

String

查詢數據起始時間，UNIX時間戳，單位毫秒。建議from的值相對于當前時間向前偏移至少1個周期。由于聚合運算的過程是將一個聚合周期范圍內的數據點聚合到周期起始邊界上，如果將from和to的范圍設置在聚合周期內，會因為聚合未完成而造成查詢數據為空，所以建議from參數相對于當前時間向前偏移至少1個周期。以5分鐘聚合周期為例：假設當前時間點為10:35，10:30~10:35之間的原始數據會被聚合到10:30這個點上，所以查詢5分鐘數據點時from參數應為10:30或之前。

說明：

云監控會根據所選擇的聚合粒度向前取整from參數。

to

是

String

查詢數據截止時間UNIX時間戳，單位毫秒。from必須小于to。

period

是

Integer

監控數據粒度。

取值范圍：

·???????? 1，實時數據

·???????? 300，5分鐘粒度

·???????? 1200，20分鐘粒度

·???????? 3600，1小時粒度

·???????? 14400，4小時粒度

·???????? 86400，1天粒度

filter

是

String

數據聚合方式，支持的聚合方式如下:

·???????? average：聚合周期內指標數據的平均值。

·???????? max：聚合周期內指標數據的最大值。

·???????? min：聚合周期內指標數據的最小值。

·???????? sum：聚合周期內指標數據的求和值。

·???????? variance：聚合周期內指標數據的方差。

說明：

聚合運算的過程是將一個聚合周期范圍內的數據點根據相應的聚合算法聚合到周期起始邊界上，以5分鐘聚合周期為例：假設當前時間點為10:35，則10:30~10:35之間的原始數據會被聚合到10:30這個時間點。

dim

是

String

指標的維度，目前最大支持3個維度，維度編號從0開始；維度格式為dim.{i}=key,value，key的最大長度32，value的最大長度為256。

以下維度說明僅為實例。

單維度：dim.0=datastore_id,i-12345

多維度：dim.0=datastore_id,i-12345&dim.1=dws_instance_id,i-1234

樣例：

curl -i -X GET -H 'Connection:keep-alive' -H 'Content-Type:application/json;charset=UTF-8' -H 'Accept:application/json' -H "X-Auth-Token:{步驟1或2獲取的token}" -k 'https://{CES公網域名}/V1.0/{project_id}/metric-data?namespace=SYS.DWS&metric_name=dws015_disk_usage&dim.0=dws_instance_id,4ee28efd-3923-4965-b3d8-3786999438d6&from=1618192342747&to=1618195942747&period=1&filter=average'

響應參數

指標數據列表。詳細參數請參見下表。

由于查詢數據時，云監控會根據所選擇的聚合粒度向前取整from參數，所以datapoints中包含的數據點有可能會多于預期

{

"datapoints": [

{

"average": 0.07,

"timestamp": 1442341200000,

"unit": "Ratio"

}

],

"metric_name": "dws015_disk_usage"

}

通過云監控提供的數據倉庫服務相關監控指標，用戶可以獲取有關集群運行狀況和性能的信息，并深入了解節點級別的對應信息。

數據倉庫服務相關監控指標。

指標ID

指標名稱

含義

取值范圍

測量對象&維度

監控周期（原始指標）

dws001_shared_buffer_hit_ratio

緩存命中率

該指標用于表示需要訪問的數據，在內存中可以直接獲取的數據量比例，以百分比為單位。

0%～100%

測量對象：數據倉庫集群

測量維度：datastore_id

4分鐘

dws002_in_memory_sort_ratio

內存中排序比率

該指標用于表示在數據進行排序時，可以直接在內存中排序的數據量比例，以百分比為單位。

0%～100%

測量對象：數據倉庫集群

測量維度：datastore_id

4分鐘

dws003_physical_reads

文件讀取次數

該指標用于表示讀取數據庫文件的累計次數。

> 0

測量對象：數據倉庫集群

測量維度：datastore_id

4分鐘

dws004_physical_writes

文件寫入次數

該指標用于表示寫入數據庫文件的累計次數。

> 0

測量對象：數據倉庫集群

測量維度：datastore_id

4分鐘

dws005_physical_reads_per_second

每秒文件讀取次數

該指標用于表示每秒讀取數據庫文件的次數。

≥ 0

測量對象：數據倉庫集群

測量維度：datastore_id

4分鐘

dws006_physical_writes_per_second

每秒文件寫入次數

該指標用于表示每秒寫入數據庫文件的次數。

≥ 0

測量對象：數據倉庫集群

測量維度：datastore_id

4分鐘

dws007_db_size

數據量大小

該指標用于表示數據庫中所有數據總量大小。

單位：兆字節（MB）

0MB～36000MB

測量對象：數據倉庫集群

測量維度：datastore_id

4分鐘

dws008_active_sql_count

活躍SQL數

該指標用于表示數據庫當前活動的SQL個數。

≥ 0

測量對象：數據倉庫集群

測量維度：datastore_id

4分鐘

dws009_session_count

會話數

該指標用于表示數據庫當前訪問的連接個數。

≥ 0

測量對象：數據倉庫集群

測量維度：datastore_id

4分鐘

dws010_cpu_usage

CPU使用率

該指標用于統計每個集群節點的CPU使用率，以百分比為單位。

0%～100%

測量對象：數據倉庫節點

測量維度：dws_instance_id

1分鐘

dws011_mem_usage

內存使用率

該指標用于統計每個集群節點的內存使用率，以百分比為單位。

0%～100%

測量對象：數據倉庫節點

測量維度：dws_instance_id

1分鐘

dws012_iops

IOPS

該指標用于統計每個集群節點每秒處理的I/O請求數量。

≥ 0

測量對象：數據倉庫節點

測量維度：dws_instance_id

1分鐘

dws013_bytes_in

網絡輸入吞吐量

該指標用于統計每秒從網絡輸入每個集群節點的數據總量。

單位：字節/秒

≥ 0字節/秒

測量對象：數據倉庫節點

測量維度：dws_instance_id

1分鐘

dws014_bytes_out

網絡輸出吞吐量

該指標用于統計從每個節點每秒發送到網絡的數據總量。

單位：字節/秒

≥ 0字節/秒

測量對象：數據倉庫節點

測量維度：dws_instance_id

1分鐘

dws015_disk_usage

磁盤利用率

該指標用于統計每個集群節點的磁盤使用情況，以百分比為單位。

0%～100%

測量對象：數據倉庫節點

測量維度：dws_instance_id

1分鐘

dws016_disk_total_size

磁盤總大小

該指標用于統計每個集群節點的數據磁盤總大小。

單位：吉字節（GB）

100GB～2000GB

測量對象：數據倉庫節點

測量維度：dws_instance_id

1分鐘

dws017_disk_used_size

磁盤使用量

該指標用于統計每個集群節點的數據磁盤已用大小。

單位：吉字節（GB）

0GB～3600GB

測量對象：數據倉庫節點

測量維度：dws_instance_id

1分鐘

dws018_disk_read_throughput

磁盤讀吞吐量

該指標用于統計集群節點數據磁盤每秒讀取的數據量。

單位：字節/秒

≥ 0字節/秒

測量對象：數據倉庫節點

測量維度：dws_instance_id

1分鐘

dws019_disk_write_throughput

磁盤寫吞吐量

該指標用于統計集群節點數據磁盤每秒寫入的數據量。

單位：字節/秒

≥ 0字節/秒

測量對象：數據倉庫節點

測量維度：dws_instance_id

1分鐘

dws020_avg_disk_sec_per_read

磁盤讀耗時

該指標用于統計集群節點數據磁盤每次讀取數據的平均耗時。

單位：秒

> 0秒

測量對象：數據倉庫節點

測量維度：dws_instance_id

1分鐘

dws021_avg_disk_sec_per_write

磁盤寫耗時

該指標用于統計集群節點數據磁盤每次寫入數據的平均耗時。

單位：秒

> 0秒

測量對象：數據倉庫節點

測量維度：dws_instance_id

1分鐘

dws022_avg_disk_queue_length

磁盤平均隊列長度

該指標用于統計每個集群節點數據磁盤平均的I/O隊列長度。

≥ 0

測量對象：數據倉庫節點

測量維度：dws_instance_id

1分鐘

維度

Key

Value

datastore_id

數據倉庫集群ID

dws_instance_id

數據倉庫節點ID

EI企業智能 Gauss AP 數據倉庫服務 GaussDB(DWS)

版權聲明：本文內容由網絡用戶投稿，版權歸原作者所有，本站不擁有其著作權，亦不承擔相應法律責任。如果您發現本站中有涉嫌抄襲或描述失實的內容，請聯系我們jiasou666@gmail.com 處理，核實后本網站將在24小時內刪除侵權內容。

版權聲明：本文內容由網絡用戶投稿，版權歸原作者所有，本站不擁有其著作權，亦不承擔相應法律責任。如果您發現本站中有涉嫌抄襲或描述失實的內容，請聯系我們jiasou666@gmail.com 處理，核實后本網站將在24小時內刪除侵權內容。