icinga2 写入

icinga2 是一款开源主机、网络监控软件，最初由 Nagios 网络监控应用发展而来。目前，icinga2 遵从 GNU GPL v2 许可协议发行。

只需要将 icinga2 的配置修改指向 taosAdapter 对应的服务器和相应端口即可将 icinga2 采集的数据存在到 TDengine 中，可以充分利用 TDengine 对时序数据的高效存储查询性能和集群处理能力。

前置条件

要将 icinga2 数据写入 TDengine 需要以下几方面的准备工作。

配置步骤

配置 taosAdapter

配置 taosAdapter 接收 icinga2 数据的方法：

  • 在 taosAdapter 配置文件（默认位置 /etc/taos/taosadapter.toml）中使能配置项
  1. ...
  2. [opentsdb_telnet]
  3. enable = true
  4. maxTCPConnections = 250
  5. tcpKeepAlive = false
  6. dbs = ["opentsdb_telnet", "collectd", "icinga2", "tcollector"]
  7. ports = [6046, 6047, 6048, 6049]
  8. user = "root"
  9. password = "taosdata"
  10. ...

其中 taosAdapter 默认写入的数据库名称为 icinga2，也可以修改 taosAdapter 配置文件 dbs 项来指定不同的名称。user 和 password 填写实际 TDengine 配置的值。修改过 taosAdapter 需重新启动。

  • 也可以使用 taosAdapter 命令行参数或设置环境变量启动的方式，使能 taosAdapter 接收 icinga2 数据功能，具体细节请参考 taosAdapter 的使用手册

配置 icinga2

  • 使能 icinga2 的 opentsdb-writer（参考链接 https://icinga.com/docs/icinga-2/latest/doc/14-features/#opentsdb-writer）
  • 修改配置文件 /etc/icinga2/features-enabled/opentsdb.conf 填写 <taosAdapter’s host> 为运行 taosAdapter 的服务器的域名或 IP 地址，<port for icinga2> 填写 taosAdapter 支持接收 icinga2 数据的相应端口（默认为 6048）
  1. object OpenTsdbWriter "opentsdb" {
  2.   host = "<taosAdapter's host>"
  3.   port = <port for icinga2>
  4. }

示例文件：

  1. object OpenTsdbWriter "opentsdb" {
  2.   host = "127.0.0.1"
  3.   port = 6048
  4. }

验证方法

重启 taosAdapter：

  1. sudo systemctl restart taosadapter

重启 icinga2：

  1. sudo systemctl restart icinga2

等待 10 秒左右后，使用 TDengine CLI 查询 TDengine 验证是否创建相应数据库并写入数据：

  1. taos> show databases;
  2.               name              |
  3. =================================
  4.  information_schema             |
  5.  performance_schema             |
  6.  icinga2                        |
  7. Query OK, 3 row(s) in set (0.001867s)
  9. taos> use icinga2;
  10. Database changed.
  12. taos> show stables;
  13.               name              |
  14. =================================
  15.  icinga.service.users.state_... |
  16.  icinga.service.users.acknow... |
  17.  icinga.service.procs.downti... |
  18.  icinga.service.users.users     |
  19.  icinga.service.procs.procs_min |
  20.  icinga.service.users.users_min |
  21.  icinga.check.max_check_atte... |
  22.  icinga.service.procs.state_... |
  23.  icinga.service.procs.procs_... |
  24.  icinga.service.users.users_... |
  25.  icinga.check.latency           |
  26.  icinga.service.procs.procs_... |
  27.  icinga.service.users.downti... |
  28.  icinga.service.users.users_... |
  29.  icinga.service.users.reachable |
  30.  icinga.service.procs.procs     |
  31.  icinga.service.procs.acknow... |
  32.  icinga.service.procs.state     |
  33.  icinga.service.procs.reachable |
  34.  icinga.check.current_attempt   |
  35.  icinga.check.execution_time    |
  36.  icinga.service.users.state     |
  37. Query OK, 22 row(s) in set (0.002317s)
icinga2 - 图1note
  • TDengine 默认生成的子表名是根据规则生成的唯一 ID 值。