媒体类型

概述

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

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

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

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

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

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

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

另请参阅以下媒体类型的测试详情：

配置

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

  1. 转到 告警 > 媒体类型。
  2. 单击 创建媒体类型。
  3. 在表单中输入媒体类型的参数。

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

如果在 前端配置文件（zabbix.conf.php）的 $ZBX_FEATURE_FLAGS['media_type_denylist'] 功能标志中指定了一个或多个传递方法，则这些传递方法不会显示在 类型 列表中。

参数 描述
名称 媒体类型的名称。
类型 选择媒体类型的传递方法。
描述 输入媒体类型的描述。
启用 选中复选框以启用媒体类型。

有关特定于方法的参数，请参阅电子邮件、SMS、自定义告警脚本或webhook页面。

消息模板

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

单击 Add 以定义默认消息（或单击 Edit 更新现有消息）：

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

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

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

选项

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

所有媒介类型均会并行处理。
虽然可以按媒介类型配置并发会话的最大数量，但服务器上的 alerter 进程总数只能通过 StartAlerters 参数进行限制。
由一个触发器生成的告警会按顺序处理。
因此，只有在多个触发器生成通知时，才可能同时处理多个通知。

参数 描述
并发会话 选择该媒介类型的并行 alerter 会话数：
一个 - 一个会话
无限制 - 不限制会话数
自定义 - 选择自定义的会话数
无限制或较高的值意味着更多的并行会话，以及更高的通知发送容量。应在需要同时发送大量通知的大型环境中使用无限制或较高的值。
如果需要发送的通知数量超过并发会话数，剩余通知将进入队列；这些通知不会丢失。
尝试次数 尝试发送通知的次数。最多可指定 100 次尝试；默认值为“3”。如果指定“1”，Zabbix 将只发送一次通知；如果发送失败，则不会重试。
尝试间隔 发送失败时尝试重新发送通知的频率，单位为秒（0-3600）。如果指定“0”，Zabbix 将立即重试。
支持时间后缀（例如 30s、1m、1h）。

用户媒介

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

无论采用何种发送方式，都必须在用户配置文件中定义用户媒介（例如，电子邮件地址、webhook 用户 ID 等）。如果 webhook X 的发送详细信息未在 Admin 用户配置文件中定义，则使用 webhook X 向 Admin 用户发送消息的操作将无法成功发送。

要定义用户媒介：

  1. 转到 Users > Users，打开用户属性表单。
    或者，转到您自己的用户配置文件中的 User settings > Notifications。
  2. 在 Media 选项卡中单击 Add。
  3. 在表单中输入用户媒介参数。

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