Table of Contents
1 媒介类型
概述
媒体是Zabbix用于发送通知和告警的传递渠道.
您可以配置多种媒体类型:
媒体类型配置位于管理 → 媒体类型.
部分媒体类型在默认数据集中已预定义. 您只需微调其参数以get使其正常工作.
可通过点击最后一列的测试来验证配置的媒体类型是否正常工作(详见媒体类型测试).
要create新的媒体类型，请点击创建媒体类型按钮. 系统将打开媒体类型配置表单.
通用参数
某些参数对所有媒介类型都是通用的。
在媒介类型标签页中，常见的通用属性包括：
| 参数 | 描述 |
|---|---|
| Name | 媒体类型的名称。 |
| Type | 选择媒介类型。 |
| Description | 输入描述。 |
| Enabled | 勾选复选框以启用该媒介类型。 |
请参阅各媒介类型页面以获取特定媒介的参数。
消息模板选项卡允许设置默认通知 以下部分或全部事件类型的消息：
- 问题
- 问题恢复
- 问题 update
- 服务
- 服务恢复
- 服务 update
- 发现
- 自动注册
- 内部问题
- 内部问题恢复
要自定义消息模板：
- 在消息模板标签页中点击
: 一条消息 模板弹出窗口将打开。 - 选择所需的消息类型并编辑主题和消息 文本
- 点击 添加 保存消息模板
消息模板参数:
| 参数 | 描述 |
|---|---|
| Message type | 应使用默认消息的事件类型。 每种事件类型只能定义一个默认消息。 |
| Subject | 默认消息的主题。主题可包含宏变量，长度限制为255个字符。 短信媒介类型不支持主题设置。 |
| Message | 默认消息. 其字符长度受限于数据库类型(详见Sending messages获取更多信息). 该消息可包含支持的macros. 在问题及问题update消息中,支持表达式宏(例如 {?avg(/host/key,1h)}). |
要对现有消息模板进行修改：在Actions列中 点击 
进行编辑 该模板或点击 
到 delete 该 消息模板
可以为特定操作定义自定义消息模板 (参见操作详情 有关详细信息）。在操作配置中定义的自定义消息将 覆盖默认媒介类型消息模板。
定义消息模板对所有情况都是强制性的 媒体类型，包括不使用webhook或自定义告警脚本 通知的默认消息。例如，一个动作"发送消息" 若未配置"Pushover webhook"，将无法发送问题通知 Pushover webhook的问题消息未定义。
选项选项卡包含告警处理设置。同一组 每种媒体类型均可配置选项。
所有媒体类型均并行处理。当最大数量达到时 每种媒体类型均可配置并发会话数，总数量为 服务器上的alerter进程只能通过StartAlerters参数进行限制 parameter. 由以下情况生成的告警 一个触发器会按顺序处理。因此可能会产生多个通知 仅当它们由多个来源同时生成时才会被并行处理 触发器。
| 参数 | 描述 |
|---|---|
| Concurrent sessions | 选择该媒介类型的并行告警会话数量: One - 单个会话 Unlimited - 无限制会话数量 Custom - 自定义会话数量 无限制/高数值意味着更多并行会话及更高的通知发送能力。无限制/高数值应在大规模环境中使用，这些环境可能需要同时发送大量通知。 若需发送的通知数量超过并发会话数，剩余通知将进入队列而不会丢失。 |
| Attempts | 尝试发送通知的尝试次数. 最多可指定100次尝试, 默认值为'3'. 如果指定'1', Zabbix将仅发送通知一次, 如果发送失败则不会重试. |
| Attempt interval | 通知发送失败时重试发送的频率，单位为秒（0-3600）。若指定为'0'，Zabbix将立即重试。 支持时间后缀，例如5s、3m、1h。 |
媒介类型测试
可以测试已配置的媒介类型是否正常工作。
测试请求将被发送至Zabbix server。Zabbix server将尝试使用指定的媒介类型发送警报，并将结果返回至前端界面。前端界面将等待服务器返回测试结果。
电子邮件
例如，要测试电子邮件媒介类型：
- 在媒介类型列表中找到对应的电子邮件配置
- 点击列表最后一列的测试按钮（将弹出测试窗口）
- 输入收件人地址、邮件正文及可选主题
- 点击测试发送测试邮件
测试成功或失败消息将显示在同一窗口中：
 |
|---|
Webhook
测试webhook媒介类型：
- 在媒介类型列表中找到对应的webhook配置
- 点击列表最后一列的测试按钮（将弹出测试窗口）
- 按需编辑webhook参数值
- 点击测试
默认情况下，webhook测试使用配置期间输入的参数执行。但可以修改属性值进行测试。在测试窗口中替换或删除值仅影响测试过程，实际webhook属性值将保持不变。
 |
|---|
要在不离开测试窗口的情况下查看媒介类型测试日志条目：
- 点击打开日志（将弹出新窗口）
 |
|---|
如果 webhook 测试成功
- 显示"媒体类型测试成功。"消息
- 服务器响应出现在灰色的响应字段中
- 响应类型（JSON或string）在响应字段下方指定
如果 webhook 测试失败
- 显示"媒体类型测试失败。"消息，随后附上额外的失败详情。
用户媒介
要接收某种媒介类型的通知，必须在用户配置文件中定义该媒介类型对应的联系方式（电子邮件地址/电话号码/Webhook用户ID等）。例如，若用户"Admin"的配置文件中未定义Webhook "X"的接收方式，则使用Webhook "X"向该用户发送消息的操作将始终失败。
定义用户媒介的步骤：
进入您的用户配置文件，或前往管理 → 用户并打开用户属性表单
在"媒介"标签页中，点击
用户媒介属性说明：
| 参数 | 描述 |
|---|---|
| Type | 下拉列表包含所有已配置的媒介类型名称。 |
| Send to | 提供发送消息所需的联系信息。 对于电子邮件媒介类型，可通过点击地址栏下方的 添加多个地址。此时通知将发送至所有提供的邮箱地址。也可在"发送至"字段中使用'收件人名称 <[email protected]>'格式指定收件人名称。注意若提供收件人名称，邮箱地址需用尖括号(<>)包裹。名称支持UTF-8字符，但不支持引号对和注释。例如：John Abercroft <[email protected]> 和 [email protected] 均为有效格式。错误示例：John Doe [email protected], %%"Zabbix\@\<H(comment)Q\>" [email protected] %%。 |
| When active | 可限制消息发送时段，例如仅设置工作日(1-5,09:00-18:00)。注意该限制基于用户time zone的时区。若用户时区变更且与系统时区不同，可能需要相应调整此限制以避免遗漏重要消息。 格式说明详见Time period specification页面。 |
| Use if severity | 勾选需要接收通知的触发器严重级别。 注意：若要接收非触发器events的通知，则必须勾选默认严重级别（'未分类'）。 保存后，所选严重级别将显示对应颜色，未选级别则显示为灰色。 |
| Status | 用户媒介状态。 启用 - 正在使用。 禁用 - 未使用。 |