# Zabbix 7.0 + 钉钉告警：5分钟搞定Python脚本配置（附避坑指南） 在企业IT运维中，监控系统的告警功能至关重要。Zabbix作为一款强大的开源监控工具，结合钉钉这一企业级通讯平台，能够实现高效、实时的告警通知。本文将详细介绍如何在Zabbix 7.0中配置钉钉告警，并提供Python脚本实现方案，帮助运维人员快速落地企业级监控告警系统。 ## 1. 钉钉机器人创建与配置 首先，我们需要在钉钉中创建一个自定义机器人，用于接收Zabbix的告警信息。以下是具体步骤： 1. **创建钉钉群组**： - 打开钉钉客户端，点击左上角"+"按钮，选择"发起群聊" - 选择"企业内部群"，至少需要3名成员才能创建群组 - 完成群组创建后，进入群设置 2. **添加自定义机器人**： - 在群设置中找到"智能群助手"，点击进入 - 选择"添加机器人" → "自定义" → "添加" - 设置机器人名称（如"Zabbix告警机器人"），并记录生成的Webhook地址 > 注意：Webhook地址格式通常为`https://oapi.dingtalk.com/robot/send?access_token=xxxxxx`，请妥善保管此地址，后续配置会用到。 3. **安全设置**（可选但推荐）： - 在机器人配置页面，可以设置IP白名单或自定义关键词 - 如果选择"加签"方式，需要记录下secret值 ## 2. Zabbix服务器端Python脚本配置 接下来，我们需要在Zabbix服务器上创建告警脚本。以下是Python脚本的实现方案： ```python #!/usr/bin/env python3 #coding:utf-8 import requests import json import sys import os import datetime # 替换为你的钉钉机器人Webhook地址 webhook = "https://oapi.dingtalk.com/robot/send?access_token=your_token_here" def send_dingtalk_message(user, text): data = { "msgtype": "text", "text": { "content": text }, "at": { "atMobiles": [user], "isAtAll": False } } headers = {'Content-Type': 'application/json'} response = requests.post(url=webhook, data=json.dumps(data), headers=headers) # 记录日志 log_file = "/var/log/zabbix/dingding.log" log_content = f"\n{datetime.datetime.now()} {user} " if response.json().get("errcode") == 0: log_content += "发送成功\n" + text else: log_content += f"发送失败, 错误码: {response.json().get('errcode')}\n" + text with open(log_file, "a+") as f: f.write(log_content) if __name__ == "__main__": if len(sys.argv) < 3: print("Usage: ./dingding.py <user> <subject> <message>") sys.exit(1) user = sys.argv[1] subject = sys.argv[2] message = sys.argv[3] if len(sys.argv) > 3 else "" full_message = f"{subject}\n{message}" send_dingtalk_message(user, full_message) ``` **脚本部署步骤**： 1. 将上述脚本保存为`/usr/lib/zabbix/alertscripts/dingding.py` 2. 设置脚本权限： ```bash chmod +x /usr/lib/zabbix/alertscripts/dingding.py chown zabbix.zabbix /usr/lib/zabbix/alertscripts/dingding.py ``` 3. 创建日志文件： ```bash touch /var/log/zabbix/dingding.log chown zabbix.zabbix /var/log/zabbix/dingding.log ``` 4. 安装Python依赖： ```bash apt update && apt install -y python3-pip pip3 install requests ``` ## 3. Zabbix Web界面配置 完成脚本部署后，需要在Zabbix Web界面进行相关配置： ### 3.1 创建告警媒介 1. 登录Zabbix Web界面，导航至"管理" → "报警媒介类型" 2. 点击"创建媒介类型"，填写以下信息： - 名称：钉钉告警 - 类型：脚本 - 脚本名称：dingding.py - 脚本参数（按顺序添加）： ``` {ALERT.SENDTO} {ALERT.SUBJECT} {ALERT.MESSAGE} ``` ### 3.2 配置用户告警媒介 1. 导航至"管理" → "用户"，选择需要接收告警的用户（如Admin） 2. 在"报警媒介"标签页，点击"添加" 3. 选择刚创建的"钉钉告警"媒介类型 4. 设置接收人（填写钉钉账号绑定的手机号） ### 3.3 创建告警动作 1. 导航至"配置" → "动作"，点击"创建动作" 2. 在"动作"标签页： - 名称：钉钉告警 - 条件：添加触发器条件（如"触发器严重性"="灾难"） 3. 在"操作"标签页： - 默认操作步骤持续时间：1h - 默认标题（问题）： ``` 故障告警: {TRIGGER.NAME} ``` - 默认消息内容： ``` 告警主机: {HOSTNAME1} 主机IP: {HOST.IP} 告警时间: {EVENT.DATE} {EVENT.TIME} 告警等级: {TRIGGER.SEVERITY} 当前状态: {TRIGGER.STATUS} 问题详情: {ITEM.NAME}:{ITEM.VALUE} 事件ID: {EVENT.ID} ``` 4. 添加恢复操作： - 默认标题（恢复）： ``` 恢复通知: {TRIGGER.NAME} ``` - 默认消息内容： ``` 恢复主机: {HOSTNAME1} 恢复时间: {EVENT.RECOVERY.DATE} {EVENT.RECOVERY.TIME} 故障时长: {EVENT.AGE} 事件ID: {EVENT.ID} ``` ## 4. 常见问题与解决方案 在实际配置过程中，可能会遇到以下问题： ### 4.1 脚本执行权限问题 **现象**：Zabbix无法执行Python脚本 **解决方案**： ```bash chmod 755 /usr/lib/zabbix/alertscripts/dingding.py chown zabbix:zabbix /usr/lib/zabbix/alertscripts/dingding.py ``` ### 4.2 钉钉消息发送失败 **可能原因**： - Webhook地址错误 - 钉钉机器人安全设置限制（如IP白名单、关键词限制） - 网络连接问题 **排查步骤**： 1. 手动测试脚本： ```bash cd /usr/lib/zabbix/alertscripts ./dingding.py 13800138000 "测试告警" "这是一条测试告警信息" ``` 2. 检查钉钉机器人安全设置 3. 查看日志文件`/var/log/zabbix/dingding.log` ### 4.3 消息格式问题 **优化建议**： - 使用Markdown格式提升消息可读性 - 添加跳转到Zabbix的链接 - 根据告警级别设置不同的@策略 改进后的消息模板示例： ``` **[{TRIGGER.STATUS}] {TRIGGER.NAME}** - 主机: {HOSTNAME1} ({HOST.IP}) - 时间: {EVENT.DATE} {EVENT.TIME} - 等级: {TRIGGER.SEVERITY} - 值: {ITEM.VALUE} [查看详情](http://your_zabbix_server/zabbix/tr_events.php?triggerid={TRIGGER.ID}&eventid={EVENT.ID}) ``` ## 5. 高级配置与优化 ### 5.1 使用钉钉Markdown格式 修改Python脚本，支持更丰富的消息格式： ```python def send_markdown_message(user, subject, message): data = { "msgtype": "markdown", "markdown": { "title": subject, "text": f"### {subject}\n\n{message}" }, "at": { "atMobiles": [user], "isAtAll": False } } # 其余代码保持不变 ``` ### 5.2 告警分级处理 根据不同告警级别设置不同的处理策略： | 告警级别 | 处理方式 | 通知频率 | |----------|----------|----------| | 灾难 | @所有人 | 立即通知 | | 严重 | @相关人 | 每30分钟 | | 一般 | 普通通知 | 每2小时 | ### 5.3 告警去重与聚合 对于频繁触发的告警，可以添加以下处理逻辑： 1. 在动作条件中添加"触发器值=问题" 2. 设置合理的操作步骤持续时间 3. 使用Zabbix的告警确认功能 通过以上配置，您可以在5分钟内完成Zabbix 7.0与钉钉告警的集成，实现高效的企业级监控告警系统。