存入自定义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
PutMetricDatadata字段接收一个数据列表
[{
    "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超时后自动删除