Table of Contents

3. Шаблоны

3. Шаблоны

Обзор

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

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

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

Экспорт

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

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

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

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

Импорт

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

Перейдите в: Сбор данных → Шаблоны (Data collection → Templates)
Нажмите на Импорт (Import) в правом верхнем углу
Выберите импортируемый файл
Нажмите на Импорт (Import) в правом нижнем углу диалога настроек

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

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

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

Правило	Описание
Обновить существующее (Update existing)	Существующие элементы будут обновлены данными, взятыми из файла импорта. В противном случае они не будут обновляться.
Создать новое (Create new)	Новые элементы будут созданы с использованием данных из файла импорта. В противном случае они не будут созданы.
Удалить отсутствующее (Delete missing)	Существующие элементы, отсутствующие в файле импорта, будут удалены. В противном случае они не будут удаляться. Если для Присоединение шаблонов (Template linkage) выбрана опция Удалить отсутствующее (Delete missing), то существующее присоединение к шаблону, но отсутствующее в файле импорта, будет удалено. Объекты, унаследованные от отсоединяемых шаблонов (элементы данных, триггеры, графики и т.п.), не будут удалены (если только опция «Удалить отсутствующее» не отмечена также для каждого из объектов).

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

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

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

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

Формат экспорта в YAML:

zabbix_export:
         version: '7.0'
         template_groups:
           - uuid: a571c0d144b14fd4a87a9d9b2aa9fcd6
             name: Templates/Applications
         host_groups:
           - uuid: a571c0d144b14fd4a87a9d9b2aa9fcd6
             name: Applications
         templates:
           - uuid: 56079badd056419383cc26e6a4fcc7e0
             template: VMware
             name: VMware
             description: |
               You can discuss this template or leave feedback on our forum https://www.zabbix.com/forum/zabbix-suggestions-and-feedback/
       
               Template tooling version used: 0.41
             groups:
               - name: Templates/Applications
             items:
               - uuid: 5ce209f4d94f460488a74a92a52d92b1
                 name: 'VMware: Event log'
                 type: SIMPLE
                 key: 'vmware.eventlog[{$VMWARE.URL},skip]'
                 history: 7d
                 trends: '0'
                 value_type: LOG
                 username: '{$VMWARE.USERNAME}'
                 password: '{$VMWARE.PASSWORD}'
                 description: 'Collect VMware event log.'
                 tags:
                   - tag: component
                     value: log
               - uuid: ee2edadb8ce943ef81d25dbbba8667a4
                 name: 'VMware: Full name'
                 type: SIMPLE
                 key: 'vmware.fullname[{$VMWARE.URL}]'
                 delay: 1h
                 history: 7d
                 trends: '0'
                 value_type: CHAR
                 username: '{$VMWARE.USERNAME}'
                 password: '{$VMWARE.PASSWORD}'
                 description: 'VMware service full name.'
                 preprocessing:
                   - type: DISCARD_UNCHANGED_HEARTBEAT
                     parameters:
                       - 1d
                 tags:
                   - tag: component
                     value: system
               - uuid: a0ec9145f2234fbea79a28c57ebdb44d
                 name: 'VMware: Version'
                 type: SIMPLE
                 key: 'vmware.version[{$VMWARE.URL}]'
                 delay: 1h
                 history: 7d
                 trends: '0'
                 value_type: CHAR
                 username: '{$VMWARE.USERNAME}'
                 password: '{$VMWARE.PASSWORD}'
                 description: 'VMware service version.'
                 preprocessing:
                   - type: DISCARD_UNCHANGED_HEARTBEAT
                     parameters:
                       - 1d
                 tags:
                   - tag: component
                     value: system
             discovery_rules:
               - uuid: 16ffc933cce74cf28a6edf306aa99782
                 name: 'Discover VMware clusters'
                 type: SIMPLE
                 key: 'vmware.cluster.discovery[{$VMWARE.URL}]'
                 delay: 1h
                 username: '{$VMWARE.USERNAME}'
                 password: '{$VMWARE.PASSWORD}'
                 description: 'Discovery of clusters'
                 item_prototypes:
                   - uuid: 46111f91dd564a459dbc1d396e2e6c76
                     name: 'VMware: Status of "{#CLUSTER.NAME}" cluster'
                     type: SIMPLE
                     key: 'vmware.cluster.status[{$VMWARE.URL},{#CLUSTER.NAME}]'
                     history: 7d
                     username: '{$VMWARE.USERNAME}'
                     password: '{$VMWARE.PASSWORD}'
                     description: 'VMware cluster status.'
                     valuemap:
                       name: 'VMware status'
                     tags:
                       - tag: cluster
                         value: '{#CLUSTER.NAME}'
                       - tag: component
                         value: cluster
               - uuid: 8fb6a45cbe074b0cb6df53758e2c6623
                 name: 'Discover VMware datastores'
                 type: SIMPLE
                 key: 'vmware.datastore.discovery[{$VMWARE.URL}]'
                 delay: 1h
                 username: '{$VMWARE.USERNAME}'
                 password: '{$VMWARE.PASSWORD}'
                 item_prototypes:
                   - uuid: 4b61838ba4c34e709b25081ae5b059b5
                     name: 'VMware: Average read latency of the datastore {#DATASTORE}'
                     type: SIMPLE
                     key: 'vmware.datastore.read[{$VMWARE.URL},{#DATASTORE},latency]'
                     history: 7d
                     username: '{$VMWARE.USERNAME}'
                     password: '{$VMWARE.PASSWORD}'
                     description: 'Amount of time for a read operation from the datastore (milliseconds).'
                     tags:
                       - tag: component
                         value: datastore
                       - tag: datastore
                         value: '{#DATASTORE}'
                   - uuid: 5355c401dc244bc588ccd18767577c93
                     name: 'VMware: Free space on datastore {#DATASTORE} (percentage)'
                     type: SIMPLE
                     key: 'vmware.datastore.size[{$VMWARE.URL},{#DATASTORE},pfree]'
                     delay: 5m
                     history: 7d
                     value_type: FLOAT
                     units: '%'
                     username: '{$VMWARE.USERNAME}'
                     password: '{$VMWARE.PASSWORD}'
                     description: 'VMware datastore space in percentage from total.'
                     tags:
                       - tag: component
                         value: datastore
                       - tag: datastore
                         value: '{#DATASTORE}'
                   - uuid: 84f13c4fde2d4a17baaf0c8c1eb4f2c0
                     name: 'VMware: Total size of datastore {#DATASTORE}'
                     type: SIMPLE
                     key: 'vmware.datastore.size[{$VMWARE.URL},{#DATASTORE}]'
                     delay: 5m
                     history: 7d
                     units: B
                     username: '{$VMWARE.USERNAME}'
                     password: '{$VMWARE.PASSWORD}'
                     description: 'VMware datastore space in bytes.'
                     tags:
                       - tag: component
                         value: datastore
                       - tag: datastore
                         value: '{#DATASTORE}'
                   - uuid: 540cd0fbc56c4b8ea19f2ff5839ce00d
                     name: 'VMware: Average write latency of the datastore {#DATASTORE}'
                     type: SIMPLE
                     key: 'vmware.datastore.write[{$VMWARE.URL},{#DATASTORE},latency]'
                     history: 7d
                     username: '{$VMWARE.USERNAME}'
                     password: '{$VMWARE.PASSWORD}'
                     description: 'Amount of time for a write operation to the datastore (milliseconds).'
                     tags:
                       - tag: component
                         value: datastore
                       - tag: datastore
                         value: '{#DATASTORE}'
               - uuid: a5bc075e89f248e7b411d8f960897a08
                 name: 'Discover VMware hypervisors'
                 type: SIMPLE
                 key: 'vmware.hv.discovery[{$VMWARE.URL}]'
                 delay: 1h
                 username: '{$VMWARE.USERNAME}'
                 password: '{$VMWARE.PASSWORD}'
                 description: 'Discovery of hypervisors.'
                 host_prototypes:
                   - uuid: 051a1469d4d045cbbf818fcc843a352e
                     host: '{#HV.UUID}'
                     name: '{#HV.NAME}'
                     group_links:
                       - group:
                           name: Applications
                     group_prototypes:
                       - name: '{#CLUSTER.NAME}'
                       - name: '{#DATACENTER.NAME}'
                     templates:
                       - name: 'VMware Hypervisor'
                     macros:
                       - macro: '{$VMWARE.HV.UUID}'
                         value: '{#HV.UUID}'
                         description: 'UUID of hypervisor.'
                     custom_interfaces: 'YES'
                     interfaces:
                       - ip: '{#HV.IP}'
               - uuid: 9fd559f4e88c4677a1b874634dd686f5
                 name: 'Discover VMware VMs'
                 type: SIMPLE
                 key: 'vmware.vm.discovery[{$VMWARE.URL}]'
                 delay: 1h
                 username: '{$VMWARE.USERNAME}'
                 password: '{$VMWARE.PASSWORD}'
                 description: 'Discovery of guest virtual machines.'
                 host_prototypes:
                   - uuid: 23b9ae9d6f33414880db1cb107115810
                     host: '{#VM.UUID}'
                     name: '{#VM.NAME}'
                     group_links:
                       - group:
                           name: Applications
                     group_prototypes:
                       - name: '{#CLUSTER.NAME} (vm)'
                       - name: '{#DATACENTER.NAME}/{#VM.FOLDER} (vm)'
                       - name: '{#HV.NAME}'
                     templates:
                       - name: 'VMware Guest'
                     macros:
                       - macro: '{$VMWARE.VM.UUID}'
                         value: '{#VM.UUID}'
                         description: 'UUID of guest virtual machine.'
                     custom_interfaces: 'YES'
                     interfaces:
                       - ip: '{#VM.IP}'
             tags:
               - tag: class
                 value: software
               - tag: target
                 value: vmware
             macros:
               - macro: '{$VMWARE.PASSWORD}'
                 description: 'VMware service {$USERNAME} user password'
               - macro: '{$VMWARE.URL}'
                 description: 'VMware service (vCenter or ESX hypervisor) SDK URL (https://servername/sdk)'
               - macro: '{$VMWARE.USERNAME}'
                 description: 'VMware service user name'
             valuemaps:
               - uuid: 3c59c22905054d42ac4ee8b72fe5f270
                 name: 'VMware status'
                 mappings:
                   - value: '0'
                     newvalue: gray
                   - value: '1'
                     newvalue: green
                   - value: '2'
                     newvalue: yellow
                   - value: '3'
                     newvalue: red

Экспортируемые элементы

Экспортируемые элементы описаны в таблицах ниже.

Элемент		Тип	Описание
template_groups			(обязательный) Корневой элемент для групп шаблонов.
	uuid	строка	(обязательный) Уникальный идентификатор для этой группы шаблонов.
	name	строка	(обязательный) Имя группы шаблонов.
host_groups			(обязательный) Корневой элемент для групп узлов сети, которые используются прототипами узлов сети.
	uuid	строка	(обязательный) Уникальный идентификатор для этой группы узлов сети.
	name	строка	(обязательный) Имя группы узлов сети.
templates			Корневой элемент для шаблонов.

Шаблоны

Элемент		Тип	Описание
uuid		строка	(обязательный) Уникальный идентификатор конкретного шаблона.
template		строка	(обязательный) Уникальное имя шаблона.
name		строка	Видимое имя шаблона.
description		текст	Описание шаблона.
vendor			Корневой элемент для поставщика шаблона (присутствует, если экспортируемый шаблон содержит данные о поставщике).
	name	строка	(обязательный) Имя поставщика шаблона.
	version	строка	(обязательный) Версия шаблона. Для готовых к использованию шаблонов версия отображается следующим образом: основная версия Zabbix, разделитель («-»), номер ревизии (увеличивается с каждой новой версией шаблона и сбрасывается с каждой основной версией Zabbix). Например, 6.4-0, 6.4-3, 7.0-0, 7.0-3.
templates			Корневой элемент для присоединённых шаблонов.
	name	строка	(обязательный) Имя шаблона.
groups			Корневой элемент для групп шаблонов.
	name	строка	(обязательный) Имя группы шаблонов.
items			Корневой элемент для элементов данных шаблона.
discovery_rules			Корневой элемент для правил низкоуровневого обнаружения шаблона.
httptests			Корневой элемент для веб-сценариев шаблона.
tags			Корневой элемент для тегов шаблона.
	tag	строка	(обязательный) Имя тега.
	value	строка	Значение тега.
macros			Корневой элемент для макросов шаблона.
	macro	строка	(обязательный) Имя пользовательского макроса.
	type	строка	Тип пользовательского макроса. Возможные значения:¹ TEXT (0, по умолчанию), SECRET_TEXT (1), VAULT (2). Смотрите также: Объект пользовательского макроса (`Тип`).
	value	строка	Значение пользовательского макроса.
	description	строка	Описание пользовательского макроса.
dashboards			Корневой элемент для панелей шаблона.
valuemaps			Корневой элемент для преобразований значений шаблона.

Теги элемента данных шаблона

Элемент	Свойство элемента	Обязательный	Тип	Диапазон¹	Описание
items		-			Корневой элемент элементов данных.
	uuid	x	`строка`		Уникальный идентификатор элемента данных
	name	x	`строка`		Имя элемента данных.
	type	-	`строка`	0 - ZABBIX_PASSIVE (default) 2 - TRAP 3 - SIMPLE 5 - INTERNAL 7 - ZABBIX_ACTIVE 10 - EXTERNAL 11 - ODBC 12 - IPMI 13 - SSH 14 - TELNET 15 - CALCULATED 16 - JMX 17 - SNMP_TRAP 18 - DEPENDENT 19 - HTTP_AGENT 20 - SNMP_AGENT 21 - ITEM_TYPE_SCRIPT	Тип элемента данных.
	snmp_oid	-	`строка`		ID SNMP объекта.
	key	x	`строка`		Ключ элемента данных.
	delay	-	`строка`	По умолчанию: 1m	Интервал обновления элемента данных. Принимает секунды или единицы времени с суффиксом (30s, 1m, 2h, 1d). Опционально можно указать один и более пользовательских интервалов как гибких интервалов, так и интервалов по расписанию. Несколько интервалов отделяются при помощи двоеточия. Можно использовать пользовательские макросы. Один макрос должен занимать все поле. Несколько макросов в поле или макросы вместе с текстом не поддерживаются. Гибкие интервалы можно указывать в виде двух макросов с разделением прямой косой чертой (например, `{$FLEX_INTERVAL}/{$FLEX_PERIOD}`).
	history	-	`строка`	По умолчанию: 90d	Единица времени как долго хранить данные истории. Единица времени с суффиксом, пользовательский макрос или LLD макросы.
	trends	-	`строка`	По умолчанию: 365d	Единица времени как долго хранить данные динамики изменений. Единица времени с суффиксом, пользовательский макрос или LLD макросы.
	status	-	`целое число`	0 - ENABLED (по умолчанию) 1 - DISABLED	Состояние элемента данных.
	value_type	-	`строка`	0 - FLOAT 1 - CHAR 2 - LOG 3 - UNSIGNED (по умолчанию) 4 - TEXT	Тип получаемого значения.
	allowed_hosts	-	`строка`		Список IP адресов (разделенных запятыми) узлов сети, с которых разрешена отправка данных на элемент данных Используется элементами данных с типами траппер и HTTP агент.
	units	-	`строка`		Единицы измерений получаемых значений (bps, B и т.п.).
	params	-	`текст`		Дополнительные параметры, зависящие от типа элемента данных: - выполняемый скрипт для элементов данных с типами Скрипт, SSH и Telnet; - SQL запрос для элементов данных с типом монитор баз данных; - формула для вычисляемых элементов данных.
	ipmi_sensor	-	`строка`		ID IPMI сенсора. Используется только IPMI элементами данных.
	authtype	-	`строка`	Тип аутентификации для элементов данных типа SSH агент: 0 - PASSWORD (по умолчанию) 1 - PUBLIC_KEY Тип аутентификации для элементов данных типа HTTP агент: 0 - NONE (default) 1 - BASIC 2 - NTLM	Тип аутентификации. Используется только элементами данных с типами SSH и HTTP агент.
	username	-	`строка`		Имя пользователя для аутентификации. Используется элементами данных с типами простая проверка, SSH, Telnet, монитор баз данных, JMX и HTTP агент. Требуется SSH и Telnet элементам данных. При использовании с JMX агентом пароль также должен быть указан вместе с именем пользователя или оба свойства должны быть пустыми.
	password	-	`строка`		Пароль для аутентификации. Используется элементами данных с типами простая проверка, SSH, Telnet, монитор баз данных, JMX и HTTP агент. При использовании с JMX агентом имя пользователя также должно быть указано вместе с именем пользователя или оба свойства должны быть пустыми.
	publickey	-	`строка`		Имя файла публичного ключа Требуемся SSH агент элементам данных.
	privatekey	-	`строка`		Имя файла приватного ключа Требуемся SSH агент элементам данных.
	port	-	`строка`		Пользовательский порт элемента данных. Может содержать пользовательские макросы. Используется только SNMP элементами данных.
	description	-	`текст`		Описание элемента данных.
	inventory_link	-	`строка`	0 - NONE Имя поля инвентарных данных в верхнем регистре. Например: 4 - ALIAS 6 - OS_FULL 14 - HARDWARE и т.п.	Поле инвентарных данных, которое заполняется элементом данных. Обратитесь к странице инвентарных данных узлов сети для получения списка поддерживаемых полей инвентарных данных и их ID.
	logtimefmt	-	`строка`		Формат времени в записях в журнале. Используется только журнал (лог) элементами данных.
	jmx_endpoint	-	`строка`		JMX endpoint. Используется только JMX агент элементами данных.
	url	-	`строка`		Строка URL. Требуется только HTTP агент элементам данных.
	allow_traps	-	`строка`	0 - NO (по умолчанию) 1 - YES	Свойство позволяет отправку данных на элемент данных Используется только HTTP агент элементами данных.
	follow_redirects	-	`строка`	0 - NO 1 - YES (по умолчанию).	Следование перенаправлениям HTTP ответа Используется только HTTP агент элементами данных.
headers		-			Корневой элемент заголовков HTTP(S) запроса, где имя заголовка используется ключем, а значение заголовка значением. Используется только HTTP агент элементами данных.
	name	x	`строка`		Имя заголовка.
	value	x	`строка`		Значение заголовка.
	http_proxy	-	`строка`		Строка подключения к HTTP(S) прокси Используется только HTTP агент элементами данных.
	output_format	-	`строка`	0 - RAW (по умолчанию) 1 - JSON	Каким образом обрабатывать ответ Используется только HTTP агент элементами данных.
	post_type	-	`строка`	0 - RAW (по умолчанию) 2 - JSON 3 - XML	Тип тела post данных. Используется только HTTP агент элементами данных.
	posts	-	`строка`		Данные тела HTTP(S) запроса. Используется только HTTP агент элементами данных.
query_fields		-			Корневой элемент для параметров запроса. Используется только HTTP агент элементами данных.
	name	x	`строка`		Имя параметра.
	value	-	`строка`		Значение параметра.
	request_method	-	`строка`	0 - GET (по умолчанию) 1 - POST 2 - PUT 3 - HEAD	Метод запроса. Используется только HTTP агент элементами данных.
	retrieve_mode	-	`строка`	0 - BODY (default) 1 - HEADERS 2 - BOTH	Какую часть ответа нужно записывать. Используется только HTTP агент элементами данных.
	ssl_cert_file	-	`строка`		Путь к файлу публичного ключа SSL. Используется только HTTP агент элементами данных.
	ssl_key_file	-	`строка`		Путь к файлу приватного ключа SSL. Используется только HTTP агент элементами данных.
	ssl_key_password	-	`строка`		Пароль к файлу SSL ключа. Используется только HTTP агент элементами данных.
	status_codes	-	`строка`		Диапазоны требуемых кодов HTTP состояний, разделенные запятыми. Поддерживаются пользовательские макросы. Например: 200,200-{$M},{$M},200-400 Используется только HTTP агент элементами данных.
	timeout	-	`строка`		Время ожидания при выполнении запроса данных элемента данных. Поддерживаются пользовательские макросы. Используется только HTTP агент элементами данных.
	verify_host	-	`строка`	0 - NO (по умолчанию) 1 - YES	Проверка имени узла в URL в полях Common Name или Subject Alternate Name сертификата хоста. Используется только HTTP агент элементами данных.
	verify_peer	-	`строка`	0 - NO (по умолчанию) 1 - YES	Проверка подлинности сертификата хоста. Используется только HTTP агент элементами данных.
parameters		-			Корневой элемент пользовательских параметров. Используется только Скрипт элементами данных.
	name	x	`строка`		Имя параметра. Используется только Скрипт элементами данных.
	value	-	`строка`		Значение параметра. Используется только Скрипт элементами данных.
value map		-			Преобразование значений.
	name	x	`строка`		Имя преобразования значений, которое используется элементом данных.
preprocessing		-			Корневой элемент предварительной обработки элемента данных.
step		-			Отдельный шаг предварительной обработки значений элемента данных.
	type	x	`строка`	1 - MULTIPLIER 2 - RTRIM 3 - LTRIM 4 - TRIM 5 - REGEX 6 - BOOL_TO_DECIMAL 7 - OCTAL_TO_DECIMAL 8 - HEX_TO_DECIMAL 9 - SIMPLE_CHANGE (вычисляется как (полученное значение-предыдущее значение)) 10 - CHANGE_PER_SECOND (вычисляется как (полученное значение-предыдущее значение)/(текущее время-время последней проверки)) 11 - XMLPATH 12 - JSONPATH 13 - IN_RANGE 14 - MATCHES_REGEX 15 - NOT_MATCHES_REGEX 16 - CHECK_JSON_ERROR 17 - CHECK_XML_ERROR 18 - CHECK_REGEX_ERROR 19 - DISCARD_UNCHANGED 20 - DISCARD_UNCHANGED_HEARTBEAT 21 - JAVASCRIPT 22 - PROMETHEUS_PATTERN 23 - PROMETHEUS_TO_JSON 24 - CSV_TO_JSON 25 - STR_REPLACE 26 - CHECK_NOT_SUPPORTED	Тип шага предварительной обработки значений элемента данных.
	parameters	-			Корневой элемент параметров шага предварительной обработки значений элемента данных.
	parameter	x	`строка`		Конкретный параметр шага предварительной обработки значений элемента данных.
	error_handler	-	`строка`	0 - ORIGINAL_ERROR (по умолчанию) 1 - DISCARD_VALUE 2 - CUSTOM_VALUE 3 - CUSTOM_ERROR	Тип действия, используемого в случае ошибки на шаге предварительной обработки.
	error_handler_params	-	`строка`		Параметры обработки ошибки, используемой с 'error_handler'.
master_item		-			Конкретный элемент основного элемента данных. Требуется зависимым элементам данных.
	key	x	`строка`		Значение ключа основного элемента данных зависимого элемента данных. Допускается рекурсия до 3 зависимых элементов данных и максимальное количество зависимых элементов данных равно 29999.
triggers		-			Корневой элемент простых триггеров.
	Для значений тегов элементов триггеров смотрите теги триггеров шаблонов.
tags		-			Корневой элемент тегов элемента данных.
	tag	x	`строка`		Имя тега.
	value	-	`строка`		Значение тега.

Шаги предобработки значений элементов данных шаблона

Элемент		Тип	Описание
type		строка	(обязательный) Тип шага предобработки значения элемента данных. Возможные значения:¹ MULTIPLIER (1), RTRIM (2), LTRIM (3), TRIM (4), REGEX (5), BOOL_TO_DECIMAL (6), OCTAL_TO_DECIMAL (7), HEX_TO_DECIMAL (8), SIMPLE_CHANGE (9, вычисляется как: (полученное значение-предыдущее значение), CHANGE_PER_SECOND (10, вычисляется как: (полученное значение-предыдущее значение)/(текущее время-время последней проверки)), XMLPATH (11), JSONPATH (12), IN_RANGE (13), MATCHES_REGEX (14), NOT_MATCHES_REGEX (15), CHECK_JSON_ERROR (16), CHECK_XML_ERROR (17), CHECK_REGEX_ERROR (18), DISCARD_UNCHANGED (19), DISCARD_UNCHANGED_HEARTBEAT (20), JAVASCRIPT (21), PROMETHEUS_PATTERN (22), PROMETHEUS_TO_JSON (23), CSV_TO_JSON (24), STR_REPLACE (25), CHECK_NOT_SUPPORTED (26), XML_TO_JSON (27), SNMP_WALK_VALUE (28), SNMP_WALK_TO_JSON (29), SNMP_GET_VALUE (30).
parameters			(обязательный) Корневой элемент для параметров шага предобработки значения элемента данных.
	parameter	строка	Конкретный параметр шага предобработки значений элемента данных.
error_handler		строка	Тип действия, используемого в случае ошибки на шаге предобработки. Возможные значения:¹ ORIGINAL_ERROR (0, по умолчанию), DISCARD_VALUE (1), CUSTOM_VALUE (2), CUSTOM_ERROR (3).
error_handler_params		строка	Параметры обработчика ошибок.

Смотрите также: Объект предварительной обработки элемента данных (смотрите на соответствующее свойство с совпадающим именем).

Триггеры элементов данных шаблона

Элемент		Тип	Описание
uuid		строка	(обязательный) Уникальный идентификатор конкретного триггера.
expression		строка	(обязательный) Выражение триггера.
recovery_mode		строка	Основа генерирования ОК событий. Возможные значения:¹ EXPRESSION (0, по умолчанию), RECOVERY_EXPRESSION (1), NONE (2).
recovery_expression		строка	Выражение восстановления триггера.
correlation_mode		строка	Режим корреляции (без корреляции событий или корреляция событий по тегу). Возможные значения:¹ DISABLED (0, по умолчанию), TAG_VALUE (1).
correlation_tag		строка	Имя тега, используемое для корреляции событий.
name		строка	(обязательный) Имя триггера.
event_name		строка	Имя события.
opdata		строка	Оперативные данные.
url_name		строка	Метка для URL, связанного с триггером.
url		строка	URL, связанный с триггером.
status		строка	Состояние триггера. Возможные значения:¹ ENABLED (0, по умолчанию), DISABLED (1).
priority		строка	Важность триггера. Возможные значения:¹ NOT_CLASSIFIED (0, по умолчанию), INFO (1), WARNING (2), AVERAGE (3), HIGH (4), DISASTER (5).
description		текст	Описание триггера.
type		строка	Тип формирования событий (одиночное событие о проблеме или множественные события о проблемах). Возможные значения:¹ SINGLE (0, по умолчанию), MULTIPLE (1).
manual_close		строка	Ручное закрытие событий о проблемах. Возможные значения:¹ NO (0, по умолчанию), YES (1).
dependencies			Корневой элемент для зависимостей.
	name	строка	(обязательный) Имя триггера, от которого имеется зависимость.
	expression	строка	(обязательный) Выражение триггера, от которого имеется зависимость.
	recovery_expression	строка	Выражение восстановления триггера, от которого имеется зависимость.
tags			Корневой элемент для тегов триггера.
	tag	строка	(обязательный) Имя тега.
	value	строка	Значение тега.

Смотрите также: Объект триггера (смотрите соответствующее свойство с совпадающим именем).

Правила низкоуровневого обнаружения шаблона

Большинство элементов правил низкоуровневого обнаружения шаблона такие же, как для элементов данных шаблона. В таблице ниже описаны те элементы, которые отличаются от элементов данных шаблона.

Element		Type	Description
type		строка	Тип элемента данных. Возможные значения:¹ ZABBIX_PASSIVE (0, по умолчанию), TRAP (2), SIMPLE (3), INTERNAL (5), ZABBIX_ACTIVE (7), EXTERNAL (10), ODBC (11), IPMI (12), SSH (13), TELNET (14), JMX (16), DEPENDENT (18), HTTP_AGENT (19), SNMP_AGENT (20), ITEM_TYPE_SCRIPT (21), ITEM_TYPE_BROWSER (22).
key		строка	(обязательный) Ключ правила низкоуровневого обнаружения.
filter			Корневой элемент для фильтров правил низкоуровневого обнаружения шаблона.
lifetime		строка	Период времени (используя секунды, единицы времени с суффиксом или пользовательский макрос), после которого элементы данных, которые более не обнаруживаются, будут удалены. По умолчанию: 7d.
lifetime_type		строка	Сценарий удаления потерянных ресурсов LLD. Возможные значения: DELETE_NEVER, DELETE_IMMEDIATELY, DELETE_AFTER.
enabled_lifetime		строка	Период времени (используя секунды, единицы времени с суффиксом или пользовательский макрос), после которого элементы данных, которые более не обнаруживаются, будут деактивированы.
enabled_lifetime_type		строка	Сценарий деактивации потерянных ресурсов LLD. Возможные значения: DISABLE_NEVER, DISABLE_IMMEDIATELY, DISABLE_AFTER.
item_prototypes			Корневой элемент для прототипов элементов данных шаблона, которые такие же, как для элементов данных шаблона.
trigger_prototypes			Корневой элемент для прототипов триггеров шаблона, которые такие же, как для триггеры элементов данных шаблона.
graph_prototypes			Корневой элемент для прототипов триггеров шаблона, которые такие же, как для графиков узла сети.
host_prototypes			Корневой элемент для прототипов узлов сети шаблона, которые такие же, как для узлов сети.
master_item		строка	(обязательный для DEPENDENT правил) Корневой элемент для основного элемента данных зависимых правил.
lld_macro_paths			Корневой элемент для путей макросов правила низкоуровневого обнаружения.
	lld_macro	строка	(обязательный) Имя макроса правила низкоуровневого обнаружения.
	path	string	(обязательный) Селектор для значения, которое будет назначено соответствующему макросу.
preprocessing			Корневой элемент для предобработки значения правила низкоуровневого обнаружения.
	step		Корневой элемент для элементов шага предобработки значения правила низкоуровневого обнаружения, которые такие же, как для шагов предобработки значений элементов данных шаблона, за исключением меньшего количества возможных значений. Смотрите также: объект предобработки правила LLD.
overrides			Корневой элемент для правил замещения правила низкоуровневого обнаружения.
	name	строка	(обязательный) Уникальное имя замещения.
	step	строка	(обязательный) Уникальный порядковый номер замещения.
	stop	строка	Остановить обработку следующих замещений при совпадении.
	filter		Корневой элемент для элементов фильтра замещения правила низкоуровневого обнаружения шаблона, которые такие же, как для фильтров правил низкоуровневого обнаружения шаблона.
	operations		Корневой элемент для операций замещения правила низкоуровневого обнаружения шаблона.

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

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

Элемент		Тип	Описание
evaltype		строка	Способ вычисления условия фильтра замещения. Возможные значения:¹ AND_OR (0, по умолчанию), AND (1), OR (2), FORMULA (3).
formula		строка	Пользовательская формула вычисления для условий фильтра.
conditions			Корневой элемент для условий фильтра.
	macro	строка	(обязательный) Имя макроса низкоуровневого обнаружения для выполнения проверки.
	value	строка	Значение для сравнения.
	operator	строка	Оператор условия. Возможные значения:¹ MATCHES_REGEX (8, по умолчанию), NOT_MATCHES_REGEX (9).
	formulaid	строка	(обязательный) Произвольный уникальный идентификатор, который используется для ссылки на условие из пользовательского выражения. Может содержать только заглавные буквы. Идентификатор должен быть определён пользователем при изменении условий фильтра, но будет сгенерирован заново при последующем запросе.

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

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

Элемент		Тип	Описание
operationobject		строка	Объект, к которому применяется операция. Возможные значения:¹ ITEM_PROTOTYPE (0), TRIGGER_PROTOTYPE (1), GRAPH_PROTOTYPE (2), HOST_PROTOTYPE (3).
operator		строка	Оператор условия замещения. Возможные значения:¹ EQUAL (1), NOT_EQUAL (2), LIKE (3), NOT_LIKE (4), REGEXP (5), NOT_REGEXP (6).
value		строка	Регулярное выражение или строка для оператора условия замещения.
status		строка	Состояние объекта при операции замещения.
discover		строка	Добавляется ли объект в результате обнаружения.
delay		строка	Интервал обновления, установленный для прототипа элемента данных при операции замещения.
history		строка	Период хранения истории, установленный для прототипа элемента данных при операции замещения.
trends		строка	Период хранения динамики изменений, установленный для прототипа элемента данных при операции замещения.
severity		строка	Важность прототипа триггера, установленная при операции замещения.
tags			Корневой элемент для тегов, установленных для объекта при операции замещения.
	tag	строка	(обязательный) Имя тега.
	value	строка	Значение тега.
templates			Корневой элемент для шаблонов, присоединённых к прототипу узла сети при операции замещения.
	name	строка	(обязательный) Имя шаблона.
inventory_mode		строка	Режим инвентаризации прототипа узла сети, установленный при операции замещения.

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

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

Элемент		Тип	Описание
uuid		строка	(обязательный) Уникальный идентификатор конкретного веб-сценария.
name		строка	(обязательный) Имя веб-сценария.
delay		строка	Частота выполнения веб-сценария (используя секунды, единицы времени с суффиксом или пользовательский макрос). По умолчанию: 1m.
attempts		целое число	Количество попыток выполнения шагов веб-сценария. Возможные значения:¹ 1-10 (по умолчанию: 1).
agent		строка	Агент клиента. Zabbix будет притворяться выбранным браузером. Эта опция полезна, когда веб-сайт возвращает разное содержимое для разных браузеров. По умолчанию: Zabbix.
http_proxy		строка	Укажите используемый HTTP прокси, используя следующий формат: `http://[имя пользователя[:пароль]@]прокси.example.com[:порт]`
variables			Корневой элемент для переменных уровня сценария, которые могут использоваться в шагах сценария.
	name	строка	(обязательный) Имя переменной.
	value	текст	(обязательный) Значение переменной.
headers			Корневой элемент для HTTP заголовков, которые будут отправлены при выполнении запроса. Заголовки нужно перечислять с использованием такого же синтаксиса, что и в HTTP протоколе.
	name	строка	(обязательный) Имя заголовка.
	value	текст	(обязательный) Значение заголовка.
status		строка	Состояние веб-сценария. Возможные значения:¹ ENABLED (0, по умолчанию), DISABLED (1).
authentication		строка	Метод аутентификации. Возможные значения:¹ NONE (0, по умолчанию), BASIC (1), NTLM (2).
http_user		строка	Имя пользователя для простой (BASIC HTTP) или NTLM аутентификации.
http_password		строка	Пароль для для простой (BASIC HTTP) или NTLM аутентификации.
verify_peer		строка	Проверка SSL сертификата веб-сервера. Возможные значения:¹ NO (0, по умолчанию), YES (1).
verify_host		строка	Проверка, что поле Общее Имя (Common Name) или поле Дополнительное Имя Субъекта (Subject Alternate Name) сертификата веб-сервера совпадают. Возможные значения:¹ NO (0, по умолчанию), YES (1).
ssl_cert_file		строка	Имя используемого файла SSL сертификата для аутентификации клиента (должен быть в формате PEM).
ssl_key_file		строка	Имя используемого файла закрытого ключа (private key) SSL для аутентификации клиента (должен быть в формате PEM).
ssl_key_password		строка	Пароль к файлу закрытого ключа (private key) SSL.
steps			(обязательный) Корневой элемент для шагов веб-сценария шаблона.
tags			Корневой элемент тегов веб-сценария.
	tag	строка	(обязательный) Имя тега.
	value	строка	Значение тега.

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

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

Элемент		Тип	Описание
name		строка	(обязательный) Имя шага веб-сценария.
url		строка	(обязательный) URL для мониторинга.
query_fields			Корневой элемент для параметров запроса (массив полей HTTP, которые будут добавлены к URL при выполнении запроса).
	name	строка	(обязательный) Имя параметра запроса.
	value	строка	Значение параметра запроса.
posts			Корневой элемент для переменных HTTP POST (строка (необработанные post данные) или массив полей HTTP (данные полей формы)).
	name	строка	(обязательный) Имя поля post.
	value	строка	(обязательный) Значение поля post.
variables			Корневой элемент переменных (макросов) уровня шага, которые следует применить после этого шага. Если значение переменной имеет префикс «regex:», то её значение извлекается из данных, возвращаемых этим шагом в соответствии с шаблоном регулярного выражения, следующим за префиксом «regex:».
	name	строка	(обязательный) Имя переменной.
	value	текст	(обязательный) Значение переменной.
headers			Корневой элемент для заголовков HTTP, которые будут отправлены при выполнении запроса.
	name	строка	(обязательный) Имя заголовка.
	value	текст	(обязательный) Значение заголовка.
follow_redirects		строка	Следовать перенаправлениям HTTP. Возможные значения:¹ NO (0), YES (1, по умолчанию).
retrieve_mode		строка	Режим получения ответа HTTP. Возможные значения:¹ BODY (0, по умолчанию), HEADERS (1), BOTH (2).
timeout		строка	Таймаут (используя секунды, единицы времени с суффиксом или пользовательский макрос) шага выполнения. По умолчанию: 15s.
required		строка	Текст, который должен присутствовать в ответе (игнорируется, если пусто).
status_codes		строка	Список (через запятую) принимаемых кодов состояния HTTP (например: `200-201,210-299`; игнорируется, если пусто).

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

Панели шаблона

Элемент		Тип	Описание
uuid		строка	(обязательный) Уникальный идентификатор конкретной панели.
name		строка	(обязательный) Имя панели шаблона.
display period		целое число	Период отображения страниц панели.
auto_start		строка	Автоматический запуск слайд-шоу. Возможные значения:¹ NO (0), YES (1, по умолчанию).
pages			Корневой элемент для страниц панели шаблона.
	name	строка	Имя страницы.
	display period	целое число	Период отображения страницы.
	sortorder	целое число	Порядок сортировки страниц.
widgets			Корневой элемент для виджетов панели шаблона.

Смотрите также: Объект панели шаблона (смотрите соответствующее свойство с совпадающим именем).

Виджеты панели шаблона

Элемент		Тип	Описание
type		строка	(обязательный) Тип виджета.
name		строка	Имя виджета.
x		целое число	Позиция по горионтали от левого края панели шаблона. Возможные значения:¹ 0-71.
y		целое число	Позиция по вертикали от верхнего края панели шаблона. Возможные значения:¹ 0-63.
width		целое число	Ширина виджета. Возможные значения:¹ 1-72.
height		целое число	Высота виджета. Возможные значения:¹ 1-64.
hide_header		строка	Скрывать заголовок виджета. Возможные значения:¹ NO (0, по умолчанию), YES (1).
fields			Корневой элемент для полей виджета панели шаблона.
	type	строка	(обязательный) Тип поля виджета. Возможные значения:¹ ЦЕЛОЕ_ЧИСЛО (0), СТРОКА (1), ЭЛЕМЕНТ ДАННЫХ (4), ПРОТОТИП_ЭЛЕМЕНТОВ_ДАННЫХ (5), ГРАФИК (6), ПРОТОТИП_ГРАФИКОВ (7), КАРТА (8), УСЛУГА (9), SLA (10), ПОЛЬЗОВАТЕЛЬ (11), ДЕЙСТВИЕ (12), СПОСОБ_УВЕДОМЛЕНИЙ (13).
	name	строка	(обязательный) Имя поля виджета.
	value	смешанный	(обязательный) Значение поля виджета, в зависимости от типа поля.

Смотрите также: Объект виджета панели шаблона (смотрите соответствующее свойство с совпадающим именем).

Преобразования значений шаблона

Элемент		Тип	Описание
uuid		строка	(обязательный) Уникальный идентификатор для конкретного преобразования значений.
name		строка	(обязательный) Имя преобразования значений.
mapping			Корневой элемент для преобразований.
	type	строка	Тип сопоставления преобразования. Возможные значения:¹ EQUAL (0, по умолчанию), GREATER_OR_EQUAL (2), LESS_OR_EQUAL (3), IN_RANGE (4), REGEXP (5), DEFAULT (6).
	value	строка	Исходное значение.
	newvalue	строка	(обязательный) Значение, на которое отображается исходное значение.

Смотрите также: Объект преобразований значений (смотрите соответствующее свойство с совпадающим именем).

Примечания

¹ Целочисленные значения API в скобках, например, ENABLED (0), упоминаются только для справки. Для получения дополнительной информации смотрите связанную страницу объекта API в записи таблицы или в конце каждого раздела.

Documentation