1 媒介类型

概述

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

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

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

要了解媒体类型如何融入告警流程,我们先来看从 Zabbix 向最终用户发送通知所需的三个条件:

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

要测试已配置的媒体类型是否可用,请在媒体类型列表中点击 Test

测试请求将发送到 Zabbix 服务器。Zabbix 服务器将尝试使用指定的媒体类型发送告警,并将结果返回给前端。前端将等待服务器返回结果。媒体类型测试默认超时时间为 65 秒(可在 Administration > General > Timeouts 中配置)。

另请参阅以下测试详情:

配置

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

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

某些参数对所有传递方式都是通用的。

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

有关特定于方法的参数,请参见 emailSMScustom alertscriptwebhook 页面。

消息模板

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

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

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

请注意,如果在 action operations 中定义了自定义消息,则默认消息会被覆盖。

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

选项

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

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

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

用户媒体

虽然媒体类型定义了通知将如何发送,但用户媒体定义了通知必须发送到哪里

无论传递方式如何,都必须在用户配置文件中定义用户媒体(例如电子邮件地址、webhook 用户 ID 等)。如果未在 Admin 用户配置文件中定义 webhook X 的传递详情,则向 Admin 用户发送消息的操作将无法投递。

要定义用户媒体:

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

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