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: '7.4'
  template_groups:
    - uuid: 846977d1dfed4968bc5f8bdb363285bc
      name: 'Templates/Operating systems'
  templates: (см. таблицу ниже)
  triggers: (см. таблицу ниже)
  graphs: (см. таблицу ниже)

Шаблоны

zabbix_export:
  (...)
  templates:
    - uuid: f8f7908280354f2abeed07dc788c3747
      template: 'Linux by Zabbix agent'
      name: 'Linux by Zabbix agent'
      description: |
        Это официальный шаблон Linux. Для него требуется Zabbix agent 7.4 или новее. (...)
      wizard_ready: 'YES'
      readme: |
        ## Обзор

        Это официальный шаблон Linux. Для него требуется Zabbix agent 7.4 или новее. (...)
      vendor:
        name: Zabbix
        version: 7.4-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'
          key: agent.ping
          description: 'Агент всегда возвращает "1" для этого элемента данных. Может использоваться в сочетании с `nodata()` для проверки доступности.'
          valuemap:
            name: 'Статус пинга агента Zabbix'
          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: Количество установленных пакетов изменилось'
              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: Высокое использование памяти'
              event_name: 'Linux: Высокое использование памяти (>{$MEMORY.UTIL.MAX}% за 5m)'
              priority: AVERAGE
              description: 'В системе заканчивается свободная память.'
              dependencies:
                - name: 'Linux: Недостаток доступной памяти'
                  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: 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})]: Диаграмма использования пространства (относительно общего объема)'
                    - 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 в записи таблицы или в конце каждого раздела.