2022 Zabbix中国峰会
2022 Zabbix中国峰会

1 媒介类型

概述

媒介是Zabbix中用于发送通知和告警的传输通道。

您可以配置多种媒介类型:

媒介类型在 管理媒介类型 中进行配置。

有些媒介类型是在默认数据集中预定义的。您只需要微调它们的参数,即可使其工作。

单击最后一列的 // 测试 //,可以测试配置好的媒介类型是否工作正常。(更多详细信息请参见 媒介类型测试 )。

点击 创建媒介类型 按钮来创建一个新的媒体类型,就会打开一个媒体类型的配置表单。

通用参数

有些参数对于所有媒介类型都是通用的。

媒介类型 选项卡中,常见的一般属性有:

参数 说
名称 类型的名称。
类型 媒介类型。
描述 媒介类型的描述。
已启用 选中 选框以启用此媒介类型。

有关媒介特定的参数,请参见媒介类型的各个页面。

消息模板 选项卡可以为以下的所有或部分事件类型设置默认的通知消息:

  • 问题
  • 问题恢复
  • 问题更新
  • 自动发现
  • 自动注册
  • 内部问题
  • 内部问题恢复

自定义消息模板的步骤:

  • 消息模板 选项卡中,点击 : 将打开一个 消息模板 的弹出窗口。
  • 选择所需的 消息类型 ,编辑 主题消息 文本。
  • 点击 添加 保存消息模板

消息模板的参数:

参数
消息类型 择为 种事件类型定义默认消息。
每种事件类型只能定义一个默认消息。
主题 消息的主题(可包含宏)。主题长度最多为255个字符。
主题不适用于短消息媒介类型。
消息 消息的内容(可包含宏)。具体能在消息中输入多少个字符取决于数据的类型(了解更多信息请参见 发送消息) 。

要更改现有的消息模板,请执行以下操作: 在 动作 那一栏点击 编辑模板或者点击 删除消息模板。

还可以为每个动作单独定义通知消息模板(详情请见 动作操作 )。动作中的自定义消息可以覆盖为媒介类型配置的消息模板。

必须为所有媒体类型定义消息模板,包括未使用默认消息通知的webhook或自定义报警脚本。比如,如果没有为Pushover webhook定义异常消息,“Send message to Pushover webhook”将无法发送异常通知。

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

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

参数 描
并发会话 为该媒 类型选择并行报警程序会话的数量:
- 单会话
无限 - 不限制会话数量
自定义 - 自定义并行会话数量
Unlimited/high意味着在发送通知时会产生更多并行会话且会话数量不断增加。Unlimited/high应该在需要同时发送大量通知的大型环境中使用。
尝试次数 尝试发 通知的次数。最大可设置为10;默认值为'3'。如果设置为'1',Zabbix将仅发送一次通知,即使并且如果发送失败将不会重试。
尝试间隔 在发送 败的情况下尝试重新发送通知的频率,单位为秒(0-60)。如果设置为'0',发送失败后将立即重发。
支持定义时间后缀,如5s, 1m。

媒介类型测试

测试配置好的媒介类型是否正常工作。

电子邮件

例如,测试电子邮件媒介类型:

  • 在媒介类型 列表 中找到相关的电子邮件
  • 点击列表最后一栏中的 测试 (将打开一个测试窗口)
  • 收件人 字段输入收件人的地址,设置通知主题(可选)及消息内容。
  • 点击 测试 发送测试消息

测试成功或失败的消息将在同一窗口显示:

**Webhook **

测试webhook媒介类型:

  • 在媒介类型的 列表 中找到相关的webhook
  • 点击列表最后一栏中的 测试 (将打开一个测试窗口)
  • 根据需要来编辑webhook参数值
  • 点击 测试

默认情况下,测试webhook时使用的是之前在配置webhook过程中填入的参数。但是,我们也可以更改其属性值来进行测试。替换或删除测试窗口中的值仅影响测试过程,实际的webhook属性值将保持不变。

查看媒介类型测试的日志条目而不离开此测试窗口:

  • 点击 打开日志 (将打开一个新的弹窗)。
若webhook测试成功
  • 将会显示 "Media type test successful." 的消息
  • 服务器响应信息将显示在灰色的 Response 字段
  • Response 字段的下方会显示其响应的类型(JSON 或是 String)
若webhook测试失败
  • 将会显示 "Media type test failed." 的消息,及执行失败的详细信息。

用户媒介

只有在用户配置文件中定义了此媒介类型的媒体(电子邮件地址/电话号码/webhook用户id 等)时,用户才会收到该媒介类型的通知。例如,如果在用户配置文件中未定义webhook “X”媒介,那么在使用webhook “X”向用户“Admin”发送消息这个动作时,该消息将无法被发送出去。

定义用户媒介的步骤:

  • 转到 管理 → 用户
  • 打开用户属性表单
  • 在报警媒介选项卡中, 点击

用户媒介属性:

参数 描
类型 菜单中包含了所有已配置的媒体类型的名称。
发送到 提供 需的联系信息,消息将发送至此。

对于电子邮件媒介类型,可以通过点击地址字段下面的 来添加多个地址。在这种情况下,通知将发送到所有提供的电子邮件地址。还可以在邮件收件人的 发送到 字段中,以 'Recipient name <[email protected]>' 格式指定收件人。注意:如果提供了收件人的姓名,则电子邮件地址应该用尖括号括起来(<>)。收件人的名称支持UTF-8字符,不支持引号对和注释。例如: John Abercroft <[email protected]>[email protected] 都是有效的格式。错误的示例: John Doe [email protected], %%"Zabbix\@\<H(comment)Q\>" %%.
何时发送 您可以 制消息发送的时间,例如仅限在工作日(1-5,09:00-18:00)。
有关格式的说明请参见 时间段格式 页面。
告警级别 勾选复 框,要标记要接收何种严重程度的消息。
注意 如果您想接收非触发 事件 的通知,请 务必 勾选默认严重性 ('未分类')复选框。
保存后,选中的触发级别将以相应的级别颜色显示,未选中的将显示为灰色。
状态 媒介的状态。
已启用 - 使用中。
禁用 - 未被使用。