这是原厂英文文档的翻译页面. 欢迎帮助我们 完善文档.

Sidebar

Zabbix Summit 2022
Register for Zabbix Summit 2022

4 Webhook

概览

webhook媒介类型对于使用自定义的JavaScript代码进行HTTP调用非常有用,它可以直接与外部软件(如Helpdesk系统、聊天工具或信使)集成。 您可以选择导入Zabbix已提供的集成,也可以从头创建一个自定义集成。

集成

以下集成允许使用预定义的webhook媒体类型来推送Zabbix通知:

除了这里列出的服务外,Zabbix还可以集成 Spiceworks (无需webhook)。要把Zabbix通知转换成Spiceworks对象,需先创建一个电子邮件媒体类型,在指定的Zabbix用户配置文件设置中输入Spiceworks helpdesk的邮件地址 (例如 [email protected])。

配置

开始使用webhook集成:

  1. 在已下载的Zabbix程序的 templates/media 目录中,找到所需的.xml文件;或者从Zabbix的git仓库中下载
  2. 将文件导入到Zabbix安装中。 Webhook将出现在媒体类型列表中。
  3. 根据 Readme.md 文件的说明来配置webhook (你也可以点击 webhook's 名称来快速访问 Readme.md)。

从零开始创建一个自定义的webhook:

  • 转到 // 管理 → 媒介类型 //
  • 点击 // 创建媒体类型 //

媒体类型 选项卡包含了针对这种媒体类型的各种属性:

红色星号标记的为必填字段。

webhook媒体类型的具体参数如下:

参数 描
参数 webhook变量作为属性和值对。
对于预先配置的webhook,参数列表会随着服务的不同而变化。检查webhook的 Readme.md 参数说明文件。
对于新的webhooks,默认情况下包含了几个常见的变量 (URL:<empty>, HTTPProxy:<empty>, To:{ALERT.SENDTO}, 主题:{ALERT.SUBJECT}, 消息:{ALERT.MESSAGE}), 你可以保留或删除它们。
值是url自动编码的。宏中的值会被解析,然后自动进行url编码。
参数中支持问题通知中支持的所有宏。
如果指定了HTTP Proxy,该字段支持与监控项配置 HTTP proxy 字段相同的功能。 Proxy字符串可以加上前缀 [scheme]:// 来指定使用哪种代理 (例如 https, socks4, socks5; 请参见 documentation)。
脚本 击参数字段(或旁边的视图/编辑按钮)时出现的块中输入JavaScript代码。这段代码将执行webhook操作。
代码可以访问所有参数,它可以执行HTTP GET、POST、PUT和DELETE请求,并可控制HTTP头和请求正文。它可以返回OK状态,以及一个可选的标签列表和标签值(例如, Jira ID: PROD-1234, Responsible: John Smith, Processed:<no value>, 等等) 或一个错误的字符串。
另请参阅: Webhook脚本范例; 额外的JavaScript对象
注意 脚本只有在创建警报之后才会执行。如果脚本被配置为返回和处理标签 (参见 Process tags 选项),这些标签将不会在初始问题消息和恢复消息中的 {EVENT.TAGS} 和 {EVENT.RECOVERY.TAGS} 宏中解析,因为脚本还没有时间运行。
超时 J vaScript执行超时 (1-60s, 默认为30s)。
支持时间后缀, 例如 30s, 1m。
Process tags 选中复选框标以将返回的JSON属性值作为标记处理。这些标记被添加到Zabbix中已经存在的(如果有的话)问题事件标记中。
Include event menu entry 选中复选框以在 事件菜单 中包含一个链接到创建的外部目标的条目。
若选中此项,webhook就不应该被用来向不同的用户发送通知 (考虑创建一个 专用用户) 或者在几个告警动作中关联单个问题事件
Menu entry name 指定菜单入口名称。
支持 {EVENT.TAGS.<tag name>} 宏。
只有当 Include event menu entry 被选中时,该字段才为必填项。
Menu entry URL 指定菜单入口的URL。
支持{EVENT.TAGS.<tag name>} 宏。
只有当 Include event menu entry 被选中时,该字段才为必填项。

关于如何配置默认消息和警报处理选项的详细信息,请参见通用媒介类型参数

即使webhook不使用默认消息,webhook使用的操作类型的消息模板也必须定义。

用户媒介

媒介类型配置完成后, 转到 管理 → 用户 部分,将webhook媒介分配给一个现有用户或创建一个新用户来表示webhook。媒介类型 页面中描述了为现有用户设置用户媒体的步骤,这对于所有媒体类型都是通用的。

如果webhook使用标签来存储 ticket\message ID, 避免将同一个webhook作为媒体分配给不同的用户,因为这样做可能会导致webhook错误 (适用于大多数使用了 Include event menu entry 选项)。 在这种情况下,最好的做法是创建一个专用的用户来表示webhook:

  1. 配置好webhook媒体类型后, 前往 管理 → 用户 部分,并创建一个专用的Zabbix用户来表示webhook - 例如, 为 Slack webhook添加一个别名 Slack。 所有的设置可以保持默认值(除了媒体),因为这个用户不会登录到Zabbix。
  2. 在用户配置中, 进入 Media 选项卡 和 添加webhook ,提供所需的联系信息。 如果webhook没有使用 发送到 字段, 输入任何支持的字符组合来绕过验证要求。
  3. 至少授予该用户对要向其发送警报的所有主机有可读的 权限

配置告警动作时,请在 发送到用户 字段中添加该用户 - 这将告诉Zabbix使用webhook来获取来自这个动作的通知。

配置告警动作

告警动作决定了哪些通知应该通过webhook发送。webhook的配置动作 步骤与所有其他媒体类型相同,但有以下例外:

  • 如果webhook使用标签来存储 ticket\message ID 以及后续的 update\resolve 操作, 这个webhook不应该用于单个问题事件的多个告警动作中。这适用于Zabbix提供的Jira, Jira Service Desk, Mattermost, Opsgenie, OTRS, Redmine, ServiceNow, Slack, Zammad和Zendesk webhooks以及大多数使用 Include event menu entry 选项的webhook。 允许在多个操作中使用webhook,如果这些操作或升级步骤属于同一个操作。在不同的动作中使用这个webhook也是可以的,由于不同的筛选器条件,操作不会应用到相同的问题事件中。
  • 当在动作中使用webhook用于 内部事件: 在动作操作配置中,选中复选框 自定义消息 复选框,输入自定义消息内容 ,否则通知不会被发送出去。