3. Шаблоны

Обзор

Шаблоны экспортируются вместе со множеством связанных объектов и со связями между объектами.

Экспорт шаблона содержит:

• Присоединённые группы шаблонов
• Присоединённые группы узлов сети (если используются в настройках прототипа узла сети)
• Данные шаблона
• Связи с другими шаблонами
• Связи с группами шаблонов
• Напрямую присоединённые элементы данных
• Напрямую присоединённые триггеры
• Напрямую присоединённые графики
• Напрямую присоединённые панели
• Напрямую присоединённые правила обнаружения со всеми прототипами
• Напрямую присоединённые веб-сценарии
• Преобразования значений

Экспорт

Для экспорта шаблонов выполните следующее:

1. Перейдите к: Сбор данных → Шаблоны (Data collection → Templates)
2. Отметьте шаблоны, которые нужно экспортировать
3. Нажмите на Экспорт (Export) ниже списка

В зависимости от выбранного формата шаблоны будут экспортированы в локальный файл со следующим именем по умолчанию:

• 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 8.0 или новее. (...)
      wizard_ready: 'YES'
      readme: |
        ## Обзор

        Это официальный шаблон для Linux. Для него требуется агент Zabbix 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: 'Тайм-аут, после которого агент считается недоступным. Работает только для агентов, доступных с сервера Zabbix/прокси (пассивный режим).'
          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: 'Агент всегда возвращает "1" для этого элемента данных. Может использоваться в сочетании с `nodata()` для проверки доступности.'
          valuemap:
            name: 'Zabbix agent ping status'
          tags:
            - tag: component
              value: system
        (...)
        - uuid: 58818005e76d46dda14d6592f601ab00
          name: 'Number of installed packages'
          key: system.sw.packages.get
          delay: 1h
          preprocessing: (см. таблицу ниже)
          tags:
            - tag: component
              value: os
          triggers: (см. таблицу ниже)
        - uuid: 403cebed115441369e94d35d070ca7b8
          name: 'Memory utilization'
          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
          (...)

Операции замещения правил низкоуровневого обнаружения шаблона

Веб-сценарии шаблона

Шаги веб-сценария шаблона

Настройка макросов шаблона

zabbix_export:
  (...)
  templates:
    - uuid: f8f7908280354f2abeed07dc788c3747
      (...)
      macros:
        - macro: '{$AGENT.TIMEOUT}'
          (...)
          config:
            type: TEXT
            priority: '1'
            label: 'Секунды с момента последнего обнаружения агента Zabbix'
            description: 'Тайм-аут, по истечении которого агент считается недоступным.'
        - macro: '{$CPU.UTIL.CRIT}'
          (...)
          config:
            type: TEXT
            priority: '2'
            section_name: Пороговые значения
            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})]: График использования пространства (относительно общего объема)'
                    - 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})]: График использования пространства, в %, (относительно максимального доступного)'
                    - 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 в записи таблицы или в конце каждого раздела.