Zabbix-Alert-WeChat 项目安装与使用教程

Zabbix-Alert-WeChat 项目安装与使用教程

1. 项目目录结构及介绍

Zabbix-Alert-WeChat/
├── images/
├── .gitignore
├── LICENSE
├── README.md
├── dingtalk-robot.py
├── feishu-robot.py
├── wechat-py2-old.py
├── wechat-robot.py
├── wechat.py

目录结构说明

• images/: 存放项目相关的图片文件。
• .gitignore: Git 忽略文件配置。
• LICENSE: 项目许可证文件。
• README.md: 项目说明文档。
• dingtalk-robot.py: 钉钉机器人告警脚本。
• feishu-robot.py: 飞书机器人告警脚本。
• wechat-py2-old.py: 企业微信应用消息 Python2 版本脚本。
• wechat-robot.py: 企业微信群机器人告警脚本。
• wechat.py: 企业微信应用消息告警脚本（兼容 Python2 和 Python3）。

2. 项目启动文件介绍

wechat.py

wechat.py 是项目的主要启动文件，负责处理企业微信应用消息的告警。该脚本兼容 Python2 和 Python3，支持以下功能：

• 发送告警消息到企业微信应用。
• 支持钉钉和飞书机器人的告警。
• 支持 token 缓存，避免频繁获取 token 导致接口被限制。

启动方式

python wechat.py

3. 项目配置文件介绍

项目本身没有独立的配置文件，但需要在 Zabbix 中进行相关配置。以下是配置步骤：

企业微信设置

1. 通讯录设置:

   • 登录企业微信控制台，点击顶部“通讯录”。
   • 添加子部门（如运维部），并添加用户。
   • 记录部门 ID。

2. 创建应用:

   • 点击顶部“应用中心”，创建应用，应用名称为“zabbix报警”。
   • 可见范围添加刚刚新建的子部门（运维部）。
   • 记录 AgentId 和 Secret。

3. 应用权限设置:

   • 点击顶部“我的企业”，权限管理，新建普通管理组，名称填写“zabbix报警组”。
   • 修改通讯录权限，勾选（技术部）后方的管理。
   • 修改应用权限，勾选刚刚创建的“zabbix报警”。
   • 记录 CorpID 和 Secret。

Zabbix 设置

1. 添加示警媒介:

   • 管理 --> 示警媒介。
   • 名称填写“微信报警”，类型选择“脚本”，脚本名称填写 wechat.py（Python3 使用 wechat-py3.py）。

2. 用户示警媒介:

   • 管理 --> 用户 --> 示警媒介。
   • 类型选择“微信报警”，收件人添加微信企业号通讯录内的用户账号。

通过以上步骤，您可以成功配置并使用 Zabbix-Alert-WeChat 项目进行告警。