3. Шаблоны

Обзор

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

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

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

Экспорт

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

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

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

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

Импорт

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

  1. Перейдите в: Сбор данныхШаблоны (Data collectionTemplates)
  2. Нажмите на Импорт (Import) в правом верхнем углу
  3. Выберите импортируемый файл
  4. Нажмите на Импорт (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 строка Тип пользовательского макроса.
Возможные значения:1 TEXT (0, по умолчанию), SECRET_TEXT (1), VAULT (2).
Смотрите также: Объект пользовательского макроса (Тип).
value строка Значение пользовательского макроса.
description строка Описание пользовательского макроса.
dashboards Корневой элемент для панелей шаблона.
valuemaps Корневой элемент для преобразований значений шаблона.

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

Элемент Тип Описание
uuid строка (обязательный) Уникальный идентификатор элемента данных.
name строка (обязательный) Имя элемента данных.
type строка Тип элемента данных.
Возможные значения:1 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 строка Состояние элемента данных.
Возможные значения:1 ENABLED (0, по умолчанию), DISABLED (1).
value_type строка Тип получаемого значения.
Возможные значения:1 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:1 PASSWORD (0, по умолчанию), PUBLIC_KEY (1).
Возможные значения для элементов данных HTTP агент:1 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 строка Поле инвентарных данных, которое заполняется элементом данных.
Возможные значения:1 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 агент.
Возможные значения:1 NO (0), YES (1, по умолчанию).
post_type строка Тип тела post данных.
Поддерживается для элементов данных с типом HTTP агент.
Возможные значения:1 RAW (0, по умолчанию), JSON (2), XML (3).
http_proxy строка Строка подключения к HTTP(S) прокси.
Поддерживается для элементов данных с типом HTTP агент.
headers Корневой элемент для заголовков запросов HTTP(S).
Поддерживается для элементов данных с типом HTTP агент.
name строка (обязателен для элементов данных HTTP агент) Имя заголовка.
value строка (обязателен для элементов данных HTTP агент) Значение заголовка.
retrieve_mode строка Какую часть ответа нужно сохранять.
Поддерживается для элементов данных с типом HTTP агент.
Возможные значения:1 BODY (0, по умолчанию), HEADERS (1), BOTH (2).
request_method строка Метод запроса.
Поддерживается для элементов данных с типом HTTP агент.
Возможные значения:1 GET (0, по умолчанию), POST (1), PUT (2), HEAD (3).
output_format строка Каким образом обрабатывать ответ.
Поддерживается для элементов данных с типом HTTP агент.
Возможные значения:1 RAW (0, по умолчанию), JSON (1).
allow_traps строка Разрешение заполнять значения аналогично элементу данных с типом траппер.
Поддерживается для элементов данных с типом HTTP агент.
Возможные значения:1 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 агент.
Возможные значения:1 NO (0, по умолчанию), YES (1).
verify_host строка Следует ли проверять, что имя хоста для соединения совпадает с именем в сертификате хоста.
Поддерживается для элементов данных с типом HTTP агент.
Возможные значения:1 NO (0, по умолчанию), YES (1).
tags Корневой элемент для тегов элемента данных.
tag строка (обязательный) Имя тега.
value строка Значение тега.
triggers Корневой элемент для триггеров элементов данных шаблона.

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

Шаги предобработки значений элементов данных шаблона
Элемент Тип Описание
type строка (обязательный) Тип шага предобработки значения элемента данных.
Возможные значения:1 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 строка Тип действия, используемого в случае ошибки на шаге предобработки.
Возможные значения:1 ORIGINAL_ERROR (0, по умолчанию), DISCARD_VALUE (1), CUSTOM_VALUE (2), CUSTOM_ERROR (3).
error_handler_params строка Параметры обработчика ошибок.

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

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

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

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

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

Element Type Description
type строка Тип элемента данных.
Возможные значения:1 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 строка Способ вычисления условия фильтра замещения.
Возможные значения:1 AND_OR (0, по умолчанию), AND (1), OR (2), FORMULA (3).
formula строка Пользовательская формула вычисления для условий фильтра.
conditions Корневой элемент для условий фильтра.
macro строка (обязательный) Имя макроса низкоуровневого обнаружения для выполнения проверки.
value строка Значение для сравнения.
operator строка Оператор условия.
Возможные значения:1 MATCHES_REGEX (8, по умолчанию), NOT_MATCHES_REGEX (9).
formulaid строка (обязательный) Произвольный уникальный идентификатор, который используется для ссылки на условие из пользовательского выражения. Может содержать только заглавные буквы. Идентификатор должен быть определён пользователем при изменении условий фильтра, но будет сгенерирован заново при последующем запросе.

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

Операции замещения правил низкоуровневого обнаружения шаблона
Элемент Тип Описание
operationobject строка Объект, к которому применяется операция.
Возможные значения:1 ITEM_PROTOTYPE (0), TRIGGER_PROTOTYPE (1), GRAPH_PROTOTYPE (2), HOST_PROTOTYPE (3).
operator строка Оператор условия замещения.
Возможные значения:1 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 1-10 (по умолчанию: 1).
agent строка Агент клиента. Zabbix будет притворяться выбранным браузером.
Эта опция полезна, когда веб-сайт возвращает разное содержимое для разных браузеров.
По умолчанию: Zabbix.
http_proxy строка Укажите используемый HTTP прокси, используя следующий формат: http://[имя пользователя[:пароль]@]прокси.example.com[:порт]
variables Корневой элемент для переменных уровня сценария, которые могут использоваться в шагах сценария.
name строка (обязательный) Имя переменной.
value текст (обязательный) Значение переменной.
headers Корневой элемент для HTTP заголовков, которые будут отправлены при выполнении запроса.
Заголовки нужно перечислять с использованием такого же синтаксиса, что и в HTTP протоколе.
name строка (обязательный) Имя заголовка.
value текст (обязательный) Значение заголовка.
status строка Состояние веб-сценария.
Возможные значения:1 ENABLED (0, по умолчанию), DISABLED (1).
authentication строка Метод аутентификации.
Возможные значения:1 NONE (0, по умолчанию), BASIC (1), NTLM (2).
http_user строка Имя пользователя для простой (BASIC HTTP) или NTLM аутентификации.
http_password строка Пароль для для простой (BASIC HTTP) или NTLM аутентификации.
verify_peer строка Проверка SSL сертификата веб-сервера.
Возможные значения:1 NO (0, по умолчанию), YES (1).
verify_host строка Проверка, что поле Общее Имя (Common Name) или поле Дополнительное Имя Субъекта (Subject Alternate Name) сертификата веб-сервера совпадают.
Возможные значения:1 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.
Возможные значения:1 NO (0), YES (1, по умолчанию).
retrieve_mode строка Режим получения ответа HTTP.
Возможные значения:1 BODY (0, по умолчанию), HEADERS (1), BOTH (2).
timeout строка Таймаут (используя секунды, единицы времени с суффиксом или пользовательский макрос) шага выполнения.
По умолчанию: 15s.
required строка Текст, который должен присутствовать в ответе (игнорируется, если пусто).
status_codes строка Список (через запятую) принимаемых кодов состояния HTTP (например: 200-201,210-299; игнорируется, если пусто).

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

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

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

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

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

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

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

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

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

Примечания

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