版本：v1.6.x

依赖时序数据库服务IoTDB安装初始化(可选)

Apache HertzBeat (incubating) 的历史数据存储依赖时序数据库，任选其一安装初始化即可，也可不安装(注意⚠️但强烈建议生产环境配置)

我们推荐使用并长期支持 VictoriaMetrics 作为存储。

Apache IoTDB是一体化收集、存储、管理与分析物联网时序数据的软件系统，我们使用其存储分析采集到的监控指标历史数据。支持V1.版本，废弃V0.版本的支持。

注意⚠️ 时序数据库安装配置为可选项，但强烈建议生产环境配置，以提供更完善的历史图表功能，高性能和稳定性

⚠️ 若不配置时序数据库，则只会留最近一小时历史数据

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

通过Docker方式安装IoTDB

可参考官方网站安装教程

下载安装Docker环境 Docker 工具自身的下载请参考 Docker官网文档。安装完毕后终端查看Docker版本是否正常输出。
```
$ docker -v
Docker version 20.10.12, build e91ed57
```
Docker安装IoTDB
```
$ docker run -d -p 6667:6667 -p 31999:31999 -p 8181:8181 \
    -v /opt/iotdb/data:/iotdb/data \ 
    --name iotdb \
    apache/iotdb:1.2.2-standalone
```
-v /opt/iotdb/data:/iotdb/data 为IoTDB数据目录本地持久化挂载，需将/iotdb/data替换为实际本地存在的目录
使用$ docker ps查看数据库是否启动成功

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

配置HertzBeat的配置文件修改位于 hertzbeat/config/application.yml 的配置文件注意⚠️docker容器方式需要将application.yml文件挂载到主机本地，安装包方式解压修改位于 hertzbeat/config/application.yml 即可

修改里面的warehouse.store.jpa.enabled参数为false，配置warehouse.store.iot-db数据源参数，HOST账户密码等，并启用enabled为true

warehouse:
  store:
    # 关闭默认JPA
    jpa:
      enabled: false
    # 启用IotDB
    iot-db:
      enabled: true
      host: 127.0.0.1
      rpc-port: 6667
      username: root
      password: root
      # use default queryTimeoutInMs = -1
      query-timeout-in-ms: -1
      # 数据存储时间：默认'7776000000'（90天,单位为毫秒,-1代表永不过期）
      expire-time: '7776000000'

IoTDB集群版配置
如果您使用IoTDB为集群请参考下面配置

warehouse:
  store:
    # 关闭默认JPA
    jpa:
      enabled: false
    # 启用IotDB
    iot-db:
      enabled: true
      node-urls: ['127.0.0.1:6667','127.0.0.2:6667','127.0.0.3:6667'']
      username: root
      password: root
      # 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'

参数说明：

参数名称	参数说明
enabled	是否启用
host	IoTDB数据库地址
rpc-port	IoTDB数据库端口
node-urls	IoTDB集群地址
username	IoTDB数据库账户
password	IoTDB数据库密码
version	IoTDB数据库版本，已废弃，仅支持V1.*
query-timeout-in-ms	查询超时时间
expire-time	数据存储时间，默认'7776000000'（90天,单位为毫秒,-1代表永不过期）

如果集群配置node-urls和单机配置同时设置，以集群node-urls配置稳准

重启 HertzBeat

常见问题

时序数据库IoTDB和TDengine是否都需要配置，能不能都用
不需要都配置，任选其一即可，用enable参数控制其是否使用，也可都不安装配置，只影响历史图表数据。
监控页面历史图表不显示，弹出 [无法提供历史图表数据，请配置依赖时序数据库]
如弹窗所示，历史图表展示的前提是需要安装配置hertzbeat的依赖服务 - IotDB数据库或TDengine数据库
安装配置了IotDB数据库，但页面依旧显示弹出 [无法提供历史图表数据，请配置依赖时序数据库]
请检查配置参数是否正确
iot-db enable是否设置为true
注意⚠️若hertzbeat和IotDB都为docker容器在同一主机下启动，容器之间默认不能用127.0.0.1通讯，改为主机IP
可根据logs目录下启动日志排查

通过Docker方式安装IoTDB​

常见问题​

通过Docker方式安装IoTDB

常见问题