主机

概述

主机会连同许多相关对象及对象关系一起导出。

主机导出包含：

• 关联的主机群组
• 主机数据
• 模板关联
• 主机群组关联
• 主机接口
• 直接关联的监控项
• 直接关联的触发器
• 直接关联的发现规则及其所有原型
• 直接关联的 web 场景
• 主机宏
• 主机清单数据
• 值映射
• 关联的图形

导出

要导出主机，请执行以下操作：

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

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

• 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 模板的主机。 为便于演示元素，在创建主机后会取消链接该模板。 取消链接会保留配置中的所有元素（不同于取消链接并清除，后者会移除这些元素）。

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

主机元数据

zabbix_export:
  version: '8.0'
  host_groups:
    - uuid: 748ad4d098d447d492bb935c907f652f
      name: Databases
  hosts: (见下表)
  graphs: (见下表)

主机

zabbix_export:
  (...)
  hosts:
    - host: 'MySQL server'
      name: 'MySQL server'
      groups:
        - name: Databases
      interfaces: (see table below)
      items: (see table below)
      discovery_rules: (see table below)
      tags:
        - tag: location
          value: Riga
      macros:
        (...)
        - macro: '{$MYSQL.DSN}'
          value: 192.0.2.1
        (...)
        - macro: '{$MYSQL.PASSWORD}'
          type: SECRET_TEXT
          description: 'MySQL user password.'
        (...)
      valuemaps: (see table below)
  (...)

主机接口

zabbix_export:
  (...)
  hosts:
    - host: 'MySQL server'
      (...)
      interfaces:
        - ip: 192.0.2.1
          interface_ref: if1
      (...)

主机监控项

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: (see table below)
          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: (see table below)
        (...)
        - name: Uptime
          type: DEPENDENT
          key: mysql.uptime
          units: uptime
          description: '服务器已运行的秒数。'
          preprocessing: (see table below)
          master_item:
            key: 'mysql.get_status_variables["{$MYSQL.DSN}","{$MYSQL.USER}","{$MYSQL.PASSWORD}"]'
          tags:
            - tag: component
              value: application
          triggers: (see table below)
        (...)

主机监控项值预处理步骤

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
          (...)

主机监控项触发器

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 在过去 30 分钟内未收到任何监控项的数据。'
              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 运行时间少于 10 分钟。'
              tags:
                - tag: scope
                  value: notice
        (...)

主机低级别发现规则

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
        (...)

主机低级别发现规则过滤器

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
          (...)

主机低级别发现规则覆盖操作

主机 web 场景

主机 web 场景步骤

主机图形

zabbix_export:
  (...)
  graphs:
    - name: 'MySQL: Bandwidth'
      graph_items: (see table below)
    (...)

主机图形监控项

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
    (...)

主机值映射

zabbix_export:
  (...)
  hosts:
    - host: 'MySQL server'
      (...)
      valuemaps:
        - name: Example value map
          mappings:
            - value: '1'
              newvalue: Example value
  (...)

脚注

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