Шаблоны

Обзор

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

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

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

Экспорт

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

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

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

• zabbix_export_templates.yaml - при экспорте в YAML;
• zabbix_export_templates.xml - при экспорте в XML;
• zabbix_export_templates.json - при экспорте в JSON.

Импорт

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

1. Перейдите в раздел Сбор данных > Шаблоны.
2. Нажмите Импорт в правом верхнем углу.
3. Выберите файл импорта.
4. Установите флажки правил импорта, которые хотите применить (см. ниже).
5. Нажмите Импорт в правом нижнем углу формы настройки.

Если установить флажок Расширенные параметры, отобразится подробный список всех доступных для импорта элементов. Установите или снимите флажки правил импорта по необходимости.

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

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

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

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

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

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

Когда шаблон экспортируется, Zabbix генерирует структурированный формат YAML, JSON или XML. Экспорт включает элементы шаблона, такие как метаданные шаблона, элементы данных, макросы, триггеры, панели мониторинга и многое другое.

Каждый элемент выполняет определенную функцию и может содержать вложенные элементы.

В следующих разделах описывается каждый элемент в формате экспорта. В примерах используется шаблон Linux by Zabbix agent.

Многоточие (...) обозначает элементы, опущенные для краткости. Примечание (см. таблицу ниже) используется, когда элемент объясняется более подробно в последующих разделах.

Метаданные шаблона

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

        Это официальный шаблон для Linux. Требуется агент Zabbix версии 8.2 или новее. (...)
      vendor:
        name: Zabbix
        version: 8.2-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: 'Критический порог загрузки ЦП, выраженный в процентах.'
          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
          (...)

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

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

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

Конфигурация макроса шаблона

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})]: 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 в записи таблицы или в конце каждого раздела.