必须先安装InfluxDB并完成初始化配置,否则Telegraf和Grafana无法正常工作;需通过InfluxData官方APT源(bullseye)安装v2版本,导入GPG密钥、添加源、更新安装,再执行influx setup初始化并启用服务,最后验证Web界面与API健康状态。

要在统信UOS服务器上搭建时序数据采集与存储底座,必须先安装InfluxDB并完成基础服务配置,否则Telegraf无法发送指标、Grafana也无法读取历史数据。
通过APT源安装InfluxDB
统信UOS基于Debian 11(bullseye)内核,需使用适配的InfluxData官方源,避免安装旧版v1.x导致与Telegraf v2输出插件不兼容。
第一步:导入InfluxData GPG密钥并验证指纹
执行命令:wget -qO- https://repos.influxdata.com/influxdb.key | sudo apt-key add -
注意:若系统提示gpg: no valid OpenPGP data found,说明网络未返回密钥内容,需检查DNS或代理设置。
第二步:添加适配统信UOS的APT源
运行:echo "deb https://repos.influxdata.com/debian bullseye stable" | sudo tee /etc/apt/sources.list.d/influxdata.list
【bullseye必须准确,误写为buster或bookworm将导致apt update失败】
第三步:更新索引并安装sudo apt update && sudo apt install influxdb2
安装完成后,InfluxDB v2二进制文件位于/usr/bin/influxd,配置文件默认生成在/etc/influxdb2/config.toml。
初始化InfluxDB并启用服务
InfluxDB v2首次启动必须完成初始化流程,否则HTTP API无法响应,后续Telegraf和Grafana均会连接失败。
方法一:交互式初始化(推荐用于首次部署)
执行:sudo systemctl start influxdb → 等待约10秒 → 运行:influx setup
按提示依次输入:组织名(如uos-monitor)、桶名(如telegraf)、管理员用户名密码、保留策略时长(默认0表示永久)。
方法二:免交互初始化(适合脚本化部署)
执行:influx setup --username admin --password your_secure_pass --org uos-monitor --bucket telegraf --retention 0 --token $(openssl rand -hex 16) --force
该命令会跳过交互,直接生成Token并写入/var/lib/influxdb2/influxd.bolt数据库。
启用开机自启:sudo systemctl enable influxdb
验证服务状态:sudo systemctl is-active influxdb 返回 active 即为正常。
验证InfluxDB Web界面与API连通性
这一步确认服务已真正对外提供HTTP服务,而非仅进程存活。
打开浏览器,访问 http://本机IP:8086 —— 若看到InfluxDB初始化向导页面或登录页,说明服务已就绪。
终端执行API健康检查:curl -I http://localhost:8086/health
返回状态码 HTTP/1.1 200 OK 且包含 ready:true 字段,代表实例健康可写入。
若返回 Connection refused,检查是否防火墙拦截:sudo ufw status → 如启用,放行端口:sudo ufw allow 8086。

















