CentOS 7.9 部署 Zabbix-Agent 对接 Zabbix-Server 全过程记录

CentOS 7.9 部署 Zabbix-Agent 对接 Zabbix-Server 全过程记录

文档说明：本文档记录了在 CentOS 7.9 系统下，从添加 Yum 源到部署 Zabbix 6.0 Agent 并成功对接 Zabbix Server 的全过程真实操作记录。其中包含了采用纯主动模式的核心配置项解析以及遇到 Timeout 超时报错的排坑记录。

---

一、 配置 Yum 源与安装

配置 Zabbix 6.0 官方源并查看可用的包版本记录：

[root@zabbix-agent ~]# rpm -Uvh https://repo.zabbix.com/zabbix/6.0/rhel/7/x86_64/zabbix-release-6.0-4.el7.noarch.rpm

[root@zabbix-agent yum.repos.d]# ll
总用量 16
-rw-r--r--  1 root root  230 9月  14 2022 zabbix-agent2-plugins.repo
-rw-r--r--  1 root root 1100 9月  14 2022 zabbix.repo

[root@zabbix-agent yum.repos.d]# yum --showduplicates list zabbix-agent
...
zabbix-agent.x86_64                                                                       6.0.45-release1.el7                                                                        zabbix
zabbix-agent.x86_64                                                                       6.0.46-release1.el7                                                                        zabbix
zabbix-agent.x86_64                                                                       6.0.46-release2.el7                                                                        zabbix

[root@zabbix-agent yum.repos.d]# yum -y install zabbix-agent

二、 核心配置文件修改（纯主动模式配置）

配置文件修改:

[root@zabbix-agent yum.repos.d]# cat /etc/zabbix/zabbix_agentd.conf | egrep 'Server|ServerActive|StartAgents|HostnameItem|Timeout' | grep -v ^#
StartAgents=0					#作用：彻底关闭被动模式，只运行主动模式，只主动往外连 Server
ServerActive=192.168.108.20		#作用：告诉 Agent 要把数据推给谁
HostnameItem=system.hostname	#作用：让 Agent 自动使用本机的主机名上报
Timeout=30						#作用：把超时时间从 3 秒改成 30 秒,防止网络慢、Server 忙导致连接超时,出现timeout

三、 踩坑记录：Timeout 超时问题排查

不修改timeout报错如下: timeout超时时间太小
启动报错:

[root@zabbix-agent yum.repos.d]# tail /var/log/zabbix/zabbix_agentd.log
  8837:20260515:104140.033 **** Enabled features ****
  8837:20260515:104140.033 IPv6 support:          YES
  8837:20260515:104140.033 TLS support:           YES
  8837:20260515:104140.034 **************************
  8837:20260515:104140.034 using configuration file: /etc/zabbix/zabbix_agentd.conf
  8837:20260515:104140.034 agent #0 started [main process]
  8838:20260515:104140.035 agent #1 started [collector]
  8839:20260515:104140.036 agent #2 started [active checks #1]
  8839:20260515:104143.042 Unable to receive from [192.168.108.20]:10051 [ZBX_TCP_READ() timed out]
  8839:20260515:104143.043 Active check configuration update started to fail

(注：根据上述报错，必须按照第二步将配置项中的 Timeout 修改为 30 以避免超时握手失败。)

四、 启动服务与状态验证

修改配置后，设置开机自启动服务并启动：

开机自启动服务
[root@zabbix-agent yum.repos.d]# systemctl enable --now zabbix-agent.service

查看zabbix-agent日志是否能正常主动上报指标：

[root@zabbix-agent yum.repos.d]# tail /var/log/zabbix/zabbix_agentd.log
  8837:20260515:110112.898 Zabbix Agent stopped. Zabbix 6.0.46 (revision cee25804180).
  8957:20260515:110112.928 Starting Zabbix Agent [zabbix-agent]. Zabbix 6.0.46 (revision cee25804180).
  8957:20260515:110112.929 **** Enabled features ****
  8957:20260515:110112.929 IPv6 support:          YES
  8957:20260515:110112.929 TLS support:           YES
  8957:20260515:110112.929 **************************
  8957:20260515:110112.929 using configuration file: /etc/zabbix/zabbix_agentd.conf
  8957:20260515:110112.929 agent #0 started [main process]
  8958:20260515:110112.930 agent #1 started [collector]
  8959:20260515:110112.932 agent #2 started [active checks #1]

检查进程状态（由于设为了 StartAgents=0，此时只会启动 collector 和 active checks 相关的纯主动模式进程）：

[root@zabbix-agent yum.repos.d]# ps -aux | grep zabbix
zabbix     8957  0.0  0.0  81368  1288 ?        S    11:01   0:01 /usr/sbin/zabbix_agentd -c /etc/zabbix/zabbix_agentd.conf
zabbix     8958  0.0  0.0  81368  1452 ?        S    11:01   0:05 /usr/sbin/zabbix_agentd: collector [idle 1 sec]
zabbix     8959  0.0  0.0  81500  2696 ?        S    11:01   0:08 /usr/sbin/zabbix_agentd: active checks #1 [idle 1 sec]

五、zabbix-server界面配置

---

---

至此，Zabbix Agent 部署与调试完毕，成功以主动模式与 Zabbix Server 建立连接。