Zabbix 部署与实战监控手册:Java 服务、端口、进程与邮件/企微告警

一、前言与整体规划

Zabbix 是一款成熟的企业级开源监控平台,支持主机、网络设备、应用服务、端口、进程等多维度监控,并具备灵活的告警通知能力。本手册从零开始,覆盖 Zabbix 服务端与 Agent 的部署、Java 服务监控、端口与进程监控,以及邮件告警和企业微信告警的完整配置流程,适合运维人员按步骤落地。

本文以 Zabbix 6.0 LTS 为例,操作系统为 CentOS 7 / Rocky Linux 8 ,数据库采用 MySQL 8.0 ,Web 服务采用 Nginx + PHP-FPM。整体架构如下:

flowchart LR A[被监控主机 Agent] -- 10051 --> B[Zabbix Server] C[Java 服务 JMX] -- 12345 --> B B -- 3306 --> D[(MySQL)] B -- 9000 --> E[Nginx + PHP-FPM] F[运维浏览器] -- 80/443 --> E B -- 告警 --> G[邮件 SMTP] B -- 告警 --> H[企业微信机器人]

部署前请确认以下环境准备:

  • 服务器最低配置: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 接口与模板

  1. 进入 Configuration → Hosts ,选择目标主机,点击 JMX interfaces → Add,填写 Java 应用 IP 与 JMX 端口 12345。
  2. 在 Templates 页签中链接 Generic Java JMX 或 Apache Tomcat by JMX 模板。
  3. 保存后等待几分钟,在 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 创建企业微信群机器人

  1. 在企业微信群中点击右上角 ... → 群机器人 → 添加机器人。
  2. 设置机器人名称,复制生成的 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 监控、端口与进程监控,再到邮件与企业微信双通道告警的落地流程。实际生产中建议结合业务重要性分级配置告警,并定期回顾告警质量,减少无效告警干扰。

相关推荐
Java展博1 小时前
[Go 后端转场] 从 try-catch 到 if err != nil:写惯 Java 的人第一次上手最别扭的 4 件事
java·开发语言·golang
starzy19901 小时前
Hadoop介绍总结:一张图理清组件、生态与版本
java·hadoop
yyuuuzz2 小时前
nginx 502 排查,先看上游超时那一行
android·java·运维·nginx·502
Java后端的Ai之路2 小时前
Java并发编程25-集合的线程安全
java·安全·面试
CoderYanger2 小时前
Java EE 进阶:9.MyBatis 操作数据库(进阶)(第一弹)
java·数据库·spring·面试·java-ee·tomcat·mybatis
码云社区2 小时前
Java租房平台源码方案:Vue 3房源审核、UniApp预约看房与房东管理
java·vue.js
codigger4 小时前
ThreadLocal 会内存泄露吗?
java·内存泄漏·threadlocal
挖掘狂人4 小时前
ThreadLocal 会内存泄露吗?
java·安全·架构
未秃头的程序猿4 小时前
给新模块加了个 @MapperScan,启动崩了,最后发现跟 MapperScan 没关系
java·后端·mybatis