存入自定义metric数据 (PutMetricData)
Note: 该API与UI无关,UI设计无需考虑
用户可以使用PutMetricData
将时序数据存入ZStack的后端时序数据库中,并使用ZWatch提供的API对时序数据进行操作,方便用户实现自定义metric。例如用户希望将一个MySQL也纳入ZWatch的监控中,则可以通过脚本获得MySQL的并发连接数,周期性的调用PutMetricData
API将数据导入,然后就可以使用ZWatch的报警器对该MySQL实例的最大连接数进行报警。
PutMetricData namespace=MyNamespace data='[{"metricName":"MySQLMaxConnections", "value":1000, "labels":{"ip":"10.0.0.10"}}]'
参数(Parameters)
名字 | 描述 | 可选的 | 可选的参数值 | 起始支持版本 |
---|---|---|---|---|
namespace | 自定义名字空间名称 | 2.3 | ||
data | 数据 | 2.3 | ||
userTags | 用户标签,请参见 创建用户标签(CreateUserTag) | 是 | 2.3 | |
systemTags | 系统标签,请参见 创建系统标签(CreateSystemTag) | 是 | 2.3 | |
timeout | 是 |
PutMetricData
的data
字段接收一个数据列表[{
"metricName": "MySQLMaxConnections",
"value": 1000,
"labels": {
"ip": "10.0.0.10"
}
}]
- metricName: metric名称
- value: 整数或浮点数的数据值
- labels:自定义标签
可以同时push多个属于一个namespace的多个metric:
[{
"metricName": "MySQLMaxConnections",
"value": 1000,
"labels": {
"ip": "10.0.0.10"
}
}, {
"metricName": "MySQLMemory",
"value": 1999999999999,
"labels": {
"ip": "10.0.0.10"
}
}]
Note: namespace和metric在存入数据时自动创建。没有API删除namespace和metric,数据会在其TTL超时后自动删除