此操作用来修改pushgateway监控配置。

请求语法

PUT /rest/v1/system/config/monitor?serverId=serverid1,serverid2,serveridN HTTP/1.1
Date: date
Content-Type: application/json; charset=utf-8
Content-Length: length
Host: ip:port
Authorization: authorization

{
    "pushgateway":address:port,
    "pushgatewayTimeout":pushgatewayTimeout,
    "pushgatewayLabels": {
        "key1": "value1",
        "key2": "value2",
        "key3": "value3",
...
    },
    "changeAll": changeAll,
    "collectInterval": collectInterval,
    "collectMetric": name,
    "collectMetricItems": [
        "item1",
        "item2",
        "item3",
...
    ],
}

请求参数

参数
描述
是否必须
serverId
指定要修改pushgateway监控配置的HBlock服务器ID。一次可以指定多个HBlock服务器的ID，以英文逗号（,）分开。如果不填写，默认为所有HBlock服务器修改pushgateway监控配置。
类型：字符串
否
pushgateway
指定pushgateway的地址和接口。
类型：字符串
取值：格式为"ipv4":"port"、"[ipv6]:"port"或者"domain-name":"port"。
是
pushgatewayTimeout
向pushgateway发送数据的超时时间。
类型：长整型
取值：[1000, 1000000]，单位为毫秒。
否
pushgatewayLabels
指定pushGateway对应的标签值。
类型：字符串
取值：格式为"key":"value"。
否
changeAll
修改配置时，以覆盖方式更新，还是以添加方式更新。主要针对pushgatewayLabels和collectMetricItems参数的设置。
注意
如果未指定collectMetricItems，也未指定pushgatewayLabels，则此参数不起作用。
类型：布尔
取值：
true：配置以覆盖方式更新。
false：配置以添加方式更新。
默认值为false。
否
collectInterval
指定采集时间间隔。
类型：长整型
取值：整型，取值为[2000, 1000000]，单位为毫秒。
否
collectMetric
指定采集的监控指标。
类型：枚举
取值为：server、fileSystem、interface、load、disk、tcp、os。
默认采集的上述所有监控指标。
否
collectMetricItems
指定监控指标下的配置项。目前仅监控指标disk、fileSystem、interface可以指定配置项。
说明
如果指定collectMetric，未指定配置项，默认修改指定collectMetric下的所有配置项。
如果未指定collectMetric，不能指定此参数。
类型：字符串
否

请求示例1

为服务器hblock_2、hblock_3修改pushgateway监控配置。

PUT /rest/v1/system/config/monitor?serverId=hblock_3,hblock_2 HTTP/1.1
Date: Fri, 24 May 2024 02: 59: 53 GMT
Content-Type: application/json; charset=utf-8
Authorization: HBlock userName:signature
Content-Length: 317
Host: 192.168.0.110: 1443 

{
    "pushgateway": "192.168.0.1:9091",
    "pushgatewayTimeout": 3000,
    "pushgatewayLabels": {
        "agent": "ctyunoos",
        "idc": "2"
    },
    "changeAll": true,
    "collectInterval": 5000,
    "collectMetric": "disk",
    "collectMetricItems": [
        "tmpfs",
        "cgroup"
    ]
}

响应示例1

HTTP/1.1 204 No Content 
x-hblock-request-id: a097237d448f4371a8838df64e753f3e
Connection: keep-alive
Date: Fri, 24 May 2024 02:59:53 GMT
Server: HBlock

请求示例2

为所有服务器修改pushgateway监控配置。

PUT /rest/v1/system/config/monitor HTTP/1.1
Date: Fri, 24 May 2024 05:55:52 GMT
Content-Type: application/json; charset=utf-8
Authorization: HBlock userName:signature
Content-Length: 318
Host: 192.168.0.110:1443 

{
    "pushgateway": "192.168.0.1:9091",
    "pushgatewayTimeout": 3000,
    "pushgatewayLabels": {
        "agent": "ctyun",
        "idc": "3"
    },
    "changeAll": false,
    "collectInterval": 5000,
    "collectMetric": "disk",
    "collectMetricItems": [
        "pstore",
        "devpts"
    ]
}

响应示例2

HTTP/1.1 204 No Content 
x-hblock-request-id: 860024bc04814789b55f9d662914922a
Connection: keep-alive
Date: Fri, 24 May 2024 05:55:52 GMT
Server: HBlock