推送监控数据(OpenTSDB协议)

调用 n9e-server 的 /opentsdb/put 接口,POST 方法,该接口实现了 OpenTSDB 的数据协议,监控数据做成 JSON 放到 HTTP Request Body 中,举例:

  1. [
  2. {
  3. "metric": "cpu_usage_idle",
  4. "timestamp": 1637732157,
  5. "tags": {
  6. "cpu": "cpu-total",
  7. "ident": "c3-ceph01.bj"
  8. },
  9. "value": 30.5
  10. },
  11. {
  12. "metric": "cpu_usage_util",
  13. "timestamp": 1637732157,
  14. "tags": {
  15. "cpu": "cpu-total",
  16. "ident": "c3-ceph01.bj"
  17. },
  18. "value": 69.5
  19. }
  20. ]

显然,JSON 最外层是个数组,如果只上报一条监控数据,也可以不要外面的中括号,直接把对象结构上报:

  1. {
  2. "metric": "cpu_usage_idle",
  3. "timestamp": 1637732157,
  4. "tags": {
  5. "cpu": "cpu-total",
  6. "ident": "c3-ceph01.bj"
  7. },
  8. "value": 30.5
  9. }

服务端会看第一个字符是否是[,来判断上报的是数组,还是单个对象,自动做相应的 Decode。如果觉得上报的内容太过占用带宽,也可以做 gzip 压缩,此时上报的数据,要带有Content-Encoding: gzip的 Header。

注意 ident 这个标签,ident 是 identity 的缩写,表示设备的唯一标识,如果标签中有 ident 标签,n9e-server 就认为这个监控数据是来自某个机器的,会自动获取 ident 的 value,注册到监控对象的列表里