獲取實時監控數據
更新時間 2025-04-23 15:02:53
最近更新時間: 2025-04-23 15:02:53
分享文章
本節主要介紹如何使用API獲取實時監控數據。
此操作用來獲取HBlock的實時性能數據。
請求語法
GET /rest/v1/system/monitor/current?dimension=dimension&instanceId=instanceId&metric=metric HTTP/1.1
Date: date
Host: ip:port
Authorization: authorization請求參數
| 參數 | 類型 | 描述 | 是否必須 |
|---|---|---|---|
| dimension | String | 監控對象。 取值：
單機版默認值為system。集群版默認值為pool。 | 否 |
| instanceId | String | 監控對象實例的唯一標識，可以填寫多個，以英文逗號隔開。 取值：
如果不填寫，默認查看監控對象下的所有實例性能數據。 | 否 |
| metric | String | 指標名稱，可以填寫多個，以英文逗號隔開。指標具體描述詳見監控指標。 取值： 監控對象為system：
監控對象為pool：
監控對象為server：
監控對象為disk：
監控對象為LUN：
不填寫，默認查詢監控對象的全部指標。 | 否 |
響應結果
| 名稱 | 類型 | 描述 |
|---|---|---|
| monitoring | Array of monitoring | 監控信息集合，詳見“表1 響應參數monitoring說明”。 |
表1 響應參數monitoring說明
| 名稱 | 類型 | 描述 |
|---|---|---|
| dimension | String | 監控對象：
|
| instanceId | String | 監控對象實例：
|
| metric | String | 指標名稱。具體詳見監控指標。 |
| avgValueSeries | Array of string | 監控數據的[時間,數值]序列。 時間為unix時間戳，精確到毫秒。 |
請求示例
查詢服務器hblock_1、hblock_2的CPU使用率和內存使用率。
GET /rest/v1/system/monitor/current?dimension=server&instanceId=hblock_1,hblock_2&metric=CPU_Rate,Mem_Rate HTTP/1.1
Date: Fri, 12 Aug 2022 07:48:25 GMT
Authorization: HBlock userName:signature
Host:192.168.0.121:1443 響應示例
HTTP/1.1 200 OK
x-hblock-request-id: 2e40eab6db8440b5b5ec68f2dd5f8cf1
Connection: keep-alive
Content-Length: 455
Date: Fri, 12 Aug 2022 07:48:25 GMT
Content-Type: application/json;charset=utf-8
Server: HBlock
{
"data": {
"monitoring": [
{
"dimension": "server",
"instanceId": "hblock_1",
"metric": "CPU_Rate",
"avgValueSeries": [
[
1660290480000,
1.35
]
]
},
{
"dimension": "server",
"instanceId": "hblock_1",
"metric": "Mem_Rate",
"avgValueSeries": [
[
1660290480000,
98.15
]
]
},
{
"dimension": "server",
"instanceId": "hblock_2",
"metric": "CPU_Rate",
"avgValueSeries": [
[
1660290480000,
0.94
]
]
},
{
"dimension": "server",
"instanceId": "hblock_2",
"metric": "Mem_Rate",
"avgValueSeries": [
[
1660290480000,
97.78
]
]
}
]
}
}
