此操作用来获取HBlock的实时性能数据。
请求语法
GET /rest/v1/system/monitor/current?dimension=dimension&instanceId=instanceId&metric=metric HTTP/1.1
Date: date
Host: ip:port
Authorization: authorization
请求参数
参数 描述 是否必须 dimension 监控对象。
类型:枚举
取值:
system:系统。
pool:存储池(仅集群版支持)。
server:服务器。
disk:数据目录所在磁盘分区。
LUN:卷。
单机版默认值为system。集群版默认值为pool。
否 instanceId 监控对象实例的唯一标识,可以填写多个,以英文逗号隔开。
类型:字符串
取值:
监控对象为system,没有实例。
监控对象为pool,实例为存储池名称。
监控对象为server,实例取值为服务器ID。
如果监控对象为disk,实例取值为“serverId+路径名称”,格式为serverId:/diskpath。
监控对象为LUN,实例取值为卷名称。
如果不填写,默认查看监控对象下的所有实例性能数据。
否 metric 指标名称,可以填写多个,以英文逗号隔开。指标具体描述详见监控指标。
类型:字符串
取值:
监控对象为system:
IOPS
R_IOPS
W_IOPS
Bandwidth
R_Bandwidth
W_Bandwidth
Latency
W_Latency
R_Latency
Path_Cap
Path_Used
Path_Rate
Path_Cap_Quota
Path_Cap_Quota_Used
Path_Cap_Quota_Rate
Cloud_Bandwidth
Cloud_U_Bandwidth
Cloud_D_Bandwidth
监控对象为pool:
IOPS
R_IOPS
W_IOPS
Bandwidth
R_Bandwidth
W_Bandwidth
Latency
W_Latency
R_Latency
Path_Cap
Path_Used
Path_Rate
Path_Cap_Quota
Path_Cap_Quota_Used
Path_Cap_Quota_Rate
监控对象为server:
CPU_Rate
Mem_Rate
Mem_Total
Mem_Used
IOPS
R_IOPS
W_IOPS
Bandwidth
R_Bandwidth
W_Bandwidth
Latency
W_Latency
R_Latency
Path_Cap
Path_Used
Path_Rate
Path_Cap_Quota
Path_Cap_Quota_Used
Path_Cap_Quota_Rate
Cloud_Bandwidth
Cloud_U_Bandwidth
Cloud_D_Bandwidth
监控对象为disk:
Path_Cap
Path_Used
Path_Rate
Path_Cap_Quota
Path_Cap_Quota_Used
Path_Cap_Quota_Rate
监控对象为LUN:
IOPS
R_IOPS
W_IOPS
Bandwidth
R_Bandwidth
W_Bandwidth
Latency
W_Latency
R_Latency
Cloud_Bandwidth
Cloud_U_Bandwidth
Cloud_D_Bandwidth
Wait_Upload
不填写,默认查询监控对象的全部指标。
否
响应结果
名称 描述 monitoring 监控信息集合,包含:dimension、instanceId、metric、avgValueSeries。
类型:数组
dimension 监控对象:
system:系统。
pool:存储池(仅集群版支持)。
server:服务器。
disk:数据目录所在磁盘分区。
LUN:卷。
instanceId 监控对象实例:
监控对象为system,显示HBlock名称。
监控对象为pool,显示存储池名称(仅集群版支持)。
监控对象为server,显示为服务器ID。
监控对象为disk,显示为数据目录。
监控对象为LUN,显示为卷名称。
metric 指标名称。具体详见监控指标。 avgValueSeries 监控数据的[时间,数值]序列。
时间为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
]
]
}
]
}
}