Skip to main content
版本:v1.1.x

依赖时序数据库服务IoTDB安装初始化

HertzBeat的历史数据存储依赖时序数据库 IoTDB 或 TDengine,任选其一安装初始化即可,也可不安装(注意⚠️不安装则无历史图表数据)

Apache IoTDB是一体化收集、存储、管理与分析物联网时序数据的软件系统,我们使用其存储分析采集到的监控指标历史数据。

注意⚠️ IoTDB为可选项,未配置则无历史图表数据,支持V0.12 - V0.13版本,推荐使用V0.13.*版本。

如果您已有IoTDB环境,可直接跳到YML配置那一步。

通过Docker方式安装IoTDB

可参考官方网站安装教程

  1. 下载安装Docker环境
    Docker 工具自身的下载请参考 Docker官网文档。 安装完毕后终端查看Docker版本是否正常输出。
    $ docker -v
    Docker version 20.10.12, build e91ed57
  2. Docker安装IoTDB
$ docker run -d -p 6667:6667 -p 31999:31999 -p 8181:8181 \
-v /opt/iotdb/data:/iotdb/data \
--name iotdb \
apache/iotdb:0.13.3-node

-v /opt/iotdb/data:/iotdb/data 为tdengine数据目录本地持久化挂载,需将/iotdb/data替换为实际本地存在的目录 使用$ docker ps查看数据库是否启动成功

  1. 在hertzbeat的application.yml配置文件配置IoTDB数据库连接

    配置HertzBeat的配置文件
    修改位于 hertzbeat/config/application.yml 的配置文件
    注意⚠️docker容器方式需要将application.yml文件挂载到主机本地,安装包方式解压修改位于 hertzbeat/config/application.yml 即可
    替换里面的warehouse.store.iot-db数据源参数,HOST账户密码等

warehouse:
store:
iot-db:
enabled: true
host: 127.0.0.1
rpc-port: 6667
username: root
password: root
# V_O_12 || V_0_13
version: V_0_13
# if iotdb version >= 0.13 use default queryTimeoutInMs = -1; else use default queryTimeoutInMs = 0
query-timeout-in-ms: -1
# 数据存储时间:默认'7776000000'(90天,单位为毫秒,-1代表永不过期)
expire-time: '7776000000'

常见问题

  1. 时序数据库IoTDB和TDengine是否都需要配置,能不能都用

    不需要都配置,任选其一即可,用enable参数控制其是否使用,也可都不安装配置,只影响历史图表数据。

  2. 监控页面历史图表不显示,弹出 [无法提供历史图表数据,请配置依赖时序数据库]

    如弹窗所示,历史图表展示的前提是需要安装配置hertzbeat的依赖服务 - IotDB数据库或TDengine数据库

  3. 安装配置了IotDB数据库,但页面依旧显示弹出 [无法提供历史图表数据,请配置依赖时序数据库]

    请检查配置参数是否正确 iot-db enable是否设置为true 注意⚠️若hertzbeat和IotDB都为docker容器在同一主机下启动,容器之间默认不能用127.0.0.1通讯,改为主机IP 可根据logs目录下启动日志排查