自定义监控
自定义监控: 数据上报接口
功能介绍
用户上报自定义监控数据
接口约束
- 一次请求,只能上报小于等于100个监控指标
- 每个指标的标签数要小于等于3
URI
POST /api/v1/metric/custom/upload
请求参数
请求头
参数 | 参数类型 | 是否必填 | 示例 | 说明 | 下级对象 |
---|---|---|---|---|---|
Content-Length | Integer | 否 | 111 | RFC 2616中定义的HTTP请求的Body长度。请求Body按UTF-8编码后的字节数。 | |
Content-Type | String | 否 | application/json | 发送端发送的实体数据的数据类型。只支持application/json。 |
请求体参数
参数 | 参数类型 | 是否必填 | 示例 | 说明 | 下级对象 |
---|---|---|---|---|---|
dimensions | Objects | 否 | {"key1":"val1"} | 最多只能有3个key,是指标的标签 | |
metric | String | 是 | 528bf4e3-0f1b-8d34-bc23-adaa43c0b87c | 监控项的id | |
values | Object | 否 | {value: 10.1} | 监控项的值 |
响应参数
参数 | 参数类型 | 说明 | 示例 |
---|---|---|---|
code | Integer | 返回状态码(0成功,非0失败) | 0 |
msg | String | 返回信息 | 成功,失败 |
currentTime | Integer | 响应返回时间戳 | 1688114897 |
result | Object | 返回对象,本接口统一为空 | {} |
请求示例
POST /api/v1/metric/custom/upload
请求体body
[
{
"dimensions":{
"key1":"value1"
},
"metricName":"528bf4e3-0f1b-8d34-bc23-adaa43c0b87c",
"values":{
"value":10
}
},
{
"dimensions":{
"key1":"value1",
"key2":"value2"
},
"metricName":"0c83bbba-cf3f-4748-8234-55a11df7575c",
"values":{
"value":10.1
}
}
]
响应示例
{
"code":0,
"result":{},
"msg":"成功",
"currentTime":1688114897
}