4 主机

概述

导出(exported) 的主机具有许多相关对象和对象关系。

主机导出的内容包含:

  • 链接的主机组
  • 主机数据
  • 模板链接
  • 主机组链接
  • 主机接口
  • 直接链接的应用集
  • 直接链接的监控项
  • 直接链接的触发器
  • 直接链接的具有所有原型的发现规则
  • 直接链接的web场景
  • 主机宏
  • 主机资产清单数据
  • 值映射

导出

要导出主机,请执行以下操作:

  • 前往: ConfigurationHosts
  • 标记要导出的主机的复选框
  • 单击列表下方的导出

根据选定的格式,主机将导出到具有默认名称的本地文件:

  • zabbix_export_hosts.yaml - 导出YAML格式 (默认导出)
  • zabbix_export_hosts.xml - 导出XML格式
  • zabbix_export_hosts.json - 导出JSON格式

导入

要导入主机,请执行以下操作:

  1. 前往 数据采集主机
  2. 单击右上角的 导入
  3. 选择导入文件。
  4. 单击配置表单右下角的 导入

如果勾选 高级选项 复选框,将显示所有可导入元素的详细列表 - 根据需要勾选或取消勾选各项导入规则。

如果单击 全部 行中的复选框,其下方所有元素都将被勾选/取消勾选。

导入规则:

规则 说明
更新现有项 现有元素将使用导入文件中的数据进行更新。否则,它们将不会被更新。
创建新的 将使用导入文件中的数据创建新元素。否则,它们将不会被创建。
删除缺失项 导入文件中不存在的现有元素将被移除。否则,它们将不会被移除。
如果为 模板关联 勾选了 删除缺失项,则当前在导入文件中不存在的模板关联将被取消关联。从已取消关联的模板继承的实体(监控项、触发器、图形等)不会被移除(除非也为每个实体选择了 删除缺失项 选项)。

前端中将显示导入成功或失败的消息。

导出格式

导出主机时,Zabbix 会生成结构化的 YAML、JSON 或 XML 格式。 导出内容包括主机元素,例如主机元数据、监控项、宏、触发器等。

每个元素都有特定用途,并且可能包含嵌套元素。

以下各节将说明导出格式中的每个元素。 示例使用了一个链接了 MySQL by Zabbix agent 2 模板的主机。 为演示各元素的用途,在创建主机后会取消链接该模板。 取消链接会将所有元素保留在配置中(不同于取消链接并清除,后者会将其移除)。

省略号 (...) 表示为简洁起见而省略的元素。 当某个元素会在后续章节中进行更详细说明时,会使用注释 (见下表)

主机元数据

zabbix_export:
  version: '8.0'
  host_groups:
    - uuid: 748ad4d098d447d492bb935c907f652f
      name: Databases
  hosts: (见下表)
  graphs: (见下表)
元素 Type 描述
version string (必填)Zabbix 版本。
host_groups (必填)主机组的根元素。
uuid string (必填)此主机组的唯一标识符。
name string (必填)主机组名称。
hosts 主机 的根元素。
graphs 主机图形 的根元素。

主机

zabbix_export:
  (...)
  hosts:
    - host: 'MySQL server'
      name: 'MySQL server'
      groups:
        - name: Databases
      interfaces: (见下表)
      items: (见下表)
      discovery_rules: (见下表)
      tags:
        - tag: location
          value: Riga
      macros:
        (...)
        - macro: '{$MYSQL.DSN}'
          value: 192.0.2.0
        (...)
        - macro: '{$MYSQL.PASSWORD}'
          type: SECRET_TEXT
          description: 'MySQL user password.'
        (...)
      valuemaps: (见下表)
  (...)
元素 Type 描述
host string (必填)唯一主机名称。
name string 可见主机名称。
description text 主机描述。
monitored_by string 主机的监控方式。
可能的值:1 SERVER (0,默认)、PROXY (1) 或 PROXY_GROUP (2)。
proxy proxy 的根元素。
name string (必填)监控该主机的 proxy 名称(如有)。
proxy_group proxy 组的根元素。
name string (必填)用于监控该主机的 proxy 组名称(如有)。
status string 主机状态。
可能的值:1 ENABLED (0,默认)、DISABLED (1)。
ipmi_authtype string IPMI 会话认证类型。
可能的值:1 DEFAULT (-1,默认)、NONE (0)、MD2 (1)、MD5 (2)、STRAIGHT (4)、OEM (5)、RMCP_PLUS (6)。
ipmi_privilege string IPMI 会话权限级别。
可能的值:1 CALLBACK (1)、USER (2,默认)、OPERATOR (3)、ADMIN (4)、OEM (5)。
ipmi_username string 用于 IPMI 检查的用户名。
ipmi_password string 用于 IPMI 检查的密码。
templates 已链接模板的根元素。
name string (必填)模板名称。
groups 主机所属主机组的根元素。
name string (必填)主机组名称。
interfaces 主机接口的根元素。
items 主机监控项的根元素。
discovery_rules 主机低级别发现规则的根元素。
http_tests 主机 Web 场景的根元素。
tags 主机标签的根元素。
tag string (必填)标签名称。
value string 标签值。
macros 主机宏的根元素。
macro string (必填)用户宏名称。
type string 用户宏类型。
可能的值:1 TEXT (0,默认)、SECRET_TEXT (1)、VAULT (2)。
value string 用户宏值。
description string 用户宏描述。
inventory 主机资产记录的根元素。
<inventory_property> string 资产记录属性。所有属性都有各自对应的元素(typenameos 等;例如,参见 Export format)。
inventory_mode string 资产记录模式。
可能的值:1 DISABLED (-1)、MANUAL (0,默认)、AUTOMATIC (1)。
valuemaps 主机值映射的根元素。

另请参见:Host object(请参考名称匹配的相关属性)。

主机接口

zabbix_export:
  (...)
  hosts:
    - host: 'MySQL server'
      (...)
      interfaces:
        - ip: 192.0.2.0
          interface_ref: if1
      (...)
Element Type Description
default string 此接口是否为主主机接口。请注意,一台主机上每种类型只能有一个主接口。
可能的值:1 NO (0), YES (1,默认)。
type string 接口类型。
可能的值:1 ZABBIX (1,默认), SNMP (2), IPMI (3), JMX (4)。
useip string 连接到主机时是否使用 IP 作为接口(否则将使用 DNS)。
可能的值:1 NO (0), YES (1,默认)。
ip string (IP 连接时必需)IP 地址(IPv4 或 IPv6)。
dns string (DNS 连接时必需)DNS 名称。
port string 端口号。
details 接口详细信息的根元素。
version string 使用此 SNMP 版本。
可能的值:1 SNMPV1 (1), SNMP_V2C (2,默认), SNMP_V3 (3)。
community string (SNMPv1 和 SNMPv2 监控项必需)SNMP community。
max_repetitions string 原生 SNMP 批量请求(GetBulkRequest-PDUs)的最大重复值。
支持 SNMPv2 和 SNMPv3 监控项(discovery[]walk[] 监控项)。
默认值:10。
contextname string SNMPv3 上下文名称。
支持 SNMPv3 监控项。
securityname string SNMPv3 安全名称。
支持 SNMPv3 监控项。
securitylevel string SNMPv3 安全级别。
支持 SNMPv3 监控项。
可能的值:1 NOAUTHNOPRIV (0,默认), AUTHNOPRIV (1), AUTHPRIV (2)。
authprotocol string SNMPv3 认证协议。
支持 SNMPv3 监控项。
可能的值:1 MD5 (0,默认), SHA1 (1), SHA224 (2), SHA256 (3), SHA384 (4), SHA512 (5)。
authpassphrase string SNMPv3 认证口令。
支持 SNMPv3 监控项。
privprotocol string SNMPv3 加密协议。
支持 SNMPv3 监控项。
可能的值:1 DES (0,默认), AES128 (1), AES192 (2), AES256 (3), AES192C (4), AES256C (5)。
privpassphrase string SNMPv3 加密口令。
支持 SNMPv3 监控项。
bulk string 对 SNMP 使用批量请求。
可能的值:1 NO (0), YES (1,默认)。
interface_ref string 在监控项中使用的接口引用名称(格式:if<N>)。

另请参见:主机接口对象(请参考名称匹配的相关属性)。

主机监控项

zabbix_export:
  (...)
  hosts:
    - host: 'MySQL server'
      (...)
      items:
        (...)
        - name: 'Binlog cache disk use'
          type: DEPENDENT
          key: mysql.binlog_cache_disk_use
          value_type: FLOAT
          description: '由于事务大于 `binlog_cache_size`,无法放入常规二进制日志缓存,因此使用临时磁盘缓存的事务数量。'
          preprocessing: (见下表)
          master_item:
            key: 'mysql.get_status_variables["{$MYSQL.DSN}","{$MYSQL.USER}","{$MYSQL.PASSWORD}"]'
          tags:
            - tag: component
              value: cache
        (...)
        - name: 'Buffer pool utilization'
          type: CALCULATED
          key: mysql.buffer_pool_utilization
          value_type: FLOAT
          units: '%'
          params: |
            ( last(//mysql.innodb_buffer_pool_pages_total) - 
            last(//mysql.innodb_buffer_pool_pages_free) ) / 
            ( last(//mysql.innodb_buffer_pool_pages_total) + 
            ( last(//mysql.innodb_buffer_pool_pages_total) = 0 ) ) * 100 * 
            ( last(//mysql.innodb_buffer_pool_pages_total) > 0 )
          description: '缓冲池中已使用页数与总页数的比率。'
          tags:
            - tag: component
              value: memory
          triggers: (见下表)
        (...)
        - name: Uptime
          type: DEPENDENT
          key: mysql.uptime
          units: uptime
          description: '服务器已运行的秒数。'
          preprocessing: (见下表)
          master_item:
            key: 'mysql.get_status_variables["{$MYSQL.DSN}","{$MYSQL.USER}","{$MYSQL.PASSWORD}"]'
          tags:
            - tag: component
              value: application
          triggers: (见下表)
        (...)
Element Type Description
name string (必填)监控项名称。
type string 监控项类型。
可能的值:1 ZABBIX_PASSIVE (0,默认)、TRAP (2)、SIMPLE (3)、INTERNAL (5)、ZABBIX_ACTIVE (7)、EXTERNAL (10)、ODBC (11)、IPMI (12)、SSH (13)、TELNET (14)、CALCULATED (15)、JMX (16)、SNMP_TRAP (17)、DEPENDENT (18)、HTTP_AGENT (19)、SNMP_AGENT (20)、ITEM_TYPE_SCRIPT (21)、ITEM_TYPE_BROWSER (22)、ITEM_TYPE_NESTED (23)。
snmp_oid string (SNMP_AGENT 监控项必填)SNMP 对象 ID。
key string (必填)监控项键值。
delay string 监控项更新间隔。
默认值:1m。对于 TRAP 监控项,该值始终为 0。
history string 历史数据的存储时长(使用 time suffixuser macroLLD macro)。
默认值:31d。
trends string 趋势数据的存储时长(使用 time suffixuser macroLLD macro)。
默认值:365d。
status string 监控项状态。
可能的值:1 ENABLED (0,默认)、DISABLED (1)。
value_type string 接收值类型。
可能的值:1 FLOAT (0)、CHAR (1)、LOG (2)、UNSIGNED (3,默认)、TEXT (4)、BINARY (5)、JSON (6)。
allowed_hosts string 允许为该监控项发送数据的主机 IP 地址列表,以逗号分隔。
支持 TRAP 和 HTTP_AGENT 监控项。
units string 接收值单位(bps、B 等)。
params text 取决于监控项类型的附加参数(SSH 和 TELNET 监控项的执行脚本;ODBC 监控项的 SQL 查询;CALCULATED 监控项的公式;ITEM_TYPE_SCRIPT 和 ITEM_TYPE_BROWSER 监控项的脚本)。
ipmi_sensor string IPMI 传感器。
支持 IPMI 监控项。
authtype string 认证类型。
支持 SSH 和 HTTP_AGENT 监控项。
SSH 监控项可能的值:1 PASSWORD (0,默认)、PUBLIC_KEY (1)。
HTTP_AGENT 监控项可能的值:1 NONE (0,默认)、BASIC (1)、NTLM (2)、Kerberos (3) 或 Digest (4)。
username string (SSH 和 TELNET 监控项必填)用于认证的用户名。
支持 SIMPLE、ODBC、JMX 和 HTTP_AGENT 监控项。
用于 JMX 监控项时,还应指定 password(见下文),或者两个元素都留空。
password string (SSH 和 TELNET 监控项必填)用于认证的密码。
支持 SIMPLE、ODBC、JMX 和 HTTP_AGENT 监控项。
用于 JMX 监控项时,还应指定 username(见上文),或者两个元素都留空。
publickey string (SSH 监控项必填)公钥文件名称。
privatekey string (SSH 监控项必填)私钥文件名称。
description text 监控项描述。
inventory_link string 由该监控项填充的主机资产字段。
可能的值:1 NONE (0)、ALIAS (4) 等(支持的字段请参见 Host inventory)。
valuemap 监控项值映射的根元素。
name string (必填)要用于该监控项的值映射名称。
logtimefmt string 日志条目中的时间格式。
支持值类型为 LOG 的监控项。
preprocessing 监控项值预处理的根元素。
step 主机监控项值预处理步骤的根元素。
interface_ref string 主机接口的引用(格式:if<N>)。
jmx_endpoint string JMX 端点。
支持 JMX 监控项。
master_item (DEPENDENT 监控项必填)依赖监控项的主监控项根元素。
key string (必填)依赖监控项的主监控项键值。
timeout string 监控项数据轮询请求超时。
支持 Timeouts 列表中的监控项类型。
url string (HTTP_AGENT 监控项必填)URL 字符串。
query_fields 查询参数的根元素。
支持 HTTP_AGENT 监控项。
name string (HTTP_AGENT 监控项必填)查询参数名称。
value string 查询参数值。
支持 HTTP_AGENT 监控项。
parameters 用户定义参数的根元素。
支持 ITEM_TYPE_SCRIPT 和 ITEM_TYPE_BROWSER 监控项。
name string (ITEM_TYPE_SCRIPT 和 ITEM_TYPE_BROWSER 监控项必填)用户定义参数名称。
value string 用户定义参数值。
支持 ITEM_TYPE_SCRIPT 和 ITEM_TYPE_BROWSER 监控项。
posts string HTTP(S) 请求正文数据。
支持 HTTP_AGENT 监控项。
status_codes string 所需 HTTP 状态码范围,以逗号分隔。
支持 HTTP_AGENT 监控项。
follow_redirects string 轮询数据时是否跟随响应重定向。
支持 HTTP_AGENT 监控项。
可能的值:1 NO (0)、YES (1,默认)。
post_type string 提交数据正文的类型。
支持 HTTP_AGENT 监控项。
可能的值:1 RAW (0,默认)、JSON (2)、XML (3)。
http_proxy string HTTP(S) proxy 连接字符串。
支持 HTTP_AGENT 监控项。
headers HTTP(S) 请求头的根元素。
支持 HTTP_AGENT 监控项。
name string (HTTP_AGENT 监控项必填)请求头名称。
value string (HTTP_AGENT 监控项必填)请求头值。
retrieve_mode string 应存储响应的哪一部分。
支持 HTTP_AGENT 监控项。
可能的值:1 BODY (0,默认)、HEADERS (1)、BOTH (2)。
request_method string 请求方法类型。
支持 HTTP_AGENT 监控项。
可能的值:1 GET (0,默认)、POST (1)、PUT (2)、HEAD (3)。
output_format string 如何处理响应。
支持 HTTP_AGENT 监控项。
可能的值:1 RAW (0,默认)、JSON (1)。
allow_traps string 允许以类似 trapper 监控项的方式填充值。
支持 HTTP_AGENT 监控项。
可能的值:1 NO (0,默认)、YES (1)。
ssl_cert_file string 公共 SSL 密钥文件路径。
支持 HTTP_AGENT 监控项。
ssl_key_file string 私有 SSL 密钥文件路径。
支持 HTTP_AGENT 监控项。
ssl_key_password string SSL 密钥文件的密码。
支持 HTTP_AGENT 监控项。
verify_peer string 是否验证主机证书的真实性。
支持 HTTP_AGENT 监控项。
可能的值:1 NO (0,默认)、YES (1)。
verify_host string 是否验证连接所用主机名与主机证书中的主机名是否匹配。
支持 HTTP_AGENT 监控项。
可能的值:1 NO (0,默认)、YES (1)。
tags 监控项标签的根元素。
tag string (必填)标签名称。
value string 标签值。
triggers 主机监控项触发器的根元素。

另请参见:Item object(请参考名称匹配的相关属性)。

主机监控项值预处理步骤
zabbix_export:
  (...)
  hosts:
    - host: 'MySQL server'
      (...)
      items:
        (...)
        - name: 'Binlog cache disk use'
          (...)
          preprocessing:
            - type: JSONPATH
              parameters:
                - $.Binlog_cache_disk_use
            - type: DISCARD_UNCHANGED_HEARTBEAT
              parameters:
                - 6h
          (...)
Element Type Description
type string (必填)监控项值预处理步骤的类型。
可能的值:1 MULTIPLIER (1)、RTRIM (2)、LTRIM (3)、TRIM (4)、REGEX (5)、BOOL_TO_DECIMAL (6)、OCTAL_TO_DECIMAL (7)、HEX_TO_DECIMAL (8)、SIMPLE_CHANGE (9,计算方式:接收到的值 - 上一个值)、CHANGE_PER_SECOND (10,计算方式:(接收到的值 - 上一个值)/(当前时间 - 上次检查时间))、XMLPATH (11)、JSONPATH (12)、IN_RANGE (13)、MATCHES_REGEX (14)、NOT_MATCHES_REGEX (15)、CHECK_JSON_ERROR (16)、CHECK_XML_ERROR (17)、CHECK_REGEX_ERROR (18)、DISCARD_UNCHANGED (19)、DISCARD_UNCHANGED_HEARTBEAT (20)、JAVASCRIPT (21)、PROMETHEUS_PATTERN (22)、PROMETHEUS_TO_JSON (23)、CSV_TO_JSON (24)、STR_REPLACE (25)、CHECK_NOT_SUPPORTED (26)、XML_TO_JSON (27)、SNMP_WALK_VALUE (28)、SNMP_WALK_TO_JSON (29)、SNMP_GET_VALUE (30)。
parameters (必填)监控项值预处理步骤参数的根元素。
parameter string 监控项值预处理步骤的单个参数。
error_handler string 预处理步骤失败时使用的操作类型。
可能的值:1 ORIGINAL_ERROR (0,默认)、DISCARD_VALUE (1)、CUSTOM_VALUE (2)、CUSTOM_ERROR (3)。
error_handler_params string 错误处理器参数。

另请参见:监控项预处理对象(请参考名称匹配的相关属性)。

主机监控项触发器
zabbix_export:
  (...)
  hosts:
    - host: 'MySQL server'
      (...)
      items:
        (...)
        - name: Uptime
          (...)
          triggers:
            - expression: 'nodata(/MySQL server/mysql.uptime,30m)=1'
              name: 'MySQL: Failed to fetch info data'
              event_name: 'MySQL: Failed to fetch info data (or no data for 30m)'
              priority: INFO
              description: 'Zabbix has not received any data for items for the last 30 minutes.'
              dependencies:
                - name: 'MySQL: Service is down'
                  expression: 'last(/MySQL server/mysql.ping["{$MYSQL.DSN}","{$MYSQL.USER}","{$MYSQL.PASSWORD}"])=0'
              tags:
                - tag: scope
                  value: availability
            - expression: 'last(/MySQL server/mysql.uptime)<10m'
              name: 'MySQL: Service has been restarted'
              event_name: 'MySQL: Service has been restarted (uptime < 10m)'
              priority: INFO
              description: 'MySQL uptime is less than 10 minutes.'
              tags:
                - tag: scope
                  value: notice
        (...)
元素 Type 描述
uuid string (必填)此触发器的唯一标识符。
expression string (必填)触发器表达式。
recovery_mode string 生成 OK 事件的依据。
可能的值:1 EXPRESSION (0, default), RECOVERY_EXPRESSION (1), NONE (2)。
recovery_expression string 触发器恢复表达式。
correlation_mode string 关联模式(不进行事件关联,或按标签进行事件关联)。
可能的值:1 DISABLED (0, default), TAG_VALUE (1)。
correlation_tag string 用于事件关联的标签名称。
name string (必填)触发器名称。
event_name string 事件名称。
opdata string 运行数据。
url_name string 与触发器关联的 URL 标签。
url string 与触发器关联的 URL。
status string 触发器状态。
可能的值:1 ENABLED (0, default), DISABLED (1)。
priority string 触发器严重性。
可能的值:1 NOT_CLASSIFIED (0, default), INFO (1), WARNING (2), AVERAGE (3), HIGH (4), DISASTER (5)。
description text 触发器描述。
type string 事件生成类型(单个问题事件或多个问题事件)。
可能的值:1 SINGLE (0, default), MULTIPLE (1)。
manual_close string 手动关闭问题事件。
可能的值:1 NO (0, default), YES (1)。
dependencies 依赖关系的根元素。
name string (必填)依赖触发器名称。
expression string (必填)依赖触发器表达式。
recovery_expression string 依赖触发器恢复表达式。
tags 触发器标签的根元素。
tag string (必填)标签名称。
value string 标签值。

另请参见:Trigger object(请参考名称匹配的相关属性)。

主机低级发现规则

zabbix_export:
  (...)
  hosts:
    - host: 'MySQL server'
      (...)
      discovery_rules:
        - name: 'Database discovery'
          key: 'mysql.db.discovery["{$MYSQL.DSN}","{$MYSQL.USER}","{$MYSQL.PASSWORD}"]'
          delay: 1h
          filter: (see table below)
          description: 'Scanning databases in DBMS.'
          interface_ref: if1
          item_prototypes:
            - name: 'Size of database {#DATABASE}'
              key: 'mysql.db.size["{$MYSQL.DSN}","{$MYSQL.USER}","{$MYSQL.PASSWORD}","{#DATABASE}"]'
              delay: 5m
              units: B
              description: 'Database size.'
              preprocessing:
                - type: DISCARD_UNCHANGED_HEARTBEAT
                  parameters:
                    - 1h
              interface_ref: if1
              tags:
                - tag: component
                  value: storage
                - tag: database
                  value: '{#DATABASE}'
          lld_macro_paths:
            - lld_macro: '{#DATABASE}'
              path: $.Database
          preprocessing:
            - type: DISCARD_UNCHANGED_HEARTBEAT
              parameters:
                - 1d
        (...)

大多数主机低级发现规则元素与主机监控项相同。 下表描述了与主机监控项不同的那些元素。

Element Type Description
type string 监控项类型。
可能的值:1 ZABBIX_PASSIVE (0,默认)、TRAP (2)、SIMPLE (3)、INTERNAL (5)、ZABBIX_ACTIVE (7)、EXTERNAL (10)、ODBC (11)、IPMI (12)、SSH (13)、TELNET (14)、JMX (16)、DEPENDENT (18)、HTTP_AGENT (19)、SNMP_AGENT (20)、ITEM_TYPE_SCRIPT (21)、ITEM_TYPE_BROWSER (22)。
key string (必填)低级发现规则键值。
filter 主机低级发现规则过滤器的根元素。
lifetime string 时间周期(使用秒、时间后缀用户宏),超过该时间后,不再发现的资源将被删除。
默认值:7d。
lifetime_type string 删除丢失的 LLD 资源的场景。
可能的值:DELETE_NEVER、DELETE_IMMEDIATELY、DELETE_AFTER。
enabled_lifetime string 时间周期(使用秒、时间后缀用户宏),超过该时间后,不再发现的资源将被禁用。
enabled_lifetime_type string 禁用丢失的 LLD 资源的场景。
可能的值:DISABLE_NEVER、DISABLE_IMMEDIATELY、DISABLE_AFTER。
item_prototypes 主机监控项原型元素的根元素,其内容与主机监控项相同。
trigger_prototypes 主机触发器原型元素的根元素,其内容与主机监控项触发器相同。
graph_prototypes 主机图形原型的根元素,其内容与主机图形相同。
host_prototypes 主机原型的根元素,其内容与主机相同。
parent_discovery_rule 低级发现规则原型的父低级发现规则(或规则原型)的根元素。此属性表示它是一个 LLD 规则原型,是所引用规则/规则原型的直接子级。
key string (必填)父低级发现规则(或规则原型)键值。
master_item string (DEPENDENT 规则必填)依赖规则的主监控项的根元素。
lld_macro_paths 低级发现规则宏路径的根元素。
lld_macro string (必填)低级发现规则宏名称。
path string (必填)值的选择器,该值将被赋给相应的宏。
preprocessing 低级发现规则值预处理的根元素。
step 低级发现规则值预处理步骤元素的根元素,其内容与主机监控项值预处理步骤相同,但可用值更少。另请参见:LLD rule preprocessing object
overrides 低级发现规则覆盖规则的根元素。
name string (必填)唯一的覆盖名称。
step string (必填)覆盖规则的唯一顺序号。
stop string 如果匹配,则停止处理后续覆盖规则。
filter 低级发现规则覆盖规则过滤器元素的根元素,其内容与主机低级发现规则过滤器相同。
operations 主机低级发现规则覆盖操作的根元素。

另请参见:LLD rule object(请参考具有相同名称的相关属性)。

主机低级别发现规则过滤器
zabbix_export:
  (...)
  hosts:
    - host: 'MySQL server'
      (...)
      discovery_rules:
        - name: 'Database discovery'
          (...)
          filter:
            evaltype: AND
            conditions:
              - macro: '{#DATABASE}'
                value: '{$MYSQL.DBNAME.MATCHES}'
              - macro: '{#DATABASE}'
                value: '{$MYSQL.DBNAME.NOT_MATCHES}'
                operator: NOT_MATCHES_REGEX
          (...)
元素 类型 描述
evaltype string 覆盖过滤条件求值方法。
可能的值:1 AND_OR (0,默认),AND (1),OR (2),FORMULA (3)。
formula string 过滤条件的自定义计算公式。
conditions 过滤条件的根元素。
macro string (必填)要执行检查的低级别发现宏名称。
value string 用于比较的值。
operator string 条件运算符。
可能的值:1 MATCHES_REGEX (8,默认),NOT_MATCHES_REGEX (9)。
formulaid string (必填)用于从自定义表达式中引用条件的任意唯一 ID。只能包含大写字母。修改过滤条件时,该 ID 必须由用户定义;但在之后请求这些条件时,将重新生成。

另请参见:LLD rule filter object(请参考具有相同名称的相关属性)。

主机低级别发现规则覆盖操作
元素 类型 描述
operationobject string 应用该操作的对象。
可能的值:1 ITEM_PROTOTYPE (0)、TRIGGER_PROTOTYPE (1)、GRAPH_PROTOTYPE (2)、HOST_PROTOTYPE (3)、DISCOVERY_PROTOTYPE (4)。
operator string 覆盖条件运算符。
可能的值:1 EQUAL (1)、NOT_EQUAL (2)、LIKE (3)、NOT_LIKE (4)、REGEXP (5)、NOT_REGEXP (6)。
value string 用于覆盖条件运算符的正则表达式或字符串。
status string 执行覆盖操作后对象的状态。
discover string 该对象是否因发现而被添加。
delay string 执行覆盖操作后为监控项原型设置的更新间隔。
history string 执行覆盖操作后为监控项原型设置的历史数据存储周期。
trends string 执行覆盖操作后为监控项原型设置的趋势数据存储周期。
severity string 执行覆盖操作后设置的触发器原型严重性。
tags 执行覆盖操作后为对象设置的标签的根元素。
tag string (必填)标签名称。
value string 标签值。
templates 执行覆盖操作后链接到主机原型的模板的根元素。
name string (必填)模板名称。
inventory_mode string 执行覆盖操作后设置的主机原型资产记录模式。

另请参见:LLD 规则覆盖操作对象(请参考具有相同名称的相关属性)。

主机 Web 场景

Element Type Description
uuid string (必填)此 Web 场景的唯一标识符。
name string (必填)Web 场景名称。
delay string 执行 Web 场景的频率(使用秒、时间后缀用户宏)。
默认值:1m。
attempts integer 执行 Web 场景步骤的尝试次数。
可能的值:1-10(默认值:1)。
agent string 客户端 agent。Zabbix 将伪装为所选浏览器。
当网站针对不同浏览器返回不同内容时,这很有用。
默认值:Zabbix。
http_proxy string Web 场景将使用的 proxy,格式为:http://[username[:password]@]proxy.example.com[:port]
variables 可在场景步骤中使用的 Web 场景变量的根元素。
name string (必填)变量名称。
value text (必填)变量值。
headers 执行请求时要发送的 HTTP 标头的根元素。
标头应使用与其在 HTTP 协议中显示时相同的语法列出。
name string (必填)标头名称。
value text (必填)标头值。
status string Web 场景状态。
可能的值:1 ENABLED (0, default), DISABLED (1)。
authentication string 认证方法。
可能的值:1 NONE (0, default), BASIC (1), NTLM (2), Kerberos (3) 或 Digest (4)。
http_user string 用于 BASIC (HTTP)、NTLM、Kerberos 或 Digest 认证的用户名。
http_password string 用于 BASIC (HTTP)、NTLM、Kerberos 或 Digest 认证的密码。
verify_peer string 验证 Web 服务器的 SSL 证书。
可能的值:1 NO (0, default), YES (1)。
verify_host string 验证 Web 服务器证书的 Common Name 字段或 Subject Alternate Name 字段是否匹配。
可能的值:1 NO (0, default), YES (1)。
ssl_cert_file string 用于客户端认证的 SSL 证书文件名称(必须为 PEM 格式)。
ssl_key_file string 用于客户端认证的 SSL 私钥文件名称(必须为 PEM 格式)。
ssl_key_password string SSL 私钥文件密码。
steps (必填)主机 Web 场景步骤的根元素。
tags Web 场景标签的根元素。
tag string (必填)标签名称。
value string 标签值。

另请参见:Web scenario object(请参阅名称匹配的相关属性)。

主机Web场景步骤

元素 类型 描述
name string (必需)Web场景步骤名称。
url string (必需)监视的URL。
query_fields 查询参数的根元素(执行请求时要添加到URL的HTTP字段数组)。
name string (必需)查询参数名称。
value string 查询参数值。
posts HTTP POST变量的根元素(原始POST数据string或HTTP字段(表单字段数据)的数组)。
name string (必需)POST字段名称。
value string (必需)POST字段值。
variables 步骤级别变量(宏),在此步骤后应用。
如果变量值以'regex:'前缀开头,则根据此步骤返回的数据使用正则表达式模式提取值。
name string (必需)变量名称。
value 文本 (必需)变量值。
headers 执行请求时发送的HTTP头的根元素。
name string (必需)头部名称。
value 文本 (必需)头部值。
follow_redirects string 是否跟随HTTP重定向。
可能的取值:1 NO (0), YES (1, 默认)。
retrieve_mode string HTTP响应检索模式。
可能的取值:1 BODY (0, 默认), HEADERS (1), BOTH (2)。
timeout string 步骤执行的超时时间(使用秒、时间后缀用户宏)。
默认值:15s。
required string 响应中必须存在的文本(如果为空则忽略)。
status_codes string 接受的HTTP状态码的逗号分隔列表(例如200-201,210-299;如果为空则忽略)。

另请参阅:Web场景步骤对象(参考相应属性的匹配名称)。

主机图形

zabbix_export:
  (...)
  graphs:
    - name: 'MySQL: Bandwidth'
      graph_items: (见下表)
    (...)
Element Type Description
uuid string 图形的唯一标识符。
name string (必填)图形名称。
width integer 图形宽度,单位为像素。
用于预览以及饼图/分离饼图。
可能的值:1 20-65535(默认:900)。
height integer 图形高度,单位为像素。
用于预览以及饼图/分离饼图。
可能的值:1 20-65535(默认:900)。
yaxismin double Y 轴最小值。
支持 Y 轴最小值为 FIXED 的情况。
默认值:0。
yaxismax double Y 轴最大值。
支持 X 轴最小值为 FIXED 的情况。
默认值:0。
show_work_period string 高亮显示非工作时间。
支持 NORMAL 和 STACKED 图形。
可能的值:1 NO (0),YES (1,默认)。
show_triggers string 以线条形式显示简单触发器值。
支持 NORMAL 和 STACKED 图形。
可能的值:1 NO (0),YES (1,默认)。
type string 图形类型。
可能的值:1 NORMAL (0,默认),STACKED (1),PIE (2),EXPLODED (3)。
show_legend string 显示图形图例。
可能的值:1 NO (0),YES (1,默认)。
show_3d string 启用 3D 样式。
支持 NORMAL 和 STACKED 图形。
可能的值:1 NO (0,默认),YES (1)。
percent_left double 显示左轴的百分位线。
支持 NORMAL 图形。
默认值:0。
percent_right double 显示右轴的百分位线。
支持 NORMAL 图形。
默认值:0。
ymin_type_1 string Y 轴最小值。
支持 NORMAL 和 STACKED 图形。
可能的值:1 CALCULATED (0,默认),FIXED (1),ITEM (2)。
ymin_item_1 (当 ymin_type_1 设置为 ITEM 时必填)各个监控项详细信息的根元素。
host string (必填)监控项主机。
key string (必填)监控项键值。
ymax_type_1 string Y 轴最大值。
支持 NORMAL 和 STACKED 图形。
可能的值:1 CALCULATED (0,默认),FIXED (1),ITEM (2)。
ymax_item_1 (当 ymax_type_1 设置为 ITEM 时必填)各个监控项详细信息的根元素。
host string (必填)监控项主机。
key string (必填)监控项键值。
graph_items (必填)主机图形监控项的根元素。

另请参见:Graph object(请参考名称匹配的相关属性)。

主机图形监控项
zabbix_export:
  (...)
  graphs:
    - name: 'MySQL: Bandwidth'
      graph_items:
        - drawtype: GRADIENT_LINE
          color: 199C0D
          item:
            host: 'MySQL server'
            key: mysql.bytes_received.rate
        - sortorder: '1'
          drawtype: GRADIENT_LINE
          color: F63100
          item:
            host: 'MySQL server'
            key: mysql.bytes_sent.rate
    (...)
元素 < 类型 描述
sortorder < integer 绘制顺序。值越小越先绘制。可用于将线条或区域绘制在另一个元素的后面(或前面)。
drawtype < string 图形监控项的绘制样式。
支持 NORMAL 图形。
可能的值:1 SINGLE_LINE (0,默认),FILLED_REGION (1),BOLD_LINE (2),DOTTED_LINE (3),DASHED_LINE (4),GRADIENT_LINE (5)。
color < string 元素颜色(6 个符号,十六进制)。
yaxisside < string 图形中绘制图形监控项 Y 轴刻度的一侧。
支持 NORMAL 和 STACKED 图形。

可能的值:1 LEFT (0,默认),RIGHT (1)。
calc_fnc < string 当一个监控项存在多个值时要绘制的数据。
可能的值:1 MIN (1),AVG (2,默认),MAX (4),ALL (7;最小值、平均值和最大值;支持简单图形),LAST (9,支持饼图/分离饼图)。
type < string 图形监控项类型。
可能的值:1 SIMPLE (0,默认),GRAPH_SUM (2;监控项的值表示整个饼图;支持饼图/分离饼图)。
item < (必填)单个监控项。
< host string (必填)监控项所属主机。
^ key string (必填)监控项键值。

另请参见:Graph item object(请参考名称匹配的相关属性)。

主机值映射

zabbix_export:
  (...)
  hosts:
    - host: 'MySQL server'
      (...)
      valuemaps:
        - name: 示例值映射
          mappings:
            - value: '1'
              newvalue: 示例值
  (...)
元素 类型 描述
uuid string (必填)此值映射的唯一标识符。
name string (必填)值映射名称。
mapping 映射的根元素。
type string 映射匹配类型。
可能的值:1 EQUAL(0,默认)、GREATER_OR_EQUAL(2)、LESS_OR_EQUAL(3)、IN_RANGE(4)、REGEXP(5)、DEFAULT(6)。
value string 原始值。
newvalue string (必填)原始值将被映射为的值。

另请参见:值映射对象(请参考名称匹配的相关属性)。

附注

1 API 中的整数值用括号表示,例如,ENABLED (0),仅供参考。 要获取更多信息,请查看表中每个条目的链接 API 对象页面或各节末尾的链接。