Шаблоны

Обзор

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

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

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

Экспорт

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

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

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

• 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.

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

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

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