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