1 媒介类型

概述

媒体类型是用于从 Zabbix 发送通知和告警的传递渠道。

媒体类型支持以下传递方式:

媒体类型在 告警 > 媒体类型 中维护。某些媒体类型在默认数据集中已预先定义。
您只需微调其参数即可使其正常工作。

要了解媒体类型如何融入告警流程,我们来看一下将通知从 Zabbix 传递给最终用户所需的三个条件:

  1. 必须定义一个用于发送通知的动作操作
  2. 必须定义一个可正常工作的媒体类型(例如使用 SMTP 发送告警的 电子邮件
  3. 必须在用户媒体中定义用户级别的传递详细信息(例如电子邮件地址、电话号码等)
媒介类型测试

要测试已配置的媒介类型是否正常工作,请在媒介类型列表中点击 测试

测试请求将被发送到 Zabbix 服务器。Zabbix 服务器将尝试使用指定的媒介类型发送告警,并将结果返回到前端。前端将等待服务器返回结果。默认情况下,媒介类型测试的超时时间为 65 秒(可在 管理 > 常规 > 超时 中配置)。

另请参阅以下测试详情:

配置

要在 Zabbix 前端中创建媒体类型:

  • 前往:告警 > 媒体类型
  • 点击 创建媒体类型
  • 在表单中输入媒体类型的参数

某些参数对于所有发送方式都是通用的。

参数 说明
名称 媒体类型的名称。
类型 选择该媒体类型的发送方式。
描述 输入该媒体类型的描述。
已启用 勾选复选框以启用该媒体类型。

有关特定发送方式的参数,请参见 emailSMS自定义 alertscriptwebhook 页面。

消息模板

消息模板选项卡包含按事件类型划分的默认消息(问题、问题恢复、发现等)。

点击 添加 以定义默认消息(或点击 编辑 以更新现有消息):

参数 说明
消息类型 应使用默认消息的事件类型。
每种事件类型只能定义一条默认消息。
主题 默认消息的主题。主题中可包含宏。长度限制为 255 个字符。
SMS 媒介类型不提供主题。
消息 默认消息。其长度限制取决于数据库类型(更多信息请参见发送消息)。
消息中可包含受支持的
在问题消息和问题更新消息中,支持表达式宏(例如 {?avg(/host/key,1h)})。

请注意,如果在动作操作中定义了自定义消息,则默认消息会被其覆盖。

为所有传递方式定义消息模板都是必需的,
包括那些不会使用默认消息进行通知的 webhook 或自定义告警脚本。
例如,如果未为 Pushover webhook 定义问题消息,则动作“发送消息到 Pushover webhook”将无法发送问题通知。

选项

选项选项卡包含告警处理设置。
每种媒体类型都可以配置相同的一组选项。

所有媒体类型都会并行处理。
虽然每种媒体类型的最大并发会话数都可以单独配置,
但服务器上的告警器进程总数只能通过 StartAlerters 参数 进行限制。
由同一个触发器生成的告警会按顺序处理。
因此,只有当通知由多个触发器生成时,才可能同时处理多条通知。

参数 说明
并发会话 选择该媒体类型的并行告警器会话数量:
One - 一个会话
Unlimited - 无限制数量的会话
Custom - 选择自定义会话数量
无限制/较高的值意味着更多并行会话,以及更高的通知发送能力。无限制/较高的值适用于大型环境,在这些环境中可能需要同时发送大量通知。
如果需要发送的通知数量超过并发会话数,其余通知将进入队列;它们不会丢失。
尝试次数 尝试发送通知的次数。最多可指定 100 次尝试;默认值为“3”。如果指定为“1”,Zabbix 只会发送一次通知,若发送失败则不会重试。
尝试间隔 发送失败时重新尝试发送通知的频率,以秒为单位 (0-3600)。如果指定为“0”,Zabbix 将立即重试。
支持时间后缀,例如 5s、3m、1h。

用户媒介

媒介类型定义通知将如何发送,而用户媒介定义通知必须发送到哪里

无论使用哪种传递方式,都必须在用户资料中定义用户媒介(例如电子邮件地址、webhook 用户 ID 等)。如果在 Admin 用户资料中未定义 webhook X 的传递详细信息,则使用 webhook XAdmin 用户发送消息的动作将无法投递。

要定义用户媒介:

  • 转到 Users > Users 并打开用户属性表单(或者转到您自己的用户资料中的 User settings > Notifications
  • 在 Media 选项卡中单击 Add

参数 描述
Type 下拉列表包含已启用媒介类型的名称。
请注意,编辑属于已禁用媒介类型的媒介时,该类型将以红色显示。
Send to 输入消息应发送到的联系信息。
对于电子邮件媒介类型,可以通过单击地址字段下方的 按钮添加多个地址。在这种情况下,通知将发送到列出的所有地址。有关地址示例,请参见媒介类型 emailEmail 参数说明。
When active 您可以限制消息发送的时间,例如仅设置工作日(1-5,09:00-18:00)。请注意,此限制基于用户的时区。如果用户时区已更改且与系统时区不同,则可能需要相应调整此限制,以免错过重要消息。
有关格式说明,请参见时间段规范页面。
支持用户宏。
Use if severity 勾选您希望接收通知的触发器严重性复选框。
注意,如果您希望接收非触发器事件的通知,则必须勾选默认严重性(“Not classified”)。
保存后,所选触发器严重性将以相应的严重性颜色显示,而未选中的将显示为灰色。
Status 用户媒介的状态。
Enabled - 正在使用。
Disabled - 未使用。