Python3 实现 Zabbix 告警推送至钉钉机器人的完整指南
本文详细介绍如何使用 Python3 编写 Zabbix 告警脚本,将告警信息以 Markdown 格式推送到钉钉自定义机器人。内容涵盖环境要求、钉钉机器人配置、Zabbix 媒体类型与动作设置,以及故障和恢复消息的宏定义示例,帮助运维人员快速实现自动化告警通知。
本文分享一个基于 Python3 编写的简易脚本,用于将 Zabbix 系统的告警信息推送至钉钉机器人。推送内容采用 Markdown 格式,用户可根据实际需求调整 Markdown 样式及引用的 Zabbix 宏参数。

运行环境方面,理论上 Zabbix 的版本差异不影响脚本运行,建议核对官方文档中宏定义是否存在版本间差异。
Python 3
Zabbix 3.4.2
Zabbix 宏官方文档参考链接:https://www.zabbix.com/documentation/3.4/manual/appendix/macros/supported_by_location
配置步骤
首先需要在钉钉后台配置自定义机器人。
钉钉自定义机器人的官方配置文档地址为:https://open-doc.dingtalk.com/docs/doc.htm?treeId=257&articleId=105735&docType=1
接下来,编写 Zabbix 告警脚本,并将其放置在 Zabbix 服务器配置中指定的 alertscripts 目录下。
[itservice@zabbix alertscripts]$ cat /usr/lib/zabbix/alertscripts/alert_for_zabbix_by_dingding.py
#!/usr/bin/env python3
# encoding: utf-8
# author: huangwj
# mail: huangwjwork@gmail.com
# bolg: huangwj.app
# csdn: http://blog.csdn.net/u010871982
# github: https://github.com/huangwjwork
# file: alert_for_zabbix_by_dingding.py
# time: 2018/5/11 14:31
'''
本程序由huangwjwork开发,一切最终解释权归于huangwjwork.
本程序为开源,只用于技术交流,只供开发者参考与学习.
不得用于违反法律以及未经许可不得用于商业.保留其追责权利.
本程序不涉及任何违法敏感因素,如有人拿程序改造成违法工具,将与本程序开发者无关.
勇于开源,请勿滥用.内部学习交流,请勿传播.违反者造成相关法律事故,自行承担刑事责任.
'''
import sys
import getopt
import requests
import json
import traceback
try:
opts,args = getopt.getopt(sys.argv[1:],shortopts='',longopts=['webhook_url=','webhook_title=','alert_message='])
for opt,value in opts:
if opt == '--webhook_url':
webhook_url = value
elif opt == '--webhook_title':
webhook_title = value
elif opt == '--alert_message':
alert_message = value
webhook_header = {
"Content-Type": "application/json",
"charset": "utf-8"
}
webhook_message = {
"msgtype": "markdown",
"markdown": {
"title": webhook_title,
"text": alert_message
}
}
sendData = json.dumps(webhook_message,indent=1)
requests.post(url=webhook_url,headers=webhook_header,data=sendData)
except:
traceback.print_exc(file=open('/tmp/alert_zabbix_dingding.log','w+'))
随后,在 Zabbix 后台配置媒体类型(Media Type)。
在脚本参数中,需将 webhook_url 替换为实际获取的钉钉机器人 Webhook URL 地址。

配置用户信息,确保接收告警的用户关联了上述媒体类型。

配置动作(Action),定义触发告警时的具体行为。

在动作的消息模板中,附上具体的告警内容描述。
针对故障状态(告警),配置相应的消息模板。
## 故障
**主机名称:** {HOSTNAME1}
**告警名称:** {TRIGGER.NAME}
**告警级别:** {TRIGGER.SEVERITY}
**告警时间:** {EVENT.DATE} {EVENT.TIME}
**检查项:** {TRIGGER.KEY1}
**当前值:** {ITEM.LASTVALUE}
**IP地址:** {HOST.IP}
**事件ID:** {EVENT.ID}
针对恢复状态,配置相应的消息模板。
## 恢复
**主机名称:** {HOSTNAME1}
**告警名称:** {TRIGGER.NAME}
**告警级别:** {TRIGGER.SEVERITY}
**告警时间:** {EVENT.DATE} {EVENT.TIME}
**恢复时间:** {EVENT.RECOVERY.DATE} {EVENT.RECOVERY.TIME}
**故障时长:** {EVENT.AGE}
**检查项:** {TRIGGER.KEY1}
**当前值:** {EVENT.RECOVERY.VALUE}
**IP地址:** {HOST.IP}
**事件ID:** {EVENT.ID}
以上就是使用 Python3 实现 Zabbix 告警推送到钉钉机器人的完整示例内容,希望能为各位提供有价值的参考,欢迎收藏与支持。
本站声明
本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。













