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			Корневой элемент для преобразований значений шаблона.

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

Элемент		Тип	Описание
uuid		строка	(обязательный) Уникальный идентификатор элемента данных.
name		строка	(обязательный) Имя элемента данных.
type		строка	Тип элемента данных. Возможные значения:¹ ZABBIX_PASSIVE (0, по умолчанию), TRAP (2), SIMPLE (3), INTERNAL (5), ZABBIX_ACTIVE (7), EXTERNAL (10), ODBC (11), IPMI (12), SSH (13), TELNET (14), CALCULATED (15), JMX (16), SNMP_TRAP (17), DEPENDENT (18), HTTP_AGENT (19), SNMP_AGENT (20), ITEM_TYPE_SCRIPT (21), ITEM_TYPE_BROWSER (22).
snmp_oid		строка	(обязателен для элементов данных SNMP агент) Идентификатор объекта SNMP.
key		строка	(обязательный) Ключ элемента данных.
delay		строка	Интервал обновления элемента данных. по умолчанию: 1m. Для элементов данных с типом TRAP значение всегда будет 0.
history		строка	Период времени (используя единицы времени с суффиксом, пользовательский макрос или LLD макрос), как долго хранить данные истории. По умолчанию: 31d.
trends		строка	Период времени (используя единицы времени с суффиксом, пользовательский макрос или LLD макрос), как долго хранить данные динамики изменений. По умолчанию: 365d.
status		строка	Состояние элемента данных. Возможные значения:¹ ENABLED (0, по умолчанию), DISABLED (1).
value_type		строка	Тип получаемого значения. Возможные значения:¹ FLOAT (0), CHAR (1), LOG (2), UNSIGNED (3, по умолчанию), TEXT (4), BINARY (5).
allowed_hosts		строка	Список (через запятую) IP адресов узлов сети, с которых разрешена отправка данных на элемент данных. Поддерживается для элементов данных с типами траппер и HTTP агент.
units		строка	Единицы измерений получаемых значений (bps, B и т.п.).
params		текст	Дополнительные параметры, в зависимости от типа элемента данных (выполняемый скрипт для элементов данных с типами SSH и Telnet; SQL запрос для элементов данных с типом монитор баз данных; формула для вычисляемых элементов данных; скрипт для элементов данных с типами скрипт и браузер).
ipmi_sensor		строка	IPMI сенсор. Поддерживается для элементов данных IPMI.
authtype		строка	Тип аутентификации. Поддерживается для элементов данных SSH и HTTP агент. Возможные значения для элементов данных SSH:¹ PASSWORD (0, по умолчанию), PUBLIC_KEY (1). Возможные значения для элементов данных HTTP агент:¹ NONE (0, по умолчанию), BASIC (1), NTLM (2).
username		строка	(обязателен для элементов данных SSH и Telnet) Имя пользователя для аутентификации. Поддерживается для элементов данных с типами простая проверка, монитор баз данных, JMX и HTTP агент. При использовании с JMX агентом пароль (`password`, см. ниже) также должен быть указан, или оба свойства должны быть пустыми.
password		строка	(обязателен для элементов данных SSH и Telnet) Пароль для аутентификации. Поддерживается для элементов данных с типами простая проверка, монитор баз данных, JMX и HTTP агент. При использовании с JMX агентом имя пользователя (`username`, см. выше) также должен быть указан, или оба свойства должны быть пустыми.
publickey		строка	(обязателен для элементов данных SSH) Имя файла открытого ключа (public key).
privatekey		строка	(обязателен для элементов данных SSH) Имя файла закрытого ключа (private key).
description		текст	Описание элемента данных.
inventory_link		строка	Поле инвентарных данных, которое заполняется элементом данных. Возможные значения:¹ NONE (0), ALIAS (4) и т.д. (Обратитесь к странице инвентарных данных узлов сети для получения списка поддерживаемых полей).
valuemap			Корневой элемент для преобразования значений элемента данных.
	name	строка	(обязательный) Имя преобразования значений, которое используется элементом данных.
logtimefmt		строка	Формат времени в записях в журнале. Поддерживается только для элементов данных с типом журнал (лог).
preprocessing			Корневой элемент для предварительной обработки значений элемента данных.
	step		Корневой элемент для шагов предварительной обработки значений элемента данных шаблона.
jmx_endpoint		строка	JMX endpoint. Поддерживается для элементов данных с типом JMX агент.
master_item			(обязателен для зависимых элементов данных) Корневой элемент для основного элемента данных.
	key	строка	(обязательный) Ключ основного элемента данных для зависимого элемента данных.
timeout		строка	Время ожидания при выполнении запроса данных элемента данных. Поддерживается для списка типов элементов данных, имеющих тайм-ауты.
url		строка	(обязателен для элементов данных HTTP агент) Строка URL.
query_fields			Корневой элемент для параметров запроса. Поддерживается для элементов данных с типом HTTP агент.
	name	строка	(обязателен для элементов данных HTTP агент) Имя параметра.
	value	строка	Значение параметра запроса. Поддерживается для элементов данных с типом HTTP агент.
parameters			Корневой элемент для пользовательских параметров. Поддерживается для элементов данных с типами скрипт и браузер.
	name	строка	(обязателен для элементов данных скрипт и браузер) Имя пользовательского параметра.
	value	строка	Значение пользовательского параметра. Поддерживается для элементов данных с типами скрипт и браузер.
posts		строка	Данные тела HTTP(S) запроса. Поддерживается для элементов данных с типом HTTP агент.
status_codes		строка	Диапазоны требуемых кодов HTTP состояний, разделённые запятыми. Поддерживается для элементов данных с типом HTTP агент.
follow_redirects		строка	Следование перенаправлениям HTTP ответа при опросе данных. Поддерживается для элементов данных с типом HTTP агент. Возможные значения:¹ NO (0), YES (1, по умолчанию).
post_type		строка	Тип тела post данных. Поддерживается для элементов данных с типом HTTP агент. Возможные значения:¹ RAW (0, по умолчанию), JSON (2), XML (3).
http_proxy		строка	Строка подключения к HTTP(S) прокси. Поддерживается для элементов данных с типом HTTP агент.
headers			Корневой элемент для заголовков запросов HTTP(S). Поддерживается для элементов данных с типом HTTP агент.
	name	строка	(обязателен для элементов данных HTTP агент) Имя заголовка.
	value	строка	(обязателен для элементов данных HTTP агент) Значение заголовка.
retrieve_mode		строка	Какую часть ответа нужно сохранять. Поддерживается для элементов данных с типом HTTP агент. Возможные значения:¹ BODY (0, по умолчанию), HEADERS (1), BOTH (2).
request_method		строка	Метод запроса. Поддерживается для элементов данных с типом HTTP агент. Возможные значения:¹ GET (0, по умолчанию), POST (1), PUT (2), HEAD (3).
output_format		строка	Каким образом обрабатывать ответ. Поддерживается для элементов данных с типом HTTP агент. Возможные значения:¹ RAW (0, по умолчанию), JSON (1).
allow_traps		строка	Разрешение заполнять значения аналогично элементу данных с типом траппер. Поддерживается для элементов данных с типом HTTP агент. Возможные значения:¹ NO (0, по умолчанию), YES (1).
ssl_cert_file		строка	Путь к файлу открытого ключа (public key) SSL. Поддерживается для элементов данных с типом HTTP агент.
ssl_key_file		строка	Путь к файлу закрытого ключа (private key) SSL. Поддерживается для элементов данных с типом HTTP агент.
ssl_key_password		строка	Пароль к файлу SSL ключа. Поддерживается для элементов данных с типом HTTP агент.
verify_peer		строка	Следует ли проверять подлинность сертификата хоста. Поддерживается для элементов данных с типом HTTP агент. Возможные значения:¹ NO (0, по умолчанию), YES (1).
verify_host		строка	Следует ли проверять, что имя хоста для соединения совпадает с именем в сертификате хоста. Поддерживается для элементов данных с типом HTTP агент. Возможные значения:¹ NO (0, по умолчанию), YES (1).
tags			Корневой элемент для тегов элемента данных.
	tag	строка	(обязательный) Имя тега.
	value	строка	Значение тега.
triggers			Корневой элемент для триггеров элементов данных шаблона.

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

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

Элемент		Тип	Описание
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