17.6 Telegraf、InfluxDB 与 Grafana 监控平台架构

系统监控是运维管理和性能优化的基础，通过实时采集、存储和可视化系统指标，可以实现故障预警、性能分析和容量规划等关键功能，为系统的稳定运行提供有力保障。

Telegraf、InfluxDB 与 Grafana 构成的 TIG 堆栈是业界广泛采用的开源监控解决方案，遵循数据采集、存储与可视化分离的设计原则，实现了模块化的监控架构。

其中 InfluxDB 作为时序数据库专门用于高效存储时间序列数据，Telegraf 作为插件化的采集代理负责指标收集，Grafana 则提供强大的可视化能力，三者协同工作构成完整的监控体系。

InfluxDB 安装与配置

InfluxDB 是一款用于存储和分析时间序列数据的开源数据库。

安装 InfluxDB

使用 pkg 包管理器安装 InfluxDB 是最快捷的方式，执行以下命令即可完成安装：

# pkg install influxdb

或者使用 Ports 方式安装 InfluxDB，需要先进入对应的目录再执行编译安装命令。

# cd /usr/ports/databases/influxdb/ 
# make install clean

服务管理

安装完成后，需要设置 InfluxDB 服务开机自启并启动服务。

设置 InfluxDB 服务开机自启：

# service influxd enable

启动 InfluxDB 服务：

# service influxd start

修改 InfluxDB 配置

如需自定义配置，读者可以自行修改 InfluxDB 的配置文件 /usr/local/etc/influxd.conf。编辑该文件可实现自定义配置。

修改完成后请重启 InfluxDB 服务：

# service influxd restart

创建 InfluxDB 数据库

需要在 InfluxDB 中创建数据库和用户，供 Telegraf 使用。

# influx # 连接到 InfluxDB 数据库
Connected to http://localhost:8086 version 1.8.10
InfluxDB shell version: 1.8.10
> CREATE DATABASE mydb -- 创建 InfluxDB 数据库
> CREATE USER username WITH PASSWORD 'password' -- 创建数据库用户及密码，此处用户名为 username，密码为 password
> SHOW DATABASES -- 查看数据库
name: databases
name
----
_internal
mydb
>
> quit -- 退出 InfluxDB shell

Telegraf

Telegraf 是一个用于采集和报告指标的代理程序。本节将介绍如何安装和配置 Telegraf。

安装 Telegraf

使用 pkg 包管理器安装 Telegraf 是最快捷的方式，执行以下命令即可完成安装：

# pkg install telegraf

或者使用 Ports 方式安装 Telegraf，需要先进入对应的目录再执行编译安装命令。

# cd /usr/ports/net-mgmt/telegraf/ 
# make install clean

加入启动项

安装完成后，需要设置 Telegraf 服务开机自启。

设置 Telegraf 服务开机自启：

# service telegraf enable

此时暂时不要启动 Telegraf 服务。

配置 InfluxDB 连接

目录结构：

/usr/local/
└── etc/
    ├── influxd.conf              # InfluxDB 配置文件
    └── telegraf.conf             # Telegraf 配置文件

需要配置 Telegraf 使其能够将采集的数据发送到 InfluxDB。这里使用的是 InfluxDB 1.8 版本。

需要在配置文件 /usr/local/etc/telegraf.conf 中进行修改如下：

# 配置 InfluxDB 连接信息，此处的内容应与上面配置的 InfluxDB 数据库账号和密码一致
[[outputs.influxdb]]        # 输出插件类型为 InfluxDB
  urls = ["http://127.0.0.1:8086"]  # InfluxDB 服务地址
  database = "mydb"                 # 要写入的数据库名称
  username = "username"             # 数据库用户名
  password = "password"             # 数据库密码

配置采集指标

需要配置 Telegraf 采集哪些系统指标。配置文件路径：/usr/local/etc/telegraf.conf：

这里将收集系统的 CPU、磁盘（disk）、磁盘 IO（diskio）、内存（memory）、交换空间（swap）等指标。下面是 Telegraf 配置文件中的部分内容，其中部分参数默认启用，部分参数需要手动取消注释。

详情参见：官方文档[EB/OL]. [2026-03-26]. https://docs.influxdata.com/telegraf/v1.26/configuration/，提供 Telegraf 完整配置参数及插件使用说明。

# 内存
[[inputs.mem]]

# swap
[[inputs.swap]]

# 磁盘
[[inputs.disk]]
  ignore_fs = ["tmpfs", "devtmpfs", "devfs", "iso9660", "overlay", "aufs", "squashfs"]

# 磁盘 IO
[[inputs.diskio]]

# 进程
[[inputs.processes]]

# 系统（运行时长等）
[[inputs.system]]

# 网络
[[inputs.net]]

启动服务

所有配置完成后，可以启动 Telegraf 服务开始采集数据。

启动 Telegraf 服务：

# service telegraf start

Grafana

Grafana 是一个开源的数据可视化和监控平台，用于将 InfluxDB 等数据源中的数据以图表形式展示。

安装 Grafana

使用 pkg 包管理器安装 Grafana 是最快捷的方式，执行以下命令即可完成安装：

# pkg install grafana

使用 Ports 方式安装 Grafana，需要先进入对应的目录再执行编译安装命令。

# cd /usr/ports/www/grafana/ 
# make install clean

守护进程

安装完成后，需要设置 Grafana 服务开机自启并启动服务。

设置 Grafana 服务开机自启：

# service grafana enable

启动 Grafana 服务：

# service grafana start

登录 Grafana

Grafana 服务启动后，可以通过浏览器访问其 Web 界面进行配置。Grafana 的默认登录地址为 http://localhost:3000。

默认登录用户名和密码：
- Username（用户名）：admin
- Password（密码）：admin

登录后会要求修改密码。

配置数据源

需要在 Grafana 中配置数据源，使其能够从 InfluxDB 中读取数据。

登录后点击左上角的 Connections -> 选择 Add new connection
grafana-datasource-add
在右边的输入框中输入 InfluxDB -> 选择搜索出来的 InfluxDB，点击
choose-influxdb
点击右上角的 Add new data source 按钮 -> 配置 InfluxDB 相关的内容。
grafana-datasource-create
在数据源配置页面填写相关的 InfluxDB 连接信息，需配置内容如下：
注意
我们上面使用的是 InfluxDB 1.8，所以选择的查询语言必须选 InfluxQL（默认即是）