增加iotdb数据监控

增加iotdb数据监控

Author: kechangqing

README.md

@@ -38,7 +38,7 @@
 * 灵活的报警消息`Freemarker`模板定制，支持变量占位符；消息模板管理
 * 分布式调度实现，每个监控都是独立调度，互不影响
 * 报警消息附带日志查询短链接，直达报警原因
-* 数值同比监控
+* 数值同比，环比监控
 * `HTTP`数据监控, `Javascript`表达式判断是否报警; `PING`连通监控
 * 前端简单易用：监控管理、测试、另存、执行日志和历史消息
 * `Elasticsearch`数据查询、分享和下载
@@ -181,6 +181,7 @@ mvn -U clean package -DskipTests=true
 </tr>
 <tr>
 <td><a href="./doc/wiki/ring-compare.md" target="_blank">数值环比监控使用指南</a></td>
+<td><a href="./doc/wiki/iotdb.md" target="_blank">iotdb数据监控使用指南</a></td>
 </tr>
 </table>
 
@@ -230,15 +231,20 @@ yarn dev
 * ~~【0.8】frostmourne-core改名为frostmourne-common~~ [2022-05-18]
 * ~~【0.8】增加国际化支持~~ [2022-05-28]
 * ~~【0.8】mysql, clickhouse表达式规则增加TOP 50条记录数据TOP_N_DOCUMENTS~~ [2022-05-31]
-* ~~【0.8】Elasticsearch监控数值实现环比监控~~ [2022-06-07]
+* ~~【0.8】Elasticsearch数值实现环比监控~~ [2022-06-07]
 * ~~【0.8】bugfix: 解决消息模板列表模板类型不显示的问题~~ [2022-06-07]
-* 增加 [iotdb](https://github.com/apache/iotdb) 数据监控报警
+* ~~【0.8】influxdb数值实现环比监控~~ [2022-06-09]
+* ~~【0.8】增加 [iotdb](https://github.com/apache/iotdb) 数据监控报警~~ [2022-06-09]
 * 发布0.8-RELEASE, 进入0.9开发
 * 增加本项目内程序日志采集至MySQL并提供查询页面，方便排查问题和监控
 * Elasticsearch数据名增加kibana链接配置，在数据查询页面增加kibana地址跳转链接，方便将数据查询切换至kibana
 * 短信报警方式实现，默认用阿里云短信实现
+* 增加telnet端口连通监控
+* 页面展示文字支持英文切换
 * 增加 [loki](https://github.com/grafana/loki) 数据监控报警
 * 增加 [redis](https://github.com/redis/redis) 数据监控报警
+* 增加 [SqlServer] 数据监控报警
+* 数据源列表页面增加数据源图标列，方便区分
 * 增加邮箱在线配置页面功能
 * 增加企业微信在线配置页面功能
 * 将短链接id以16进制格式展示，解决id数字很大的时候较长的问题
@@ -270,7 +276,6 @@ yarn dev
 
 ### 1.0-RELEASE核心Feature后续计划
 
-* 增加 [iotdb](https://github.com/apache/iotdb) 数据监控报警
 * 增加本项目内程序日志采集至MySQL并提供查询页面，方便排查问题和监控
 * 增加 [skywalking](https://github.com/apache/skywalking) `Database Layer` 数据监控报警支持
 * 增加 [loki](https://github.com/grafana/loki) 数据监控报警

ReleaseNotes.md

@@ -7,7 +7,9 @@
 * 【0.8】增加报警升级功能 [2022-05-15]
 * 【0.8】增加国际化支持 [2022-05-28]
 * 【0.8】mysql, clickhouse表达式规则增加TOP 50条记录数据TOP_N_DOCUMENTS [2022-05-31]
-* 【0.8】Elasticsearch监控数值实现环比监控 [2022-06-07]
+* 【0.8】Elasticsearch数值实现环比监控 [2022-06-07]
+* 【0.8】influxdb数值实现环比监控 [2022-06-09]
+* 【0.8】增加 [iotdb](https://github.com/apache/iotdb) 数据监控报警 [2022-06-09]
 
 ### BugFix
 
@@ -23,6 +25,7 @@
 ### Others
 
 * 【0.8】frostmourne-core改名为frostmourne-common [2022-05-18]
+* 【0.8】metric注入逻辑重构，去掉metric map构造改成自动注入 [2022-06-09]
 
 # 0.7.1-RELEASE
 

doc/img/iotdb/iotdb-dataname.png

@@ -0,0 +1,91 @@
+## iotdb数据监控指南
+
+### 1. 添加iotdb数据源。如下图：
+
+<img src="../img/iotdb/iotdb-datasource.png"/>
+
+其中服务地址填写rest服务地址，如:
+
+```
+http://127.0.0.1:18080
+```
+
+### 2. 添加iotdb数据名。如下图
+
+<img src="../img/iotdb/iotdb-dataname.png"/>
+
+### 3. 编辑监控
+
+#### 3.1 iotdb查询语法
+
+数据选择上边创建的
+
+查询语句举例如下：
+
+```
+select s3, s4, s3 + 1 from root.sg27 limit 2
+```
+
+<img src="../img/iotdb/iotdb-metric.png"/>
+
+关于iotdb查询语法，请参考[iotdb官方文档](https://github.com/apache/iotdb)。
+举例仅用于展示查询语法和字段，具体自己根据需要修改。配置报警规则之后，可以预览数据。
+
+#### 3.2 iotdb查询返回数据格式
+
+返回数据举例：
+
+```json
+{
+  "expressions": [
+    "root.sg27.s3",
+    "root.sg27.s4",
+    "root.sg27.s3 + 1"
+  ],
+  "columnNames": null,
+  "timestamps": [
+    1635232143960,
+    1635232153960
+  ],
+  "timestampsIso8601": [
+    "2021-10-26T15:09:03.960+08:00",
+    "2021-10-26T15:09:13.960+08:00"
+  ],
+  "values": [
+    [
+      11,
+      null
+    ],
+    [
+      false,
+      true
+    ],
+    [
+      12.0,
+      null
+    ]
+  ]
+}
+```
+
+### 4. 报警规则
+
+报警规则可以根据返回数据，使用表达式判断，如：
+
+```
+values != null && values.length > 0 && values[0][0] != null && values[0][0] >= 1
+```
+
+<img src="../img/iotdb/iotdb-rule.png"/>
+
+### 5. 消息模板
+
+消息模板可根据响应数据自己定制，下边举例供参考使用：
+
+```
+cpu利用率${values[0][0]}超过阈值1，请关注。
+```
+
+### 6. 测试监控
+
+填完其他必填选项，可以先测试一下监控，看看效果。测试完保存即可。

doc/img/iotdb/iotdb-datasource.png

@@ -5,7 +5,7 @@
     <parent>
         <artifactId>frostmourne</artifactId>
         <groupId>com.autohome</groupId>
-        <version>0.8-SNAPSHOT</version>
+        <version>0.8-RELEASE</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
     <artifactId>frostmourne-common</artifactId>

doc/img/iotdb/iotdb-metric.png

@@ -5,7 +5,7 @@
     <parent>
         <groupId>com.autohome</groupId>
         <artifactId>frostmourne</artifactId>
-        <version>0.8-SNAPSHOT</version>
+        <version>0.8-RELEASE</version>
     </parent>
     <artifactId>frostmourne-monitor</artifactId>
     <name>frostmourne-monitor</name>