526互联

Zabbix配置钉钉告警

发布时间 2023-10-07 15:54:53作者: 村尚chun叔

一、创建群聊机器人

1.添加群聊机器人

image

2.设置机器人信息

image

3.记录webhook地址

image

机器人文档
https://open.dingtalk.com/document/org/application-types

用户可以向这个webhook地址发起post请求，提交数据，也就是等于给钉钉发消息了，注意字符集编码

4.测试webhook地址

# 提交json类的数据，发给钉钉的API
[root@m-61 /tmp]#curl 'https://oapi.dingtalk.com/robot/send?access_token=4763e2451402cce519d7599369cd545e28288b80eb6c4b58bed03a548a03d857' \
-H 'Content-Type: application/json' \
-d '{"msgtype": "text","text": {"content": "zabbix 报警测试"}}'

# 拿到了结果
{"errcode":0,"errmsg":"ok"}

钉钉群聊也会收到机器人告警消息

4.1 支持更多功能参数，如圈某人看消息

# 参考钉钉机器人API的文档，支持哪些参数，参考用法如下
https://open.dingtalk.com/document/robots/custom-robot-access

image

# shell发请求 ，注意json数据格式，以及zabbix触发关键字

# 圈人语法，基于手机号
curl 'https://oapi.dingtalk.com/robot/send?access_token=4763e2451402cce519d7599369cd545e28288b80eb6c4b58bed03a548a03d857' \
-H 'Content-Type: application/json' \
-d  '{"at":{"atMobiles":["15210858004"],"isAtAll":false},"text":{"content":"正在测试zabbix钉钉报警机器人！！"},"msgtype":"text"}'

5.钉钉发消息脚本

5.1 python版(需要使用python3)

#!/usr/bin/python3
# coding: utf-8
# about zabbix python script
# Author： www.yuchaoit.cn

import requests,json,sys,os,datetime
# 钉钉机器人API,需要修改为自己的机器人API
webhook_url="https://oapi.dingtalk.com/robot/send?access_token=4763e2451402cce519d7599369cd545e28288b80eb6c4b58bed03a548a03d857"

# 给脚本参数手机号参数1
user_phone=sys.argv[1]

# 参数2，消息正文
text=sys.argv[2] + "\n\n" + sys.argv[3]

# 构造json数据体
data={
    "msgtype":"text",
    "text":{
        "content":text
    },
    "at":{
        "atMobiles":[user_phone],
        "isAtAll":False
    }
}

# 请求头，表明请求类型是json
headers={"Content-Type":"application/json"}

# 发HTTP请求，POST方式，传入数据与请求头
response=requests.post(url=webhook_url,data=json.dumps(data),headers=headers)
print(response.content)

# 日志目录生成
if os.path.exists("/tmp/dingding.log"):
    with open("/tmp/dingding.log","a+") as f:
        print("该文件以存在，追加写入中")
        if response.json().get("errcode")==0:
            f.write("\n" + str(datetime.datetime.now()) + "    " + str(user_phone) + "    " + "发送成功" + "\n" + str(text) )
        else:
            f.write("\n" + str(datetime.datetime.now()) + "    " + str(user_phone) + "    " + "发送失败" + "\n" + str(text) )
else:
    with open("/tmp/dingding.log","w+") as f:
        print("该日志文件不存在，创建且写入中")
        if response.json().get("errcode")==0:
            f.write("\n" + str(datetime.datetime.now()) + "    " + str(user_phone) + "    " + "发送成功" + "\n" + str(text) )
        else:
            f.write("\n" + str(datetime.datetime.now()) + "    " + str(user_phone) + "    " + "发送失败" + "\n" + str(text) )

执行结果
[root@m-61 /tmp]#python3 ding.py 15210858004 "python测试钉钉机器人" "zabbix故障了！！抓紧起来修复啊超哥！！火星撞地球了！！"
b'{"errcode":0,"errmsg":"ok"}'
该文件以存在，追加写入中

5.2 bash版

#!/bin/bash
# about zabbix bash script

#webhook 地址 webhook=''
#接受者的手机号，由 zabbix 传入 
user=$1
#报警邮件标题，由 zabbix 传入 
title=$2
#报警邮件内容，由 zabbix 传入
message=$3

# 构造语句执行发送动作
# bash就是用curl 构造json数据发出去而已，注意引号的细节就好
# 通过API返回的数据，来确认是否发送正确

curl -s -H "Content-Type: application/json" -X POST "https://oapi.dingtalk.com/robot/send?access_token=4763e2451402cce519d7599369cd545e28288b80eb6c4b58bed03a548a03d857" -d '{"msgtype":"text","text":{"content":"'"${title}\n\n${message}\n\nzabbix报警啦"'"},"at":{"atMobiles":["'"${user}"'"],"isAtAll":false}}' 

#将报警信息写入日志文件
echo -e "\n 报警时间:$(date +%F-%H:%M)\n 报警标题:${title}\n 报警内容:${message}" >> /tmp/ding_bash.log

运行结果
[root@m-61 /tmp]#bash b.sh 15210858004 zabbix报警啦 "zabbix报警啦，火星撞地球啦 bash脚本也可以啦"
{"errcode":0,"errmsg":"ok"}

避坑

脚本放入zabbix目录，采用python脚本
2.脚本权限
[root@m-61 /usr/lib/zabbix/alertscripts]#chmod +x dingding.py 
[root@m-61 /usr/lib/zabbix/alertscripts]#chown zabbix:zabbix  dingding.py
[root@m-61 /usr/lib/zabbix/alertscripts]#ll
total 4
-rwxr-xr-x 1 zabbix zabbix 1737 Oct  7 10:32 dingding.py

6.zabbix-UI页面配置钉钉报警

脚本调通后，就可以去zabbix的UI页面配置参数，提供报警
思路依然是
创建报警媒介类型
↓
创建媒体类型
↓
钉钉报警创建
↓
用户选择报警媒介方式

6.1 创建媒体类型

image

image

image

脚本参数对应脚本中传入的三个参数
{ALERT.SENDTO}
{ALERT.SUBJECT}
{ALERT.MESSAGE}

6.2 用户选择报警媒介（钉钉）

image

6.3 实测zabbix钉钉报警结果

在61机器测试登录用户数超过3个告警,61主机触发器配置完成

image

image

告警如下

image

恢复告警

image

踩坑记录，最后一步zabbix调用python发报警，别忘记关键字zabbix，且需要发送到所有，如果仅发送到email，则钉钉不会告警

给zabbix中的动作，添加关键字即可，否则无法触发钉钉机器人

----------------------------------------
keyword: zabbix
告警主机:{HOSTNAME1} {HOST.IP}
告警时间:{EVENT.DATE} {EVENT.TIME}
告警等级:{TRIGGER.SEVERITY}
告警信息: {TRIGGER.NAME}
告警项目:{TRIGGER.KEY1}
问题详情:{ITEM.NAME}:{ITEM.VALUE}
当前状态:{TRIGGER.STATUS}:{ITEM.VALUE1}
事件ID:{EVENT.ID}　　
----------------------------------------

----------------------------------------
keyword: zabbix
告警主机:{HOSTNAME1} {HOST.IP}
告警时间:{EVENT.DATE} {EVENT.TIME}
告警等级:{TRIGGER.SEVERITY}
告警信息: {TRIGGER.NAME}
告警项目:{TRIGGER.KEY1}
问题详情:{ITEM.NAME}:{ITEM.VALUE}
当前状态:{TRIGGER.STATUS}:{ITEM.VALUE1}
事件ID:{EVENT.ID}
----------------------------------------

image