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

6 媒介类型

概述

媒介类型是与所有相关对象和对象关系一起导出

导出

导出媒介类型步骤如下:

  • 进入: 管理媒介类型
  • 标记要导出的媒介类型的复选框
  • 点击列表下面的 导出

选择的媒介类型将会导出到本地XML文件,默认名为zbx_export_mediatypes.xml

导入

导入媒介类型步骤如下:

  • 进入: 管理媒介类型
  • 点击右边的导入
  • 选择要导入的文件
  • 在导入规则中标记所需的选项
  • 点击导入

导入成功或失败的消息将在前端页面上显示。

导入规则:

规则 说
更新现有元素 现有元素将 从导入文件中获取的数据更新。否则它们将不会被更新。
新建元素 使用导 文件中的数据添加新元素。否则将不会添加它们。
删除缺失元素 现有元素若 在导入的文件中,该元素将会被删除。否则不会删除它们。

导入格式

<?xml version="1.0" encoding="UTF-8"?>
       <zabbix_export>
           <version>5.0</version>
           <date>2020-01-24T06:44:38Z</date>
           <media_types>
               <media_type>
                   <name>Slack chat</name>
                   <type>WEBHOOK</type>
                   <parameters>
                       <parameter>
                           <name>channel</name>
                           <value>{ALERT.SENDTO}</value>
                       </parameter>
                       <parameter>
                           <name>text</name>
                           <value>{ALERT.MESSAGE}</value>
                       </parameter>
                       <parameter>
                           <name>username</name>
                           <value>bot</value>
                       </parameter>
                   </parameters>
                   <script>var req = new CurlHttpRequest();
       req.AddHeader('Content-Type: application/x-www-form-urlencoded');
       
       Zabbix.Log(127, 'webhook requqest value='+value);
       
       req.Post('https://hooks.slack.com/services/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',
         'payload='+value
       );
       
       Zabbix.Log(127, 'response code: '+req.Status());
       
       return JSON.stringify({
         'tags': {
           'delivered': 'slack'
         }
       });</script>
                   <process_tags>YES</process_tags>
                   <show_event_menu>YES</show_event_menu>
                   <event_menu_url>https://www.zabbix.com</event_menu_url>
                   <event_menu_name>Slack message</event_menu_name>
                   <description>Slack chat messages.</description>
               </media_type>
           </media_types>
       </zabbix_export>

元素标签

元素标签值详解

元素 元 属性 必须 范围^**[1]( 脚注)**^ 说明
media_types - media_types的根元素。
media_type - 单独的media_type。
name x 字符串 媒介 型名称。
type x 字符串 0 电子邮件  媒体类型使用1 - 短消息
2 - 脚本
4 - WEBHOOK
传输。
status - 字符串 0 启用 (默认)  媒介类型是否1 - 禁用 用。
max_sessions - 整型 S S可能的值: 1 - (默认)  可以并行处理的
其他媒介类型的可能值: 0-100, 0 - 无限制
大警报数。
attempts - 整型 1 10 (默认: 3) 发送警 的最大尝试次数。
attempt_interval - 字符串 0- 0s (默认: 10s) 重试的时 间隔。

接受秒和带后缀的时间单位。
description - 字符串 媒介 型说明。
message_templates - 媒介类型消息模板的根元素。
message_template - 单独的消息模板。
event_source x 字符串 0 触发器  事件来源。1 - 自动发现
2 - 自动注册
3 - 内部
operation_mode x 字符串 0 问题  操作模式1 - 恢复
2 - 更新
subject - 字符串 信息 题。
message - 字符串 信息 体。
Used only by e-mail media type
smtp_server x 字符串 SM P服务器。
smtp_port - 整型 : 25 SMT 服务器连接端口。
smtp_helo x 字符串 SM P helo信息。
smtp_email x 字符串 发送 知的电子邮件地址。
smtp_security - 字符串 0 NONE (默认)  SMTP1 - STARTTLS
2 - SSL_OR_TLS
连接安全级别。
smtp_verify_host - 字符串 0 否 (默认)  SSL验证1 - 是 MTP的主机。当smtp_security的值为STARTTLS或SSL_OR_TLS时,为可选项。
smtp_verify_peer - 字符串 0 否 (默认)  SSL验证1 - 是 MTP的对等体。当smtp_security的值为STARTTLS或SSL_OR_TLS时,为可选项。
smtp_authentication - 字符串 0 无 (默认)  SMTP身1 - 密码 验证方法。
username - 字符串 用户
password - 字符串 密码 证。
content_type - 字符串 0 TEXT  消息1 - HTML (默认) 式。
Used only by SMS media type
gsm_modem x 字符串 Se ial GSM modem的设备名称。
Used only by script media type
script name x 字符串 脚本 称。
parameters - 脚本参数的根元素。
parameter - 单独的脚本参数。
Used only by webhook media type
script x 字符串 脚本
timeout - 字符串 1- 0s (默认: 30s) Java cript脚本HTTP请求超时时间
process_tags - 字符串 0 否 (默认)  是否处理返1 - 是 的标记。
show_event_menu - 字符串 0 否 (默认)  如果 {E1 - 是 ENT.TAGS.*} 在字段event_menu_url 和 event_menu_name成功解析, 该字段表示事件菜单中存在条目。
event_menu_url - 字符串 事件 单项的URL。支持 {EVENT.TAGS.*} 宏。
event_menu_name - 字符串 事件 单项的名称。支持 {EVENT.TAGS.*} 宏。
parameters - webhook媒介类型参数的根元素。
parameter - 单独的webhook媒介类型参数。
name x 字符串 We hook参数名称。
value - 字符串 We hook参数值。
脚注

1 对于字符串值,仅将导出字符串(例如EMAIL),而无需使用此表中的编号。该表中范围值(对应于API值)的数字仅用于排序。