此操作用来获取HBlock的历史性能数据。

请求语法

GET /rest/v1/system/monitor?startTime=startTime&endTime=endTime&dimension=dimension&instanceId=instanceId1&metric=metric1,metric2 HTTP/1.1
Date: date
Host: ip:port
Authorization: authorization

请求参数

参数
描述
是否必须
startTime
查询起始时间。
类型：时间戳
取值：unix时间戳（UTC），精确到毫秒。默认值为结束时间2小时之前的时间点。
注意
起始时间必须早于结束时间，且起始时间不能早于服务器当前时间一年。
否
endTime
查询结束时间。
类型：时间戳
取值：unix时间戳（UTC），精确到毫秒。默认值为当前时间。
注意
起始时间必须早于结束时间。
否
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
                    ]
                ]
            }
        ]
    }
}