Z投稿|Zabbix 5.0 企业微信 WebHook 实现故障文本告警

小谈谈 BH1XAQ

云计算运维工程师
曾主导某高校 Zabbix 监控系统的部署架构，致力于使用自动化运维技术，降低运维人员工作压力。
目前研究方向为多场景下 Zabbix 监控系统的落地以及 Zabbix 监控系统的二次开发。

Zabbix 5.0对于告警（报警媒介）进行了扩展和优化，可以直接支持 WebHook 类型的报警媒介。我们再开发企业微信机器人可以直接通过 JavaScript 语言编写脚本，因为得到了 Zabbix 的原生支持，告警脚本通用性强且更加灵活。本文将分享如何通过 Zabbix 报警媒介在企业微信发送告警信息。

一、注册企业微信机器人

首先需要先在自己的企业微信群里创建一个机器人，并获取其 WebHook 地址。右击群聊天卡片，添加群机器人。

为你的机器人起一个名字，点击确定，获得一个类似下图的 WebHook 地址。注意，这个 WebHook 地址非常重要，请不要泄露，否则他人可以通过这个地址给你捣乱。把这个地址复制出来，后面需要用到。

二、创建告警媒介

名称	值
Message	{ALERT.MESSAGE}
Subject	{ALERT.SUBJECT}
Key	Your Bot Key

这里的 Key 就是刚刚注册机器人时候生成的 WebHook 地址末尾的 Key，例如你的地址是https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=574c6d4e-544c-4baf-ae9a-b935dbc1be46，则这里你需要填写574c6d4e-544c-4baf-ae9a-b935dbc1be46。

脚本可以参考如下的代码段。直接复制到脚本代码框中即可。

代码语言：javascript复制

var Qiyeweixin = {
  key: null,

  message: null,
  msgtype: "markdown",
  proxy: null,

  sendMessage: function () {
    var params = {
        msgtype: Qiyeweixin.msgtype,
        markdown: {
          content: Qiyeweixin.message,
        },
      },
      data,
      response,
      request = new CurlHttpRequest(),
      url =
        "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key="  
        Qiyeweixin.key;

    if (Qiyeweixin.proxy) {
      request.setProxy(Qiyeweixin.proxy);
    }

    request.AddHeader("Content-Type: application/json");
    data = JSON.stringify(params);

    // Remove replace() function if you want to see the exposed key in the log file.
    Zabbix.Log(
      4,
      "[Qiyeweixin Webhook] URL: "   url.replace(Qiyeweixin.key, "<BOT KEY>")
    );
    Zabbix.Log(4, "[Qiyeweixin Webhook] params: "   data);
    response = request.Post(url, data);
    Zabbix.Log(4, "[Qiyeweixin Webhook] HTTP code: "   request.Status());

    try {
      response = JSON.parse(response);
    } catch (error) {
      response = null;
    }

    if (request.Status() !== 200 || response.errcode !== 0) {
      if (typeof response.errmsg === "string") {
        throw response.errmsg;
      } else {
        throw "Unknown error. Check debug log for more information.";
      }
    }
  },
};

try {
  var params = JSON.parse(value);

  if (typeof params.Key === "undefined") {
    throw 'Incorrect value is given for parameter "Key": parameter is missing';
  }

  Qiyeweixin.key = params.Key;

  if (params.HTTPProxy) {
    Qiyeweixin.proxy = params.HTTPProxy;
  }

  Qiyeweixin.to = params.To;
  Qiyeweixin.message = params.Subject   "n"   params.Message;
  Qiyeweixin.sendMessage();

  return "OK";
} catch (error) {
  Zabbix.Log(4, "[Qiyeweixin Webhook] notification failed: "   error);
  throw "Sending failed: "   error   ".";
}

超时给 10s 即可。最后配置完成后，应该是如下图的样子。