模板

概述

模板会与许多相关对象及对象关系一起导出。

模板导出包含：

• 关联的模板组
• 关联的主机组（如果在主机原型配置中使用）
• 模板数据
• 与其他模板的关联
• 与模板组的关联
• 直接关联的监控项
• 直接关联的触发器
• 直接关联的图形
• 直接关联的仪表板
• 直接关联的发现规则及其所有原型
• 直接关联的 web 场景
• 值映射

导出

要导出模板，请执行以下操作：

1. 转到 数据采集 > 模板。
2. 勾选要导出的模板复选框。
3. 单击列表下方的 导出。

根据所选格式，模板将导出到本地文件，默认文件名如下：

• zabbix_export_templates.yaml - YAML 导出（默认导出选项）；
• zabbix_export_templates.xml - XML 导出；
• zabbix_export_templates.json - JSON 导出。

导入

要导入模板，请执行以下操作：

1. 转到 数据采集 > 模板。
2. 单击右上角的 导入。
3. 选择导入文件。
4. 单击配置表单右下角的 导入。

如果勾选 高级选项 复选框，将显示所有可导入元素的详细列表 - 按需勾选或取消勾选每条导入规则。

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

导入规则：

在下一屏中，您可以查看正在导入的模板内容。 如果这是一个新模板，所有元素都将以绿色显示。 如果是在更新现有模板，新模板元素将以绿色高亮显示；已移除的模板元素将以红色高亮显示；未发生变化的元素将显示在灰色背景上。

左侧菜单可用于在更改列表中导航。 已更新 部分会突出显示对现有模板元素所做的所有更改。 已添加 部分列出新的模板元素。 每个部分中的元素按元素类型分组；单击灰色箭头可展开或折叠该组元素。

检查模板更改后，单击 导入 以执行模板导入。 导入成功或失败的消息将显示在前端。

导出格式

当模板被导出时，Zabbix 会生成结构化的 YAML、JSON 或 XML 格式。 导出内容包括模板元素，例如模板元数据、监控项、宏、触发器、仪表板等。

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

以下各节将介绍导出格式中的每个元素。 示例使用 Linux by Zabbix agent 模板。

省略号 (...) 表示为简洁起见省略的元素。 注释 (see table below) 用于在后续章节中对该元素进行更详细说明时。

模板元数据

zabbix_export:
  version: '8.0'
  template_groups:
    - uuid: 846977d1dfed4968bc5f8bdb363285bc
      name: 'Templates/Operating systems'
  templates: (see table below)
  triggers: (see table below)
  graphs: (see table below)

模板

zabbix_export:
  (...)
  templates:
    - uuid: f8f7908280354f2abeed07dc788c3747
      template: 'Linux by Zabbix agent'
      name: 'Linux by Zabbix agent'
      description: |
        这是一个官方 Linux 模板。它需要 Zabbix agent 8.0 或更高版本。(...)
      wizard_ready: 'YES'
      readme: |
        ## 概述

        这是一个官方 Linux 模板。它需要 Zabbix agent 8.0 或更高版本。(...)
      vendor:
        name: Zabbix
        version: 8.0-2
      groups:
        - name: 'Templates/Operating systems'
      items: (see table below)
      discovery_rules: (see table below)
      tags:
        - tag: class
          value: os
        - tag: target
          value: linux
      macros:
        - macro: '{$AGENT.TIMEOUT}'
          value: 3m
          description: '超时后将 agent 视为不可用。仅适用于可从 Zabbix 服务器/proxy 访问的 agent（被动模式）。'
          config: (see table below)
        - macro: '{$CPU.UTIL.CRIT}'
          value: '90'
          description: '以 % 表示的 CPU 利用率严重阈值。'
          config: (see table below)
        (...)
      dashboards: (see table below)
      valuemaps: (see table below)
    (...)

模板监控项

zabbix_export:
  (...)
  templates:
    (...)
      items:
        - uuid: f94f9f4699e94c369e6c98b2a2f485ce
          name: 'Zabbix agent ping'
          key: agent.ping
          description: 'agent 始终会为此监控项返回 "1"。可与 `nodata()` 结合用于可用性检查。'
          valuemap:
            name: 'Zabbix agent ping status'
          tags:
            - tag: component
              value: system
        (...)
        - uuid: 58818005e76d46dda14d6592f601ab00
          name: '已安装软件包数量'
          key: system.sw.packages.get
          delay: 1h
          preprocessing: (见下表)
          tags:
            - tag: component
              value: os
          triggers: (见下表)
        - uuid: 403cebed115441369e94d35d070ca7b8
          name: '内存利用率'
          type: DEPENDENT
          key: vm.memory.utilization
          value_type: FLOAT
          units: '%'
          description: '已使用内存的百分比按 `100-pavailable` 计算。'
          preprocessing: (见下表)
          master_item:
            key: 'vm.memory.size[pavailable]'
          tags:
            - tag: component
              value: memory
          triggers: (见下表)
        (...)

模板监控项值预处理步骤

zabbix_export:
  (...)
  templates:
    (...)
      items:
        (...)
        - uuid: 58818005e76d46dda14d6592f601ab00
          (...)
          preprocessing:
            - type: JSONPATH
              parameters:
                - $.length()
            - type: DISCARD_UNCHANGED_HEARTBEAT
              parameters:
                - 12h
          (...)

模板监控项触发器

zabbix_export:
  (...)
  templates:
    (...)
      items:
        (...)
        - uuid: 58818005e76d46dda14d6592f601ab00
          (...)
          triggers:
            - uuid: b950c306394f4b3c902060a8273cbcde
              expression: 'change(/Linux by Zabbix agent/system.sw.packages.get)<>0'
              name: 'Linux: Number of installed packages has been changed'
              priority: WARNING
              manual_close: 'YES'
              tags:
                - tag: scope
                  value: notice
        (...)
        - uuid: 403cebed115441369e94d35d070ca7b8
          (...)
          triggers:
            - uuid: cfd395b1cde74ef18a5e5f840bd5142a
              expression: 'min(/Linux by Zabbix agent/vm.memory.utilization,5m)>{$MEMORY.UTIL.MAX}'
              name: 'Linux: High memory utilization'
              event_name: 'Linux: High memory utilization (>{$MEMORY.UTIL.MAX}% for 5m)'
              priority: AVERAGE
              description: 'The system is running out of free memory.'
              dependencies:
                - name: 'Linux: Lack of available memory'
                  expression: 'max(/Linux by Zabbix agent/vm.memory.size[available],5m)<{$MEMORY.AVAILABLE.MIN} and last(/Linux by Zabbix agent/vm.memory.size[total])>0'
              tags:
                - tag: scope
                  value: capacity
                - tag: scope
                  value: performance
        (...)

模板低级发现规则

zabbix_export:
  (...)
  templates:
    (...)
      discovery_rules:
        - uuid: acfdea9c46ef48c68e6636f43b8f96a2
          name: 'Network interface discovery'
          key: net.if.discovery
          delay: 1h
          filter: (see table below)
          description: 'The discovery of network interfaces.'
          item_prototypes: (see table below)
          trigger_prototypes: (see table below)
          graph_prototypes: (see table below)
        (...)

模板低级别发现规则过滤器

zabbix_export:
  (...)
  templates:
    (...)
      discovery_rules:
        - uuid: acfdea9c46ef48c68e6636f43b8f96a2
          (...)
          filter:
            evaltype: AND
            conditions:
              - macro: '{#IFNAME}'
                value: '{$NET.IF.IFNAME.MATCHES}'
              - macro: '{#IFNAME}'
                value: '{$NET.IF.IFNAME.NOT_MATCHES}'
                operator: NOT_MATCHES_REGEX
          (...)
        - uuid: 2bbdc79f082d4c618e01bec625e9c90a
          (...)
          filter:
            evaltype: AND
            conditions:
              - macro: '{#DEVNAME}'
                value: '{$VFS.DEV.DEVNAME.MATCHES}'
              - macro: '{#DEVNAME}'
                value: '{$VFS.DEV.DEVNAME.NOT_MATCHES}'
                operator: NOT_MATCHES_REGEX
              - macro: '{#DEVTYPE}'
                value: disk
          (...)

模板低级别发现规则覆盖操作

模板 web 场景

模板 web 场景步骤

模板宏配置

zabbix_export:
  (...)
  templates:
    - uuid: f8f7908280354f2abeed07dc788c3747
      (...)
      macros:
        - macro: '{$AGENT.TIMEOUT}'
          (...)
          config:
            type: TEXT
            priority: '1'
            label: '自上次看到 Zabbix agent 以来的秒数'
            description: '超出此时间后，agent 将被视为不可用。'
        - macro: '{$CPU.UTIL.CRIT}'
          (...)
          config:
            type: TEXT
            priority: '2'
            section_name: Thresholds
            label: 'CPU 利用率阈值'
            description: 'CPU 利用率的严重阈值，以 % 表示。取值范围为 0 到 100（含）。'
            regex: '^-?([0-9]+|(([0-9]+)\.([0-9]+)))$'
        (...)
        - macro: '{$IFCONTROL}'
          (...)
          config:
            type: CHECKBOX
            priority: '19'
            label: '接口控制'
            description: '当接口运行状态变为 "Link down" 时触发触发器。'
            options:
              - checked: '1'
                unchecked: '0'
        (...)

模板仪表板

zabbix_export:
  (...)
  templates:
    (...)
      dashboards:
        - uuid: c689ad3115fd46a4b927d1f70ee2e5a4
          name: Filesystems
          pages:
            - name: Overview
              widgets: (see table below)
        (...)

模板仪表板小部件

zabbix_export:
  (...)
  templates:
    (...)
      dashboards:
        - uuid: c689ad3115fd46a4b927d1f70ee2e5a4
          name: Filesystems
          pages:
            - name: Overview
              widgets:
                - type: graphprototype
                  width: '72'
                  height: '5'
                  fields:
                    - type: INTEGER
                      name: columns
                      value: '3'
                    - type: GRAPH_PROTOTYPE
                      name: graphid.0
                      value:
                        host: 'Linux by Zabbix agent'
                        name: 'FS [{#FSTYPE}({#FSNAME})]: Space utilization chart (relative to total)'
                    - type: STRING
                      name: reference
                      value: AAAEB
                - type: graphprototype
                  'y': '5'
                  width: '72'
                  height: '5'
                  fields:
                    - type: INTEGER
                      name: columns
                      value: '1'
                    - type: GRAPH_PROTOTYPE
                      name: graphid.0
                      value:
                        host: 'Linux by Zabbix agent'
                        name: 'FS [{#FSTYPE}({#FSNAME})]: Space usage graph, in % (relative to max available)'
                    - type: STRING
                      name: reference
                      value: AAAEC
        (...)

模板值映射

zabbix_export:
  (...)
  templates:
    (...)
      valuemaps:
        - uuid: 8c048c6cca8248f2860c208e8db0f59e
          name: ifOperStatus
          mappings:
            - value: '0'
              newvalue: unknown
            - value: '1'
              newvalue: notpresent
            - value: '2'
              newvalue: down
            - value: '3'
              newvalue: lowerlayerdown
            - value: '4'
              newvalue: testing
            - value: '5'
              newvalue: dormant
            - value: '6'
              newvalue: up
        (...)

脚注

¹ 括号中的 API 整数值，例如 ENABLED (0)，仅供参考。 有关更多信息，请参见表项中的链接 API 对象页面，或每个章节末尾的相关页面。