Zabbix Agent 数据采集与查看：从配置到验证的实施步骤

Zabbix Agent 数据采集与查看：从配置到验证的实施步骤

把主机信息先定准

开始安装前，先把这台被监控主机的几个信息定下来：Zabbix Server 或 Proxy 的 IP 地址、被监控主机在 Zabbix 里显示的主机名、操作系统类型、是否允许 Server 访问 Agent 的 10050 端口。如果你准备使用主动模式，还要确认 Agent 能访问 Server 或 Proxy 的 10051 端口。

操作上，建议先在被监控主机执行 hostname 和 ip addr，记下主机名和业务 IP。然后在 Zabbix Server 上确认到该 IP 的路由可达。结果应该是：你已经得到一组明确参数，例如 Server 地址为 10.0.0.10，被监控主机 IP 为 10.0.1.21，Zabbix 中计划使用的 Hostname 为 app-01。后面配置文件和前端主机名要保持一致，尤其是主动模式，Hostname 不一致会导致数据一直进不来。

安装 Agent 软件包

在被监控的 Linux 主机上安装 Zabbix Agent。不同发行版的包名和仓库来源会有差异，企业环境通常会使用内部 yum、dnf 或 apt 仓库；如果没有仓库，需要先按你们当前 Zabbix 大版本配置官方或内部镜像源，版本号以现网 Zabbix Server 为准，避免 Agent 与 Server 版本跨度过大。

CentOS、Rocky Linux、AlmaLinux 这类系统常见操作是执行：

yum install zabbix-agent

或：

dnf install zabbix-agent

Debian、Ubuntu 这类系统常见操作是执行：

apt update

apt install zabbix-agent

安装完成后，查看配置文件是否存在。常见路径是 /etc/zabbix/zabbix_agentd.conf，服务名称常见为 zabbix-agent。执行 systemctl status zabbix-agent，如果看到服务单元存在，说明软件包已经安装到位；即使服务暂未启动，也可以进入下一步配置。

修改 Agent 关键配置

打开 /etc/zabbix/zabbix_agentd.conf，重点修改 Server、ServerActive、Hostname 三项。被动采集依赖 Server 参数，表示允许哪些 Zabbix Server 或 Proxy 来连本机 Agent；主动采集依赖 ServerActive 参数，表示 Agent 主动把数据发到哪里；Hostname 必须与 Zabbix 前端创建主机时填写的主机名一致。

一个常见配置如下：

Server=10.0.0.10

ServerActive=10.0.0.10

Hostname=app-01

ListenPort=10050

如果你的环境只使用被动模式，可以暂时不启用 ServerActive；如果跨网络、NAT 或云主机无法被 Server 直接访问，主动模式通常更稳。配置保存后执行：

systemctl restart zabbix-agent

systemctl enable zabbix-agent

systemctl status zabbix-agent

预期结果是服务状态为 active，并且开机自启已启用。如果状态是 failed，先不要去前端反复刷新，直接看日志。常见日志路径为 /var/log/zabbix/zabbix_agentd.log，也可以执行 journalctl -u zabbix-agent 查看启动报错。配置项拼写错误、Hostname 重复、端口被占用都可能导致启动失败。

确认端口和网络可达

Agent 正常启动后，需要确认网络链路。被动模式下，Zabbix Server 要能访问被监控主机的 10050 端口。可以在被监控主机执行 ss -lntp，确认 10050 已监听；再在 Server 上使用 telnet、nc 或等价工具测试：

nc -vz 10.0.1.21 10050

如果连接超时，优先检查安全组、防火墙、主机 iptables 或 firewalld。使用 firewalld 的系统可以放通端口：

firewall-cmd –add-port=10050/tcp –permanent

firewall-cmd –reload

主动模式下，还要反向确认被监控主机能访问 Server 的 10051 端口。结果应该是：被动模式 Server 能连到 Agent，主动模式 Agent 能连到 Server。只要这一步不通，前端配置再正确也不会有稳定数据。

在 Zabbix 前端创建主机

登录 Zabbix 前端后，进入主机配置页面。不同版本菜单名称可能略有差异，通常在 Configuration 或 Data collection 下找到 Hosts。新建主机时填写 Host name，例如 app-01；可见名称可以写业务识别名，例如 生产应用服务器 app-01；选择一个合适的主机组，例如 Linux servers 或你们自定义的业务组。

接口部分选择 Agent，IP 地址填写被监控主机 IP，例如 10.0.1.21，端口填写 10050。随后关联模板，Linux 主机一般选择 Zabbix agent 或 Linux by Zabbix agent 相关模板，具体模板名称以当前 Zabbix 版本内置模板为准。保存后，主机列表中应出现这台主机，并且接口列不应报明显配置错误。

这里最容易出错的是 Host name 与 Agent 配置里的 Hostname 不一致。被动模式下影响相对小一些，但主动模式会直接导致数据找不到归属主机。建议复制同一个字符串，不要手工敲两遍。

等待采集并查看最新数据

主机保存后，不要立刻判断失败。模板中的不同监控项有不同采集间隔，通常需要等待 1 到 3 个采集周期。随后进入 Latest data 或最新数据页面，筛选主机 app-01，查看是否出现 system.cpu.load、vm.memory.size、vfs.fs.size、agent.ping 等监控项。

正常结果是：最新数据页面能看到监控项名称、最近检查时间和数值。CPU 负载应是数字，内存项会显示容量或百分比，磁盘项会显示各挂载点空间。再进入图形页面查看 CPU、内存、磁盘使用趋势，如果图形开始有点位，说明采集链路已经跑通。

如果主机可用性图标仍是灰色，可能只是还没完成第一次检查；如果变红，通常表示连接失败、权限不足、key 不支持或 Agent 拒绝访问。此时不要只看图标，要点开主机问题或监控项错误信息，错误文本往往能直接指向原因。

用命令做一次端到端验证

前端能看到数据后，建议再从 Zabbix Server 用 zabbix_get 验证一条关键指标。zabbix_get 工具是否已安装取决于你的 Server 软件包，未安装时需要从相同仓库安装对应工具包。

在 Server 上执行：

zabbix_get -s 10.0.1.21 -p 10050 -k agent.ping

返回 1，表示 Server 可以通过 Agent 获取数据。再执行：

zabbix_get -s 10.0.1.21 -p 10050 -k system.hostname

返回被监控主机识别到的主机名，说明基础 key 可用。如果 zabbix_get 返回 connection refused，检查 Agent 服务和端口；如果返回 timeout，检查网络和防火墙；如果返回 not supported，说明该 key 在当前 Agent 或系统环境下不可用，需要换 key 或调整模板。

处理常见采集失败

第一类问题是主机名不一致。表现为 Agent 日志里出现 active check configuration update 失败，或者前端一直没有主动采集数据。处理方式是统一 zabbix_agentd.conf 的 Hostname 和前端 Host name，然后重启 Agent。

第二类问题是访问来源不被允许。表现为 Server 能连端口，但日志提示 connection from unknown IP。处理方式是把真实的 Server 或 Proxy IP 写入 Server 参数，多个地址用逗号分隔，保存后重启。

第三类问题是模板不匹配。比如你给 Linux 主机关联了不适合当前 Agent 的模板，最新数据里会出现大量不支持项。处理方式是先保留基础 Agent 模板，确认核心指标正常后，再逐步增加业务模板。

第四类问题是队列堆积。若单台主机配置无误但数据延迟明显，可在 Zabbix 前端查看 Queue 或队列页面，确认是否存在大量延迟监控项。结果若显示普遍延迟，就要检查 Server、Proxy、数据库性能和采集进程配置，这已经不是单台 Agent 配置问题。

交付前留下可复用记录

完成验证后，建议记录四项内容：被监控主机 IP、Zabbix Host name、Agent 配置中的 Server 与 ServerActive、已关联模板名称。再截取最新数据页面或导出关键监控项作为交付依据。这样后续出现告警误报、主机迁移、模板调整时，能快速判断是采集链路变化，还是业务指标本身变化。

到这里，Zabbix Agent 数据采集与查看：从配置到验证的实施步骤就完成了。最终可接受的结果不是服务启动成功，而是前端最新数据持续刷新、zabbix_get 能取到基础指标、主机可用性状态正常，并且关键 CPU、内存、磁盘指标已经形成图形。只有同时满足这些结果，才算 Agent 真正接入监控。