Icinga 2

1. 引言

Icinga 2，作为一款源自 Nagios的开源监控软件，以其强大的主机和网络监控能力而闻名。它在GNU GPLv2许可协议下发行，确保了其开放性和社区的广泛参与。Icinga 2 可与 IoTDB高性能时序数据库无缝集成，实现监控数据的高效存储和管理。

2. 前置条件

要将 Icinga 2 数据同步到 IoTDB需要做如下准备：

• IoTDB >= V2.0.5.1，已经部署并且正常运行

• Icinga 2 已安装

• IoTDB_Adapter能够正常运行

3. 安装与配置步骤

3.1 IoTDB_Adapter 配置

1. 联系天谋工作人员获取IoTDB_Adapter 安装包

2. 解压压缩包

   # 以1.0版本为例
   unzip IoTDB_Adapter-1.0.zip

3. 修改配置文件conf/application.properties，设置监听端口、IoTDB路径前缀、节点地址、用户名和密码。

   # 启动 Adapter 监听的端口
   port=4242
   # IoTDB 的实例地址，多个 nodeUrls 用 ; 分割
   iotdb.nodeUrls=127.0.0.1:6667
   # 写入IoTDB的数据的路径前缀，如 root.testdb （sqlDialect不为table的时候生效）
   iotdb.prefix=root.icinga2
   # IoTDB 用户名
   iotdb.user=root
   # IoTDB 密码
   iotdb.password=root
   # IoTDB SqlDialect（可选tree/table，默认tree）
   iotdb.sqlDialect=tree
   # IoTDB DataBase （sqlDialect为table的时候生效）
   iotdb.database=collect
   # IoTDB Table （sqlDialect为table的时候生效）
   iotdb.table=test
   # payload_formatter:支持 statsd 和 opentsdb(默认) 两种
   payload.formatter=opentsdb
   # 源数据精度(默认秒s｜毫秒ms|微妙us|纳秒ns)
   time.precision.source=s
   # 目标 IoTDB 数据精度(默认秒)
   time.precision.iotdb=ms

4. 重新启动 IoTDB_Adapter 服务。

/sbin/start.sh

3.2 Icinga 2 配置

1. 下载安装 Icinga2，安装指南请参考Icinga 2 Installation

2. 启用 OpenTsdbWriter 特性：详情可参考Icinga官网介绍 Features 。

3. 修改配置文件/etc/icinga2/features-enabled/opentsdb.conf，配置 IoTDB_Adapter地址和端口。

   object OpenTsdbWriter "opentsdb" {
     host = "127.0.0.1"
     port = 4242
   }

4. 启动 Icinga 2 服务

   systemctl start icinga2

3.3 验证测试

通过 IoTDB CLI查询数据，验证数据是否已成功写入。

IoTDB> select * from root.icinga2.icinga.check.execution_time.`host=iot-VMware-Virtual-Platform`.`service=load`
+-----------------------------+---------------------------------------------------------------------------------------------------------+
|                         Time|root.icinga2.icinga.check.execution_time.`host=iot-VMware-Virtual-Platform`.`service=load`.`type=service`|
+-----------------------------+---------------------------------------------------------------------------------------------------------+
|2025-07-22T17:12:36.096+08:00|                                                                                                 0.012972|
|2025-07-22T17:14:47.168+08:00|                                                                                                 0.007544|
+-----------------------------+---------------------------------------------------------------------------------------------------------+