查看“钉钉机器人zabbix报警”的源代码

=安装Python3、相关包以及创建钉钉发送消息日志文件=
<pre>
#这个看你自己的情况
# 安装python3，脚本是基于Python3写的
yum install -y python3

# 安装pip，pip是python的包管理器
# 下载pip安装脚本
curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
# 运行安装脚本
sudo python3 get-pip.py
# 安装puthon包
pip3 install configparser
pip3 install requests
# 创建钉钉发送日志文件路径
touch /var/log/zabbix/zabbix_ding.log
chown zabbix.zabbix /var/log/zabbix/zabbix_ding.log
</pre>

=首先在钉钉群聊里添加一个自定义的机器人=
并复制webhook的内容 如下面 创建新建群手加入 机器人就可得到

https://oapi.dingtalk.com/robot/send?access_token=37e23308d1b84eb4ac34566e03c4c4e74b7eedecbcc002exxxxxxxxxxxxxxx
 还有一个 安全设置 -- 加签 时得到

=创建脚本=
在zabbix服务端的alertscripts目录下新建一个python脚本
==py3 Oct 2021==
<pre>

#pre config


# 查看zabbix的脚本默认路径，请注意使用您自己的zabbix_server.conf 类似这个样子
cat /etc/zabbix/zabbix_server.conf |grep AlertScriptsPath
### Option: AlertScriptsPath
# AlertScriptsPath=${datadir}/zabbix/alertscripts
AlertScriptsPath=/usr/lib/zabbix/alertscripts


 添加配置文件zabbix_ding.conf，并将文件上传至/etc/zabbix/下(进入容器) 或者放在母机指定的mount的目录中 例如下面的py3 脚本 ding.py

[config]
# 日志文件
log_path=/var/log/zabbix/zabbix_ding.log
#钉钉机器人 webhook 值
webhook=https://oapi.dingtalk.com/robot/send?access_token=b3e6fa0f410e7ced04c81680f036xxxx
# 安全设置 -- 加签 时得到
secret=SEC64d20b4e9d2e2677f7aa01d2a7c2f9xxxx





cat ding.py 
#!/usr/bin/env python3
# coding:utf8
#pwd  docker目录  zbx_env/usr/lib/zabbix/alertscripts
import configparser
import os
import time
import hmac
import hashlib
import base64
import urllib.parse
import requests
import json
import sys

config = configparser.ConfigParser()
config.read('/etc/zabbix/zabbix_ding.conf', encoding='utf-8')
log_path = config.get('config', 'log_path')
api_url = config.get('config', 'webhook')
api_secret = config.get('config', 'secret')
log_time = time.strftime("%Y-%m-%d %H:%M:%S", time.localtime())


# 钉钉机器人文档说明
# https://ding-doc.dingtalk.com/doc#/serverapi2/qf2nxq
def get_timestamp_sign():
    timestamp = str(round(time.time() * 1000))
    secret = api_secret
    secret_enc = secret.encode('utf-8')
    string_to_sign = '{}\n{}'.format(timestamp, secret)
    string_to_sign_enc = string_to_sign.encode('utf-8')
    hmac_code = hmac.new(secret_enc, string_to_sign_enc, digestmod=hashlib.sha256).digest()
    sign = urllib.parse.quote_plus(base64.b64encode(hmac_code))
    return timestamp, sign

# 获取加签后的链接
def get_signed_url():
    timestamp, sign = get_timestamp_sign()
    webhook = api_url + "&timestamp=" + timestamp + "&sign=" + sign
    return webhook

# 定义消息模式
def get_webhook(mode):
    if mode == 0:  # only 关键字
        webhook = api_url
    elif mode == 1 or mode == 2:  # 关键字和加签 或 # 关键字+加签+ip
        webhook = get_signed_url()
    else:
        webhook = ""
        print("error! mode:   ", mode, "  webhook :  ", webhook)
    return webhook


def get_message(text, user_info):
    # 和类型相对应，具体可以看文档 ：https://ding-doc.dingtalk.com/doc#/serverapi2/qf2nxq
    # 可以设置某个人的手机号，指定对象发送
    message = {
        "msgtype": "text",  # 有text, "markdown"、link、整体跳转ActionCard 、独立跳转ActionCard、FeedCard类型等
        "text": {
            "content": text  # 消息内容
        },
        "at": {
            "atMobiles": [
                user_info,
            ],
            "isAtAll": False  # 是否是发送群中全体成员
        }
    }
    return message


# 消息发送日志
def log(info):
    if os.path.exists(log_path):
        log_file = open(log_path, "a+")
    else:
        log_file = open(log_path, "w+")
    log_file.write(info)


def send_ding_message(text, user_info):
    # 请求的URL，WebHook地址
    # 主要模式有 0 ： 关键字 1：# 关键字 +加签 3：关键字+加签+IP
    webhook = get_webhook(1)
    # 构建请求头部
    header = {
        "Content-Type": "application/json",
        "Charset": "UTF-8"
    }
    # 构建请求数据
    message = get_message(text, user_info)
    # 对请求的数据进行json封装
    message_json = json.dumps(message)
    # 发送请求
    info = requests.post(url=webhook, data=message_json, headers=header).json()
    code = info["errcode"]
    errmsg = info["errmsg"]
    if code == 0:
        log(log_time + ":消息已发送成功 返回信息:%s %s\n" % (code, errmsg))
    else:
        log(log_time + ":消息发送失败 返回信息:%s %s\n" % (code, errmsg))
        print(log_time + ":消息发送失败 返回信息:%s %s\n" % (code, errmsg))
        exit(3)


if __name__ == "__main__":
    text = sys.argv[3]
    user_info = sys.argv[1]
    send_ding_message(text, user_info)




zbx_env/usr/lib/zabbix/alertscripts

alertscripts]# chmod +x ding.py
</pre>

==py2  2018 ==
<pre>
#!/usr/bin/python
#-*- coding: utf-8 -*-
# Author evan this one f17   cat /usr/lib/zabbix/alertscripts/ding.py
import requests
import json
import sys
import  os
headers = {'Content-Type': 'application/json;charset=utf-8'}
api_url="https://oapi.dingtalk.com/robot/send?access_token=709ea577d2cd4f8e6975be37fc177307b38fc1d32c322dded89723d3ff58e"
def msg(text):
    json_text= {
        "msgtype": "text",
         "text": {
             "content": text
        },
        "at": {
            "atMobliles": [
                "18520124378","18578776813"
            ],
             "isAtAll": False
         }

    }
    print requests.post(api_url,json.dumps(json_text),headers=headers).content
                        
if __name__ == '__main__':
    text = sys.argv[1]
    msg(text)

#参考一下以前的爬虫 相关参考请看 自定义机器人
</pre>

=Web端配置=
<pre>
我没写详情 请见
状态  已启用 才行  see also参考中的 Zabbix5.0使用钉钉机器人报警 WEB界面配置详情good


发送消息给用户群组: Zabbix administrators 通过 所有介质
	已启用

动作要选择为  触发器示警度 大于等等 警告

用户 --> 报警媒介--> 收件人 可以填写 ding手机号码 或者 dingding号 -->  被填写的会@


报警媒介类型 最右边  测试  
</pre>

=troubleshooting=
<pre>




trouble 

readonly 是docker-compose 配置 直接去母机  
zbx_env/usr/lib/zabbix/alertscripts



alertscripts]# chmod +x ding.py

Media type test failed.

    Cannot execute command "/usr/lib/zabbix/alertscripts/ding.py": [2] No such file or directory



有时重启不成功
zabbix_zabbix-server_1


关掉机器人中的 自定义关键词


// 消息内容中不包含任何关键词
{
  "errcode":310000,
  "errmsg":"keywords not in content"
}

 # python3 ding.py  user subject message 
2021-10-19 11:25:09:消息发送失败 返回信息:310000 keywords not in content, more: [https://ding-doc.dingtalk.com/doc#/serverapi2/qf2nxq]

/usr/lib/alertscripts # vi /etc/zabbix/zabbix_ding.conf 
/usr/lib/alertscripts # python3 ding.py  user subject message 


https://developers.dingtalk.com/document/robots/custom-robot-access?spm=ding_open_doc.document.0.0.7f875e591WwbnS#topic-2026027


自己笨蛋 加多了一行只有 secret的字符 所以格式不对 
usr/lib/alertscripts # python3 ding.py  user subject message 
Traceback (most recent call last):
  File "ding.py", line 16, in <module>
    config.read('/etc/zabbix/zabbix_ding.conf', encoding='utf-8')
  File "/usr/lib/python3.8/configparser.py", line 697, in read
    self._read(fp, filename)
  File "/usr/lib/python3.8/configparser.py", line 1113, in _read
    raise e
configparser.ParsingError: Source contains parsing errors: '/etc/zabbix/zabbix_ding.conf'
	[line  4]: 'SEC55daeeadd5fe85c58550e5f19d63d50dd34a35859767dd315a3fd4538d54622a\n'
/usr/lib/alertscripts # vi /etc



log 

/usr/lib/alertscripts # tail -f  /var/log/zabbix_ding.log 
2021-10-19 11:25:09:消息发送失败 返回信息:310000 keywords not in content, more: [https://ding-doc.dingtalk.com/doc#/serverapi2/qf2nxq]
2021-10-19 11:31:15:消息已发送成功 返回信息:0 ok
2021-10-19 11:32:45:消息已发送成功 返回信息:0 ok



</pre>

=脚本学习详情=

[[Python json]]

[[Python Requests]]

[https://open-doc.dingtalk.com/docs/doc.htm?spm=a219a.7629140.0.0.karFPe&treeId=257&articleId=105735&docType=1 返回格式自定义]

=come from chatgpt 2024=
要使用 Python 将 Zabbix 告警通过钉钉（DingTalk）推送，可以通过钉钉的机器人 API 实现。这个流程与之前对接微信的方式相似，主要是通过调用钉钉机器人接口，将 Zabbix 的告警消息发送到指定的钉钉群聊。
1. 准备工作

    创建钉钉机器人：登录钉钉并进入你想接收告警信息的群聊，创建一个群机器人。
        点击群设置 -> 群机器人。
        添加一个自定义机器人，并选择安全设置，比如设置一个“加签”或“关键词”等方式确保消息的安全性。
        记下生成的 Webhook URL，它将用于在 Python 脚本中发送消息。

2. 编写 Python 脚本

下面是一个使用 Python 调用钉钉 API 的示例脚本，结合 Zabbix 告警的推送
<pre>
import requests
import json
import hashlib
import hmac
import base64
import time
import urllib.parse

# 钉钉 Webhook URL，替换为你自己的 Webhook 地址
WEBHOOK_URL = 'https://oapi.dingtalk.com/robot/send?access_token=your_access_token'

# 如果启用了加签功能，请替换为你的加签密钥
SECRET = 'your_secret'  # 如果没有加签功能可以忽略

# 生成带有加签的请求 URL
def generate_sign():
    timestamp = str(round(time.time() * 1000))
    secret_enc = SECRET.encode('utf-8')
    string_to_sign = '{}\n{}'.format(timestamp, SECRET)
    string_to_sign_enc = string_to_sign.encode('utf-8')
    hmac_code = hmac.new(secret_enc, string_to_sign_enc, digestmod=hashlib.sha256).digest()
    sign = urllib.parse.quote_plus(base64.b64encode(hmac_code))
    return f"&timestamp={timestamp}&sign={sign}"

# 发送钉钉消息
def send_dingding_message(content):
    headers = {
        "Content-Type": "application/json"
    }
    data = {
        "msgtype": "text",
        "text": {
            "content": content
        },
        "at": {
            "isAtAll": False  # 如果需要艾特所有人，将其设为 True
        }
    }

    # 如果使用了加签，将签名加到 URL 上
    if SECRET:
        url_with_sign = WEBHOOK_URL + generate_sign()
    else:
        url_with_sign = WEBHOOK_URL

    response = requests.post(url_with_sign, headers=headers, data=json.dumps(data))
    result = response.json()
    if result.get("errcode") == 0:
        print("消息发送成功")
    else:
        print(f"消息发送失败: {result}")

# 示例主函数，发送告警
if __name__ == '__main__':
    alert_message = "Zabbix 告警：某某服务器 CPU 使用率过高！"  # 替换为你的告警内容
    send_dingding_message(alert_message)

</pre>
3. 在 Zabbix 中集成 Python 脚本

    将 Python 脚本保存到 Zabbix 服务器，例如将其保存为 /usr/lib/zabbix/alertscripts/dingding.py。

    修改脚本权限： 确保 Zabbix 用户对该脚本具有执行权限：

    bash

chmod +x /usr/lib/zabbix/alertscripts/dingding.py

配置 Zabbix 的报警媒介类型：

    登录 Zabbix Web 管理界面。
    进入“管理（Administration）” -> “媒介类型（Media types）”。
    点击“创建媒介类型（Create Media Type）”，选择脚本（Script）类型。
    在脚本名称中填写你创建的 Python 脚本的名称（如 dingding.py），并定义参数：
        参数1：{ALERT.SUBJECT}（告警标题）
        参数2：{ALERT.MESSAGE}（告警内容）

为用户配置告警媒介：

    进入“配置（Configuration）” -> “用户（Users）”页面。
    选择要接收告警的用户，进入“告警媒介（Media）”选项卡。
    点击“添加（Add）”，选择刚刚创建的钉钉媒介类型。

配置告警动作：

    进入“配置（Configuration）” -> “动作（Actions）”页面。
    创建或编辑一个动作（Action），设置触发条件。
    在操作（Operation）中，选择发送告警到钉钉的用户和媒介。

4. 测试告警

配置完成后，触发一个测试告警，查看是否能够通过钉钉收到 Zabbix 的告警信息。你可以通过模拟系统资源异常或手动触发告警来进行测试。
5. 钉钉消息内容优化

你可以根据自己的需求对消息的格式进行调整。比如，可以将 msgtype 改为 markdown，以便支持更丰富的告警内容展示。下面是一个示例：

python

data = {
    "msgtype": "markdown",
    "markdown": {
        "title": "Zabbix 告警",
        "text": f"**Zabbix 告警**\n\n告警详情：\n{content}"
    },
    "at": {
        "isAtAll": False
    }
}

这样可以在钉钉中收到更直观的告警信息，包括标题和加粗的告警详情

=see also=


[https://www.cnblogs.com/apnpc/p/13780080.html 【Zabbix】5.0版本钉钉告警Python3脚本及配置 OK]

[https://blog.51cto.com/u_9025736/2591646  Zabbix5.0使用钉钉机器人报警 WEB界面配置详情good]

[https://blog.whsir.com/post-6090.html Zabbix5.0钉钉报警设置]

[https://blog.csdn.net/qq_40165796/article/details/109849914  Zabbix5.0钉钉告警实战 初级但是讲得很详细]

[https://www.cnblogs.com/LiuChang-blog/p/14704185.html Zabbix5.0钉钉报警(centos7)算详情]

[https://gitbook.curiouser.top/origin/dingding-customrobot.html 钉钉的机器人]


[https://www.cnblogs.com/baishuchao/p/8608818.html 钉钉机器人zabbix报警]

[https://zhuanlan.zhihu.com/p/35864201 Zabbix监控实现钉钉报警]

[https://yq.aliyun.com/articles/510572 zabbix监控钉钉报警配置]

[http://blog.51cto.com/wzlinux/1978792 Zabbix 3.4.3通过钉钉机器人报警]

[https://open-doc.dingtalk.com/docs/doc.htm?spm=a219a.7629140.0.0.karFPe&treeId=257&articleId=105735&docType=1 自定义机器人]

[http://blog.51cto.com/m51cto/2051945 python之钉钉机器人zabbix报警]

[http://blog.51cto.com/dyc2005/2079970 zabbix邮件报警及自定义脚本实战]

[https://www.clxz.top/2019/03/31/111216/ 利用Python编写钉钉机器人脚本，实现Zabbix自动化监控]


[[category:python]] [[category:zabbix]]