3 Шаблоны

Обзор

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

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

• присоединенные группы хостов
• данные шаблона
• связи с другими шаблонами
• связи с группами хостов
• напрямую присоединенные элементы данных
• напрямую присоединенные триггеры
• напрямую присоединенные графики
• напрямую присоединенные панели
• напрямую присоединенные правила обнаружения со всеми прототипами
• напрямую присоединенные веб-сценарии
• преобразования значений

Экспорт

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

1. Перейдите в Сбор данных → Шаблоны.
2. Установите флажки у шаблонов, которые нужно экспортировать.
3. Нажмите Экспорт под списком.

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

• zabbix_export_templates.yaml — при экспорте в YAML (вариант по умолчанию для экспорта);
• zabbix_export_templates.xml — при экспорте в XML;
• zabbix_export_templates.json — при экспорте в JSON.

Импорт

Чтобы импортировать шаблоны, выполните следующие действия:

1. Перейдите в Data collection → Templates.
2. Нажмите Import в правом верхнем углу.
3. Выберите файл импорта.
4. Нажмите Import в правом нижнем углу формы настройки.

Если установить флажок Advanced options, будет отображен подробный список всех элементов, доступных для импорта, — отметьте или снимите отметку с каждого правила импорта по мере необходимости.

Если установить или снять флажок в строке All, будут отмечены/сняты все элементы ниже.

Правила импорта:

На следующем экране вы сможете просмотреть содержимое импортируемого шаблона. Если это новый шаблон, все элементы будут показаны зеленым цветом. При обновлении существующего шаблона новые элементы шаблона будут выделены зеленым цветом; удаленные элементы шаблона будут выделены красным цветом; элементы, которые не изменились, будут показаны на сером фоне.

Меню слева можно использовать для навигации по списку изменений. Раздел Updated выделяет все изменения, внесенные в существующие элементы шаблона. В разделе Added перечислены новые элементы шаблона. Элементы в каждом разделе сгруппированы по типу элемента; нажмите серую стрелку, чтобы развернуть или свернуть группу элементов.

Просмотрите изменения шаблона, затем нажмите Import, чтобы выполнить импорт шаблона. Сообщение об успешном или неуспешном импорте будет отображено в веб-интерфейсе.

Формат экспорта

При экспорте шаблона 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: (см. таблицу ниже)
  triggers: (см. таблицу ниже)
  graphs: (см. таблицу ниже)

Шаблоны

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: (см. таблицу ниже)
      discovery_rules: (см. таблицу ниже)
      tags:
        - tag: class
          value: os
        - tag: target
          value: linux
      macros:
        - macro: '{$AGENT.TIMEOUT}'
          value: 3m
          description: 'Тайм-аут, по истечении которого агент считается недоступным. Работает только для агентов, доступных с сервера/прокси Zabbix (пассивный режим).'
          config: (см. таблицу ниже)
        - macro: '{$CPU.UTIL.CRIT}'
          value: '90'
          description: 'Критический порог утилизации CPU, выраженный в %.'
          config: (см. таблицу ниже)
        (...)
      dashboards: (см. таблицу ниже)
      valuemaps: (см. таблицу ниже)
    (...)

Элементы данных шаблона

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: 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: 'Обнаружение сетевых интерфейсов'
          key: net.if.discovery
          delay: 1h
          filter: (см. таблицу ниже)
          description: 'Обнаружение сетевых интерфейсов.'
          item_prototypes: (см. таблицу ниже)
          trigger_prototypes: (см. таблицу ниже)
          graph_prototypes: (см. таблицу ниже)
        (...)

Фильтры правил низкоуровневого обнаружения шаблона

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

Шаблон низкоуровневого правила обнаружения переопределяет операции

::: noteclassicСм. также: объект операции переопределения правила LLD (ссылка на соответствующее свойство с соответствующим именем).:::

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

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

::: noteclassicСм. также: Объект шага веб-сценария (ссылка на соответствующее свойство с соответствующим именем).:::

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

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: Файловые системы
          pages:
            - name: Обзор
              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 типа integer в скобках, например ENABLED (0), упоминаются только для справки. Для получения дополнительной информации смотрите страницу связанного объекта API в записи таблицы или в конце каждого раздела.