一、前言与整体规划
Zabbix 是一款成熟的企业级开源监控平台,支持主机、网络设备、应用服务、端口、进程等多维度监控,并具备灵活的告警通知能力。本手册从零开始,覆盖 Zabbix 服务端与 Agent 的部署、Java 服务监控、端口与进程监控,以及邮件告警和企业微信告警的完整配置流程,适合运维人员按步骤落地。
本文以 Zabbix 6.0 LTS 为例,操作系统为 CentOS 7 / Rocky Linux 8 ,数据库采用 MySQL 8.0 ,Web 服务采用 Nginx + PHP-FPM。整体架构如下:
部署前请确认以下环境准备:
- 服务器最低配置:2 核 4G,磁盘 50G 以上(数据量大时建议独立数据库)。
- 关闭 SELinux 或配置相应策略,防火墙放行 10051、80、3306 等端口。
- 所有节点时间同步(chronyd 或 ntpd),避免监控数据时间错乱。
二、Zabbix Server 部署
2.1 安装 Zabbix 软件源
bash
# CentOS 7
rpm -Uvh https://repo.zabbix.com/zabbix/6.0/rhel/7/x86_64/zabbix-release-6.0-4.el7.noarch.rpm
# Rocky Linux 8
rpm -Uvh https://repo.zabbix.com/zabbix/6.0/rhel/8/x86_64/zabbix-release-6.0-4.el8.noarch.rpm
清理缓存
yum clean all
2.2 安装 Server、前端与 Agent
bash
yum install -y zabbix-server-mysql zabbix-web-mysql zabbix-nginx-conf zabbix-sql-scripts zabbix-agent
2.3 初始化数据库
bash
mysql -uroot -p
sql
CREATE DATABASE zabbix CHARACTER SET utf8mb4 COLLATE utf8mb4_bin;
CREATE USER 'zabbix'@'localhost' IDENTIFIED BY 'Zabbix@2024';
GRANT ALL PRIVILEGES ON zabbix.* TO 'zabbix'@'localhost';
SET GLOBAL log_bin_trust_function_creators = 1;
FLUSH PRIVILEGES;
QUIT;
导入初始表结构与数据:
bash
zcat /usr/share/zabbix-sql-scripts/mysql/server.sql.gz | mysql -uzabbix -p zabbix
# 导入完成后关闭该参数
mysql -uroot -p -e "SET GLOBAL log_bin_trust_function_creators = 0;"
2.4 配置 Zabbix Server
编辑 /etc/zabbix/zabbix_server.conf,重点修改数据库连接信息:
ini
DBHost=localhost
DBName=zabbix
DBUser=zabbix
DBPassword=Zabbix@2024
# 根据内存调整缓存,4G 内存建议如下
CacheSize=128M
HistoryCacheSize=64M
TrendCacheSize=32M
ValueCacheSize=64M
2.5 配置 Nginx 与 PHP
编辑 /etc/nginx/conf.d/zabbix.conf,取消注释并修改监听端口与域名:
nginx
server {
listen 80;
server_name zabbix.example.com;
root /usr/share/zabbix;
index index.php;
location = /favicon.ico { log_not_found off; }
location / {
try_files $uri $uri/ =404;
}
location ~ \.php$ {
fastcgi_pass unix:/run/php-fpm/zabbix.sock;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}
}
调整 PHP 时区与参数,编辑 /etc/php-fpm.d/zabbix.conf:
ini
php_value[date.timezone] = Asia/Shanghai
php_value[max_execution_time] = 300
php_value[memory_limit] = 128M
php_value[post_max_size] = 16M
php_value[upload_max_filesize] = 2M
php_value[max_input_time] = 300
2.6 启动服务并完成 Web 安装
bash
systemctl restart zabbix-server zabbix-agent nginx php-fpm
systemctl enable zabbix-server zabbix-agent nginx php-fpm
# 检查状态
systemctl status zabbix-server
浏览器访问 http://zabbix.example.com,按向导完成安装。默认登录账号为 Admin ,密码为 zabbix,登录后请立即修改密码。
三、Zabbix Agent 部署
在被监控主机上安装 Agent,用于采集系统指标、端口与进程数据。
bash
rpm -Uvh https://repo.zabbix.com/zabbix/6.0/rhel/7/x86_64/zabbix-release-6.0-4.el7.noarch.rpm
yum install -y zabbix-agent
编辑 /etc/zabbix/zabbix_agentd.conf:
ini
Server=192.168.1.10 # Zabbix Server 地址
ServerActive=192.168.1.10 # 主动模式上报地址
Hostname=app-node-01 # 必须与 Web 中添加的主机名一致
# 允许执行自定义脚本(进程/端口监控常用)
UnsafeUserParameters=1
Include=/etc/zabbix/zabbix_agentd.d/*.conf
bash
systemctl restart zabbix-agent
systemctl enable zabbix-agent
# 验证连通性
zabbix_get -s 127.0.0.1 -k agent.ping
在 Zabbix Web 中进入 Configuration → Hosts → Create host ,填写主机名、可见名称,选择 Linux by Zabbix agent 模板,添加 Agent 接口(IP + 10050 端口)即可完成纳管。
四、监控 Java 服务
Java 服务监控通常有两种方式:JMX 监控 (推荐,可获取堆内存、GC、线程等 JVM 指标)和 Zabbix Java Gateway。下面以 JMX + Java Gateway 为例。
4.1 开启 Java 应用的 JMX 端口
在启动 Java 服务时添加 JMX 参数(以 Spring Boot 为例):
bash
java -Dcom.sun.management.jmxremote \
-Dcom.sun.management.jmxremote.port=12345 \
-Dcom.sun.management.jmxremote.rmi.port=12345 \
-Dcom.sun.management.jmxremote.authenticate=false \
-Dcom.sun.management.jmxremote.ssl=false \
-Djava.rmi.server.hostname=192.168.1.20 \
-jar app.jar
生产环境建议开启
authenticate=true并配置jmxremote.password与jmxremote.access,同时限制 JMX 端口仅对 Zabbix Server 开放。
4.2 部署 Zabbix Java Gateway
bash
yum install -y zabbix-java-gateway
# 编辑配置
vi /etc/zabbix/zabbix_java_gateway.conf
ini
LISTEN_IP="0.0.0.0"
LISTEN_PORT=10052
START_POLLERS=5
TIMEOUT=30
bash
systemctl restart zabbix-java-gateway
systemctl enable zabbix-java-gateway
同时在 Zabbix Server 配置中启用 Java Gateway:
ini
JavaGateway=127.0.0.1
JavaGatewayPort=10052
StartJavaPollers=5
bash
systemctl restart zabbix-server
4.3 在 Web 中添加 JMX 接口与模板
- 进入 Configuration → Hosts ,选择目标主机,点击 JMX interfaces → Add,填写 Java 应用 IP 与 JMX 端口 12345。
- 在 Templates 页签中链接 Generic Java JMX 或 Apache Tomcat by JMX 模板。
- 保存后等待几分钟,在 Monitoring → Latest data 中筛选该主机,即可看到 JVM Heap、GC、线程数等指标。
如需监控自定义 MBean,可在 Configuration → Hosts → Items → Create item 中选择类型 JMX agent,填写 MBean 对象名与属性,例如:
text
jmx["java.lang:type=Memory","HeapMemoryUsage.used"]
五、监控端口
端口监控用于确认服务是否正常监听,常用 net.tcp.listen 键值。
5.1 使用内置键值
在主机上创建监控项:Configuration → Hosts → Items → Create item。
- 名称:
TCP port 8080 listen - 类型:
Zabbix agent - 键值:
net.tcp.listen[8080] - 信息类型:
Numeric (unsigned) - 更新间隔:
30s
创建触发器:
text
Expression: last(/app-node-01/net.tcp.listen[8080])=0
Name: 端口 8080 未监听
Severity: High
5.2 使用自定义脚本监控远程端口
当需要从 Agent 侧探测其他主机端口时,可编写自定义脚本。在 /etc/zabbix/zabbix_agentd.d/port_check.conf 中添加:
ini
UserParameter=port.check[*],/etc/zabbix/scripts/port_check.sh $1 $2
脚本 /etc/zabbix/scripts/port_check.sh:
bash
#!/bin/bash
# 用法: port_check.sh <host> <port>
HOST=$1
PORT=$2
timeout 3 bash -c "echo > /dev/tcp/${HOST}/${PORT}" 2>/dev/null
if [ $? -eq 0 ]; then
echo 1
else
echo 0
fi
bash
chmod +x /etc/zabbix/scripts/port_check.sh
chown zabbix:zabbix /etc/zabbix/scripts/port_check.sh
systemctl restart zabbix-agent
# 测试
zabbix_get -s 127.0.0.1 -k port.check[192.168.1.20,8080]
六、监控进程
进程监控用于确认关键服务进程是否存活,常用 proc.num 键值。
6.1 使用内置键值
- 名称:
Java process count - 类型:
Zabbix agent - 键值:
proc.num[,,,java](统计名为 java 的进程数) - 信息类型:
Numeric (unsigned)
触发器表达式:
text
Expression: last(/app-node-01/proc.num[,,,java])<1
Name: Java 进程不存在
Severity: High
6.2 精确匹配进程命令行
当同一主机存在多个 Java 进程时,可通过完整命令行匹配:
text
proc.num[,,,"java -jar /opt/app/app.jar"]
或使用自定义脚本按进程名与关键字过滤:
ini
UserParameter=proc.check[*],/etc/zabbix/scripts/proc_check.sh "$1"
bash
#!/bin/bash
# 用法: proc_check.sh <keyword>
COUNT=$(ps -ef | grep -v grep | grep -c "$1")
echo $COUNT
bash
chmod +x /etc/zabbix/scripts/proc_check.sh
systemctl restart zabbix-agent
zabbix_get -s 127.0.0.1 -k proc.check[app.jar]
七、邮件告警配置
7.1 配置邮件媒介类型
进入 Administration → Media types → Email,填写 SMTP 参数:
| 参数 | 示例值 | 说明 |
|---|---|---|
| SMTP server | smtp.example.com | 邮件服务器地址 |
| SMTP server port | 465 | SSL 端口 |
| SMTP helo | example.com | HELO 域名 |
| SMTP email | zabbix@example.com | 发件人地址 |
| Security | SSL/TLS | 加密方式 |
| Authentication | Username and password | 认证方式 |
填写用户名与密码后,点击 Test 发送测试邮件,确认收件正常。
7.2 为用户绑定邮件媒介
进入 Users → Admin → Media → Add ,选择 Email 类型,填写收件地址,设置启用时间与严重级别(如 Warning 及以上),保存。
7.3 配置动作与消息模板
进入 Configuration → Actions → Trigger actions → Create action:
- 条件:
Trigger severity is greater than or equals Warning - 操作:发送消息给指定用户或用户组,媒介选择 Email
- 恢复操作:勾选 Notify all involved,实现故障恢复通知
消息模板示例:
text
告警主机:{HOST.NAME}
告警地址:{HOST.IP}
告警时间:{EVENT.DATE} {EVENT.TIME}
告警等级:{EVENT.SEVERITY}
告警信息:{EVENT.NAME}
当前状态:{EVENT.STATUS}
事件ID:{EVENT.ID}
八、企业微信告警配置
企业微信告警通过群机器人 Webhook 实现,需要编写一个告警脚本供 Zabbix 调用。
8.1 创建企业微信群机器人
- 在企业微信群中点击右上角 ... → 群机器人 → 添加机器人。
- 设置机器人名称,复制生成的 Webhook 地址,形如:
https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxxxxxxx
8.2 编写告警脚本
在 Zabbix Server 的 /usr/lib/zabbix/alertscripts/ 下创建 wechat.py:
python
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
import sys
import json
import requests
WEBHOOK = "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxxxxxxx"
def send_wechat(content):
headers = {"Content-Type": "application/json"}
data = {
"msgtype": "markdown",
"markdown": {"content": content}
}
resp = requests.post(WEBHOOK, headers=headers, data=json.dumps(data), timeout=10)
print(resp.text)
if name == "main":
if len(sys.argv) < 2:
print("Usage: wechat.py <content>")
sys.exit(1)
send_wechat(sys.argv[1])
bash
chmod +x /usr/lib/zabbix/alertscripts/wechat.py
chown zabbix:zabbix /usr/lib/zabbix/alertscripts/wechat.py
# 测试
/usr/lib/zabbix/alertscripts/wechat.py "Zabbix 测试告警"
8.3 配置媒介类型
进入 Administration → Media types → Create media type:
- 名称:
WeChat - 类型:
Script - 脚本名称:
wechat.py - 脚本参数:
{ALERT.MESSAGE}
保存后,在用户媒介中添加该类型,并配置动作将告警发送至企业微信。
8.4 企业微信消息模板
text
## Zabbix 告警通知
> **主机**:{HOST.NAME}
> **IP**:{HOST.IP}
> **等级**:{EVENT.SEVERITY}
> **时间**:{EVENT.DATE} {EVENT.TIME}
> **状态**:{EVENT.STATUS}
> **内容**:{EVENT.NAME}
九、常见问题与优化建议
- JMX 连接失败 :检查
java.rmi.server.hostname是否配置为可达 IP,防火墙是否放行 JMX 端口。 - Agent 无法连接 :确认
Server参数包含 Zabbix Server IP,10050 端口放行,主机名与 Web 配置一致。 - 告警不发送 :检查动作条件、用户媒介、媒介类型是否启用,查看 Reports → Action log 排查。
- 数据量过大:调整历史数据保留周期,启用分区表或使用 TimescaleDB,定期清理旧数据。
- 性能优化 :合理设置
StartPollers、CacheSize,避免监控项更新间隔过短。
十、最佳实践
https://download.csdn.net/download/lgz847368331/93848389
十一、总结
本手册完整覆盖了 Zabbix 从服务端部署、Agent 纳管,到 Java 服务 JMX 监控、端口与进程监控,再到邮件与企业微信双通道告警的落地流程。实际生产中建议结合业务重要性分级配置告警,并定期回顾告警质量,减少无效告警干扰。