- Объект правила LLD
- Правило LLD
- Фильтр правила LLD
- Путь макроса LLD
- Предобработка правила LLD
- Переопределения правил LLD
- Фильтр переопределения правила LLD
- Операция переопределения правила LLD
- Статус операции переопределения правила LLD
- Обнаружение операции переопределения правила LLD
- Период операции переопределения правила LLD
- История операции переопределения правила LLD
- Тренды операции переопределения правила LLD
- Серьезность операции переопределения правила LLD
- Тег операции переопределения правила LLD
- Шаблон операции переопределения правила LLD
- Значение режима инвентаризации операции переопределения правила LLD
Объект правила LLD
Следующие объекты напрямую связаны с API discoveryrule.
Правило LLD
Объект правила низкоуровневого обнаружения имеет следующие свойства.
| Свойство | Тип | Описание |
|---|---|---|
| itemid | ID | ID правила LLD. Поведение свойства: - только для чтения - обязательно для операций обновления |
| delay | string | Интервал обновления правила LLD. Принимает секунды или единицу времени с суффиксом (например, 30s, 1m, 2h, 1d) и, при необходимости, один или несколько пользовательских интервалов, разделенных точкой с запятой. Пользовательские интервалы могут представлять собой сочетание гибких интервалов и интервалов по расписанию. Поддерживает пользовательские макросы. Если они используются, значение должно быть одним макросом. Несколько макросов или макросы, смешанные с текстом, не поддерживаются. Гибкие интервалы могут быть записаны как два макроса, разделенные косой чертой (например, {$FLEX_INTERVAL}/{$FLEX_PERIOD}).Пример: 1h;wd1-5h9-18;{$Macro1}/1-7,00:00-24:00;0/6-7,12:00-24:00;{$Macro2}/{$Macro3}Поведение свойства: - обязательно, если type установлено в "Zabbix agent" (0), "Simple check" (3), "Zabbix internal" (5), "External check" (10), "Database monitor" (11), "IPMI agent" (12), "SSH agent" (13), "TELNET agent" (14), "JMX agent" (16), "HTTP agent" (19), "SNMP agent" (20), "Script" (21), "Browser" (22), или если type установлено в "Zabbix agent (active)" (7) и key_ не содержит "mqtt.get" |
| hostid | ID | ID узла сети, которому принадлежит правило LLD. Поведение свойства: - константа - обязательно для операций создания |
| flags | integer | Происхождение правила обнаружения. Возможные значения: 1 - правило низкоуровневого обнаружения; 5 - правило низкоуровневого обнаружения, преобразованное из прототипа. Поведение свойства: - только для чтения |
| interfaceid | ID | ID интерфейса узла сети для правила LLD. Поведение свойства: - обязательно, если правило LLD принадлежит узлу сети и type установлено в "Zabbix agent", "IPMI agent", "JMX agent" или "SNMP agent"- поддерживается, если правило LLD принадлежит узлу сети и type установлено в "Simple check", "External check", "SSH agent", "TELNET agent" или "HTTP agent" |
| key_ | string | Ключ правила LLD. Поведение свойства: - обязательно для операций создания - только для чтения для унаследованных объектов |
| name | string | Имя правила LLD. Поведение свойства: - обязательно для операций создания - только для чтения для унаследованных объектов |
| type | integer | Тип правила LLD. Возможные значения: 0 - Zabbix агент; 2 - Zabbix trapper; 3 - Простая проверка; 5 - Внутренний элемент Zabbix; 7 - Zabbix агент (активный); 10 - Внешняя проверка; 11 - Монитор базы данных; 12 - IPMI агент; 13 - SSH агент; 14 - TELNET агент; 16 - JMX агент; 18 - Зависимый элемент данных; 19 - HTTP агент; 20 - SNMP агент; 21 - Скрипт; 22 - Браузер; 23 - Вложенный. Этот тип разрешен только если родительским объектом правила является шаблон (предполагается, что он будет связан с прототипом узла сети при обнаружении) или обнаруженный узел сети (у которого правило LLD находится в корне). Поведение свойства: - обязательно для операций создания - только для чтения для унаследованных объектов |
| url | string | Строка URL. Поддерживает пользовательские макросы, {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {HOST.PORT}, {ITEM.ID}, {ITEM.KEY}. Поведение свойства: - обязательно, если type установлено в "HTTP agent"- только для чтения для унаследованных объектов |
| allow_traps | integer | Разрешить заполнение значения аналогично элементу данных trapper. Возможные значения: 0 - (по умолчанию) Не разрешать прием входящих данных; 1 - Разрешать прием входящих данных. Поведение свойства: - поддерживается, если type установлено в "HTTP agent" |
| authtype | integer | Метод аутентификации. Возможные значения, если type установлено в "SSH agent":0 - (по умолчанию) пароль; 1 - открытый ключ. Возможные значения, если type установлено в "HTTP agent":0 - (по умолчанию) нет; 1 - basic; 2 - NTLM; 3 - Kerberos; 4 - Digest. Поведение свойства: - поддерживается, если type установлено в "SSH agent" или "HTTP agent"- только для чтения для унаследованных объектов (если type установлено в "HTTP agent") |
| description | string | Описание правила LLD. |
| error | string | Текст ошибки, если возникают проблемы при обновлении значения правила LLD. Поведение свойства: - только для чтения |
| follow_redirects | integer | Следовать перенаправлениям ответа при опросе данных. Возможные значения: 0 - Не следовать перенаправлениям; 1 - (по умолчанию) Следовать перенаправлениям. Поведение свойства: - поддерживается, если type установлено в "HTTP agent"- только для чтения для унаследованных объектов |
| headers | array | Массив заголовков, которые будут отправлены при выполнении HTTP-запроса. Поведение свойства: - поддерживается, если type установлено в "HTTP agent"- только для чтения для унаследованных объектов |
| http_proxy | string | Строка подключения к HTTP(S) прокси. Поведение свойства: - поддерживается, если type установлено в "HTTP agent"- только для чтения для унаследованных объектов |
| ipmi_sensor | string | Сенсор IPMI. Поведение свойства: - обязательно, если type установлено в "IPMI agent" и key_ не установлено в "ipmi.get"- поддерживается, если type установлено в "IPMI agent"- только для чтения для унаследованных объектов |
| jmx_endpoint | string | Пользовательская строка подключения JMX агент. По умолчанию: service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT}/jmxrmi Поведение свойства: - поддерживается, если type установлено в "JMX agent" |
| lifetime | string | Период времени, по истечении которого элементы данных, которые больше не обнаруживаются, будут удалены. Принимает секунды, единицу времени с суффиксом или пользовательский макрос. По умолчанию: 7d. |
| lifetime_type | integer | Сценарий удаления потерянных ресурсов LLD. Возможные значения: 0 - (по умолчанию) Удалить после достижения порога lifetime; 1 - Не удалять; 2 - Удалить немедленно. |
| enabled_lifetime | string | Период времени, по истечении которого элементы данных, которые больше не обнаруживаются, будут отключены. Принимает секунды, единицу времени с суффиксом или пользовательский макрос. По умолчанию: 0. |
| enabled_lifetime_type | integer | Сценарий отключения потерянных ресурсов LLD. Возможные значения: 0 - Отключить после достижения порога lifetime; 1 - Не отключать; 2 - (по умолчанию) Отключить немедленно. |
| master_itemid | ID | ID мастер-элемента данных. Правило обнаружения не может быть мастер-элементом данных для другого правила обнаружения. Поведение свойства: - обязательно, если type установлено в "Dependent item"- только для чтения для унаследованных объектов |
| output_format | integer | Следует ли преобразовывать ответ в JSON. Возможные значения: 0 - (по умолчанию) Сохранять как есть; 1 - Преобразовать в JSON. Поведение свойства: - поддерживается, если type установлено в "HTTP agent"- только для чтения для унаследованных объектов |
| params | string | Дополнительные параметры в зависимости от типа правила LLD: - выполняемый скрипт для правил LLD SSH и Telnet; - SQL-запрос для правил LLD монитора базы данных; - формула для вычисляемых правил LLD; - скрипт для правил LLD типа script и browser. Поведение свойства: - обязательно, если type установлено в "Database monitor", "SSH agent", "TELNET agent", "Script" или "Browser"- только для чтения для унаследованных объектов (если type установлено в "Script" или "Browser") |
| parameters | object/array | Дополнительные параметры, если type установлено в "Script" или "Browser".Массив объектов со свойствами name и value, где name должно быть уникальным.Поведение свойства: - поддерживается, если type установлено в "Script" или "Browser"- только для чтения для унаследованных объектов |
| password | string | Пароль для аутентификации. Поведение свойства: - обязательно, если type установлено в "JMX agent" и username задано- поддерживается, если type установлено в "Simple check", "Database monitor", "SSH agent", "TELNET agent" или "HTTP agent"- только для чтения для унаследованных объектов (если type установлено в "HTTP agent") |
| post_type | integer | Тип тела post-данных, хранящихся в свойстве posts.Возможные значения: 0 - (по умолчанию) Необработанные данные; 2 - JSON-данные; 3 - XML-данные. Поведение свойства: - поддерживается, если type установлено в "HTTP agent"- только для чтения для унаследованных объектов |
| posts | string | Данные тела HTTP(S)-запроса. Поведение свойства: - обязательно, если type установлено в "HTTP agent" и post_type установлено в "JSON data" или "XML data"- поддерживается, если type установлено в "HTTP agent" и post_type установлено в "Raw data"- только для чтения для унаследованных объектов |
| privatekey | string | Имя файла закрытого ключа. Поведение свойства: - обязательно, если type установлено в "SSH agent" и authtype установлено в "public key" |
| publickey | string | Имя файла открытого ключа. Поведение свойства: - обязательно, если type установлено в "SSH agent" и authtype установлено в "public key" |
| query_fields | array | Массив полей запроса, которые будут отправлены при выполнении HTTP-запроса. Поведение свойства: - поддерживается, если type установлено в "HTTP agent"- только для чтения для унаследованных объектов |
| request_method | integer | Тип метода запроса. Возможные значения: 0 - (по умолчанию) GET; 1 - POST; 2 - PUT; 3 - HEAD. Поведение свойства: - поддерживается, если type установлено в "HTTP agent"- только для чтения для унаследованных объектов |
| retrieve_mode | integer | Какая часть ответа должна быть сохранена. Возможные значения, если request_method установлено в "GET", "POST" или "PUT":0 - (по умолчанию) Тело; 1 - Заголовки; 2 - Будут сохранены и тело, и заголовки. Возможные значения, если request_method установлено в "HEAD":1 - Заголовки. Поведение свойства: - поддерживается, если type установлено в "HTTP agent"- только для чтения для унаследованных объектов |
| snmp_oid | string | SNMP OID. Поведение свойства: - обязательно, если type установлено в "SNMP agent"- только для чтения для унаследованных объектов |
| ssl_cert_file | string | Путь к файлу открытого SSL-ключа. Поведение свойства: - поддерживается, если type установлено в "HTTP agent"- только для чтения для унаследованных объектов |
| ssl_key_file | string | Путь к файлу закрытого SSL-ключа. Поведение свойства: - поддерживается, если type установлено в "HTTP agent"- только для чтения для унаследованных объектов |
| ssl_key_password | string | Пароль для файла SSL-ключа. Поведение свойства: - поддерживается, если type установлено в "HTTP agent"- только для чтения для унаследованных объектов |
| state | integer | Состояние правила LLD. Возможные значения: 0 - (по умолчанию) нормальное; 1 - не поддерживается. Поведение свойства: - только для чтения |
| status | integer | Статус правила LLD. Возможные значения: 0 - (по умолчанию) включенное правило LLD; 1 - отключенное правило LLD. |
| status_codes | string | Диапазоны требуемых HTTP-кодов состояния, разделенные запятыми. Также поддерживает пользовательские макросы как часть списка, разделенного запятыми. Пример: 200,200-{$M},{$M},200-400 Поведение свойства: - поддерживается, если type установлено в "HTTP agent"- только для чтения для унаследованных объектов |
| templateid | ID | ID родительского правила LLD шаблона. Поведение свойства: - только для чтения |
| timeout | string | Тайм-аут запроса опроса данных элемента данных. Принимает секунды или единицу времени с суффиксом (например, 30s, 1m). Также принимает пользовательские макросы. Диапазон возможных значений: 1-600s. По умолчанию: "" - использовать настройки прокси/глобальные настройки. Поведение свойства: - поддерживается, если type установлено в "Zabbix agent" (0), "Simple check" (3) и key_ не начинается с "vmware." и "icmpping", "Zabbix agent (active)" (7), "External check" (10), "Database monitor" (11), "SSH agent" (13), "TELNET agent" (14), "HTTP agent" (19), "SNMP agent" (20) и snmp_oid начинается с "walk[" или "get[", "Script" (21), "Browser" (22)- только для чтения для унаследованных объектов |
| trapper_hosts | string | Разрешенные узлы сети. Поведение свойства: - поддерживается, если type установлено в "Zabbix trapper", или если type установлено в "HTTP agent" и allow_traps установлено в "Allow to accept incoming data" |
| username | string | Имя пользователя для аутентификации. Поведение свойства: - обязательно, если type установлено в "SSH agent", "TELNET agent", или если type установлено в "JMX agent" и password задано- поддерживается, если type установлено в "Simple check", "Database monitor" или "HTTP agent"- только для чтения для унаследованных объектов (если type установлено в "HTTP agent") |
| uuid | string | Универсальный уникальный идентификатор, используемый для связывания импортированных правил LLD с уже существующими. Генерируется автоматически, если не указан. Поведение свойства: - поддерживается, если правило LLD принадлежит шаблону |
| verify_host | integer | Следует ли проверять, что имя узла сети для подключения совпадает с именем в сертификате узла сети. Возможные значения: 0 - (по умолчанию) Не проверять; 1 - Проверять. Поведение свойства: - поддерживается, если type установлено в "HTTP agent"- только для чтения для унаследованных объектов |
| verify_peer | integer | Следует ли проверять подлинность сертификата узла сети. Возможные значения: 0 - (по умолчанию) Не проверять; 1 - Проверять. Поведение свойства: - поддерживается, если type установлено в "HTTP agent"- только для чтения для унаследованных объектов |
HTTP-заголовок
Объект заголовка имеет следующие свойства:
| Свойство | Тип | Описание |
|---|---|---|
| name | string | Имя HTTP-заголовка. Поведение свойства: - обязательно |
| value | string | Значение заголовка. Поведение свойства: - обязательно |
Поле HTTP-запроса
Объект поля запроса определяет имя и значение, используемые для указания параметра URL. Он имеет следующие свойства:
| Свойство | Тип | Описание |
|---|---|---|
| name | string | Имя параметра. Поведение свойства: - обязательно |
| value | string | Значение параметра. Поведение свойства: - обязательно |
Фильтр правила LLD
Объект фильтра правила LLD определяет набор условий, которые можно использовать для фильтрации обнаруженных объектов. Он имеет следующие свойства:
| Свойство | Тип | Описание |
|---|---|---|
| conditions | object/array | Набор условий фильтра, используемых для фильтрации результатов. Условия будут отсортированы в порядке их размещения в формуле. Поведение свойства: - обязательно |
| evaltype | integer | Метод вычисления условий фильтра. Возможные значения: 0 - And/Or; 1 - And; 2 - Or; 3 - Пользовательское выражение. Поведение свойства: - обязательно |
| eval_formula | string | Сгенерированное выражение, которое будет использоваться для вычисления условий фильтра. Выражение содержит идентификаторы, которые ссылаются на определённые условия фильтра по их formulaid. Значение eval_formula равно значению formula для фильтров с пользовательским выражением.Поведение свойства: - только для чтения |
| formula | string | Определяемое пользователем выражение, используемое для вычисления условий фильтров с пользовательским выражением. Выражение должно содержать идентификаторы, которые ссылаются на определённые условия фильтра по их formulaid. Идентификаторы, используемые в выражении, должны в точности соответствовать идентификаторам, определённым в условиях фильтра: ни одно условие не должно остаться неиспользованным или пропущенным.Поведение свойства: - обязательно, если evaltype установлено в "custom expression" |
Условие фильтра правила LLD
Объект условия фильтра правила LLD определяет отдельную проверку, выполняемую для значения макроса LLD. Он имеет следующие свойства:
| Свойство | Тип | Описание |
|---|---|---|
| macro | string | Макрос LLD, для которого выполняется проверка. Поведение свойства: - обязательно |
| value | string | Значение для сравнения. Поведение свойства: - обязательно, если operator установлен в "совпадает с регулярным выражением" или "не совпадает с регулярным выражением" |
| formulaid | string | Произвольный уникальный идентификатор, используемый для ссылки на условие из пользовательского выражения. Может содержать только заглавные буквы. Идентификатор должен быть задан пользователем при изменении условий фильтра, но будет сгенерирован заново при последующем их запросе. Поведение свойства: - обязательно, если evaltype объекта фильтра правила LLD установлен в "пользовательское выражение" |
| operator | integer | Оператор условия. Возможные значения: 8 - (по умолчанию) совпадает с регулярным выражением; 9 - не совпадает с регулярным выражением; 12 - существует; 13 - не существует. |
Чтобы лучше понять, как использовать фильтры с различными типами выражений, см. примеры на страницах методов discoveryrule.get и discoveryrule.create.
Путь макроса LLD
Путь макроса LLD имеет следующие свойства:
| Свойство | Type | Описание |
|---|---|---|
| lld_macro | string | Макрос LLD. Поведение свойства: - обязательно |
| path | string | Селектор значения, которое будет присвоено соответствующему макросу. Поведение свойства: - обязательно |
Предобработка правила LLD
Объект предобработки правила LLD имеет следующие свойства.
| Свойство | Тип | Описание |
|---|---|---|
| type | integer | Тип опции предобработки. Возможные значения: 5 - Регулярное выражение; 11 - XML XPath; 12 - JSONPath; 14 - Соответствует регулярному выражению; 15 - Не соответствует регулярному выражению; 16 - Проверка на ошибку в JSON; 17 - Проверка на ошибку в XML; 20 - Отбрасывать неизменившееся с интервалом; 21 - JavaScript; 23 - Prometheus в JSON; 24 - CSV в JSON; 25 - Замена; 27 - XML в JSON; 28 - Значение SNMP walk; 29 - SNMP walk в JSON; 30 - Значение SNMP get. Поведение свойства: - обязательно |
| params | string | Дополнительные параметры, используемые опцией предобработки. Несколько параметров разделяются символом новой строки (\n). Поведение свойства: - обязательно, если type установлен в "Регулярное выражение" (5), "XML XPath" (11), "JSONPath" (12), "Соответствует регулярному выражению" (14), "Не соответствует регулярному выражению" (15), "Проверка на ошибку в JSON" (16), "Проверка на ошибку в XML" (17), "Отбрасывать неизменившееся с интервалом" (20), "JavaScript" (21), "Prometheus в JSON" (23), "CSV в JSON" (24), "Замена" (25), "Значение SNMP walk" (28), "SNMP walk в JSON" (29) или "Значение SNMP get" (30) |
| error_handler | integer | Тип действия, используемого в случае сбоя шага предобработки. Возможные значения: 0 - Сообщение об ошибке задаётся сервером Zabbix; 1 - Отбросить значение; 2 - Установить пользовательское значение; 3 - Установить пользовательское сообщение об ошибке. Поведение свойства: - обязательно, если type установлен в "Регулярное выражение" (5), "XML XPath" (11), "JSONPath" (12), "Соответствует регулярному выражению" (14), "Не соответствует регулярному выражению" (15), "Проверка на ошибку в JSON" (16), "Проверка на ошибку в XML" (17), "Prometheus в JSON" (23), "CSV в JSON" (24), "XML в JSON" (27), "Значение SNMP walk" (28), "SNMP walk в JSON" (29) или "Значение SNMP get" (30) |
| error_handler_params | string | Параметры обработчика ошибок. Поведение свойства: - обязательно, если error_handler установлен в "Установить пользовательское значение" или "Установить пользовательское сообщение об ошибке" |
Для каждого типа предобработки поддерживаются следующие параметры и обработчики ошибок.
| Тип предобработки | Название | Параметр 1 | Параметр 2 | Параметр 3 | Поддерживаемые обработчики ошибок |
|---|---|---|---|---|---|
| 5 | Регулярное выражение | шаблон1 | вывод2 | 0, 1, 2, 3 | |
| 11 | XML XPath | путь3 | 0, 1, 2, 3 | ||
| 12 | JSONPath | путь3 | 0, 1, 2, 3 | ||
| 14 | Соответствует регулярному выражению | шаблон1 | 0, 1, 2, 3 | ||
| 15 | Не соответствует регулярному выражению | шаблон1 | 0, 1, 2, 3 | ||
| 16 | Проверка на ошибку в JSON | путь3 | 0, 1, 2, 3 | ||
| 17 | Проверка на ошибку в XML | путь3 | 0, 1, 2, 3 | ||
| 20 | Отбрасывать неизменившееся с интервалом | секунды4,\ 5 | |||
| 21 | JavaScript | скрипт2 | |||
| 23 | Prometheus в JSON | шаблон5,\ 6 | 0, 1, 2, 3 | ||
| 24 | CSV в JSON | символ2 | символ2 | 0,1 | 0, 1, 2, 3 |
| 25 | Замена | строка поиска2 | замена2 | ||
| 27 | XML в JSON | 0, 1, 2, 3 | |||
| 28 | Значение SNMP walk | OID2 | Формат: 0 - Без изменений 1 - UTF-8 из Hex-STRING 2 - MAC из Hex-STRING 3 - Целое число из BITS |
0, 1, 2, 3 | |
| 29 | SNMP walk в JSON7 | Имя поля2 | Префикс OID2 | Формат: 0 - Без изменений 1 - UTF-8 из Hex-STRING 2 - MAC из Hex-STRING 3 - Целое число из BITS |
0, 1, 2, 3 |
| 30 | Значение SNMP get | Формат: 1 - UTF-8 из Hex-STRING 2 - MAC из Hex-STRING 3 - Целое число из BITS |
0, 1, 2, 3 | ||
1 регулярное выражение
2 строка
3 JSONPath или XML XPath
4 положительное целое число (с поддержкой суффиксов времени, например, 30s, 1m, 2h, 1d)
5 пользовательский макрос
6 шаблон Prometheus, следующий синтаксису: <metric name>{<label name>="<label value>", ...} == <value>.
Каждый компонент шаблона Prometheus (метрика, имя метки, значение метки и значение метрики) может быть пользовательским макросом.
7 Поддерживает несколько записей "Имя поля,Префикс OID,Формат", разделённых символом новой строки.
Переопределения правил LLD
Объект переопределений правил LLD определяет набор правил (фильтров, условий и операций), которые используются для переопределения свойств различных объектов прототипов. Он имеет следующие свойства:
| Свойство | Type | Описание |
|---|---|---|
| name | string | Уникальное имя переопределения. Поведение свойства: - обязательно |
| step | integer | Уникальный порядковый номер переопределения. Поведение свойства: - обязательно |
| stop | integer | Остановить обработку следующих переопределений при совпадении. Возможные значения: 0 - (по умолчанию) не останавливать обработку переопределений; 1 - остановить обработку переопределений, если фильтр совпадает. |
| filter | object | Фильтр переопределения. |
| operations | object/array | Операции переопределения. |
Фильтр переопределения правила LLD
Объект фильтра переопределения правила LLD определяет набор условий, при совпадении с которыми для обнаруженного объекта применяется переопределение. Он имеет следующие свойства:
| Свойство | Тип | Описание |
|---|---|---|
| conditions | object/array | Набор условий фильтра переопределения, используемых для сопоставления обнаруженных объектов. Условия будут отсортированы в порядке их размещения в формуле. Поведение свойства: - обязательно |
| evaltype | integer | Метод вычисления условий фильтра переопределения. Возможные значения: 0 - And/Or; 1 - And; 2 - Or; 3 - Пользовательское выражение. Поведение свойства: - обязательно |
| eval_formula | string | Сгенерированное выражение, которое будет использоваться для вычисления условий фильтра переопределения. Выражение содержит идентификаторы, которые ссылаются на конкретные условия фильтра переопределения по их formulaid. Значение eval_formula равно значению formula для фильтров с пользовательским выражением.Поведение свойства: - только для чтения |
| formula | string | Определяемое пользователем выражение, используемое для вычисления условий фильтров переопределения с пользовательским выражением. Выражение должно содержать идентификаторы, которые ссылаются на конкретные условия фильтра переопределения по их formulaid. Идентификаторы, используемые в выражении, должны в точности соответствовать тем, которые определены в условиях фильтра переопределения: ни одно условие не должно остаться неиспользованным или пропущенным.Поведение свойства: - обязательно, если evaltype установлено в "custom expression" |
Условие фильтра переопределения правила LLD
Объект условия фильтра переопределения правила LLD определяет отдельную проверку, выполняемую для значения макроса LLD. Он имеет следующие свойства:
| Свойство | Type | Описание |
|---|---|---|
| macro | string | Макрос LLD, для которого выполняется проверка. Property behavior: - required |
| value | string | Значение для сравнения. Property behavior: - required если operator установлен в "совпадает с регулярным выражением" или "не совпадает с регулярным выражением" |
| formulaid | string | Произвольный уникальный идентификатор, используемый для ссылки на условие из пользовательского выражения. Может содержать только заглавные буквы. Идентификатор должен быть задан пользователем при изменении условий фильтра, но будет сгенерирован заново при их последующем запросе. Property behavior: - required если evaltype объекта LLD rule override filter object установлен в "пользовательское выражение" |
| operator | integer | Оператор условия. Возможные значения: 8 - (по умолчанию) совпадает с регулярным выражением; 9 - не совпадает с регулярным выражением; 12 - существует; 13 - не существует. |
Операция переопределения правила LLD
Операция переопределения правила LLD представляет собой комбинацию условий и действий, выполняемых для объекта прототипа. Она имеет следующие свойства:
| Свойство | Type | Описание |
|---|---|---|
| operationobject | integer | Тип обнаруженного объекта, для которого выполняется действие. Возможные значения: 0 - Прототип элемента данных; 1 - Прототип триггера; 2 - Прототип графика; 3 - Прототип узла сети; 4 - Прототип обнаружения. Поведение свойства: - обязательно |
| operator | integer | Условие переопределения operator. Возможные значения: 0 - (по умолчанию) равно; 1 - не равно; 2 - содержит; 3 - не содержит; 8 - соответствует; 9 - не соответствует. |
| value | string | Шаблон для сопоставления с именем прототипа элемента данных, триггера, графика или узла сети в зависимости от выбранного объекта. |
| opstatus | object | Объект статуса операции переопределения для объектов прототипа элемента данных, триггера и узла сети. |
| opdiscover | object | Объект статуса обнаружения операции переопределения (для всех типов объектов). |
| opperiod | object | Объект периода операции переопределения (интервал обновления) для объекта прототипа элемента данных. |
| ophistory | object | Объект истории операции переопределения для объекта прототипа элемента данных. |
| optrends | object | Объект трендов операции переопределения для объекта прототипа элемента данных. |
| opseverity | object | Объект важности операции переопределения для объекта прототипа триггера. |
| optag | object/array | Объект тега операции переопределения для объектов прототипа триггера и узла сети. |
| optemplate | object/array | Объект шаблона операции переопределения для объекта прототипа узла сети. |
| opinventory | object | Объект инвентаризации операции переопределения для объекта прототипа узла сети. |
Статус операции переопределения правила LLD
Статус операции переопределения правила LLD, который устанавливается для обнаруженного объекта. Имеет следующие свойства:
| Свойство | Тип | Описание |
|---|---|---|
| status | integer | Переопределяет статус для выбранного объекта. Возможные значения: 0 - Создать включённым; 1 - Создать отключённым. Поведение свойства: - обязательно |
Обнаружение операции переопределения правила LLD
Статус обнаружения операции переопределения правила LLD, который устанавливается для обнаруженного объекта. Имеет следующие свойства:
| Свойство | Type | Описание |
|---|---|---|
| discover | integer | Переопределяет статус обнаружения для выбранного объекта. Возможные значения: 0 - Да, продолжать обнаружение объектов; 1 - Нет, новые объекты не будут обнаруживаться, а существующие будут помечены как потерянные. Поведение свойства: - обязательно |
Период операции переопределения правила LLD
Период операции переопределения правила LLD — это значение интервала обновления, которое задается для обнаруженного элемента данных. Он имеет следующие свойства:
| Свойство | Тип | Описание |
|---|---|---|
| delay | string | Переопределяет интервал обновления прототипа элемента данных. Принимает секунды или единицу времени с суффиксом (например, 30s, 1m, 2h, 1d), а также, при необходимости, один или несколько пользовательских интервалов, разделенных точкой с запятой. Пользовательские интервалы могут представлять собой сочетание гибких интервалов и интервалов по расписанию. Принимает пользовательские макросы или макросы LLD. Если они используются, значение должно быть одним макросом. Несколько макросов или макросы в сочетании с текстом не поддерживаются. Гибкие интервалы могут быть записаны как два макроса, разделенные прямой косой чертой (например, {$FLEX_INTERVAL}/{$FLEX_PERIOD}).Пример: 1h;wd1-5h9-18;{$Macro1}/1-7,00:00-24:00;0/6-7,12:00-24:00;{$Macro2}/{$Macro3}Поведение свойства: - required |
История операции переопределения правила LLD
Значение истории операции переопределения правила LLD, которое задается для обнаруженного элемента данных. Оно имеет следующие свойства:
| Свойство | Type | Описание |
|---|---|---|
| history | string | Переопределяет историю прототипа элемента данных, то есть единицу времени, в течение которой должны храниться исторические данные. Также принимает пользовательский макрос и макрос LLD. Поведение свойства: - обязательно |
Тренды операции переопределения правила LLD
Значение трендов операции переопределения правила LLD, которое устанавливается для обнаруженного элемента данных. Оно имеет следующие свойства:
| Свойство | Type | Описание |
|---|---|---|
| trends | string | Переопределяет тренды прототипа элемента данных, то есть единицу времени, определяющую, как долго должны храниться данные трендов. Также принимает пользовательский макрос и макрос LLD. Поведение свойства: - обязательно |
Серьезность операции переопределения правила LLD
Значение серьезности операции переопределения правила LLD, которое устанавливается для обнаруженного триггера. Оно имеет следующие свойства:
| Свойство | Type | Описание |
|---|---|---|
| severity | integer | Переопределяет серьезность прототипа триггера. Возможные значения: 0 - (по умолчанию) не классифицировано; 1 - информация; 2 - предупреждение; 3 - средняя; 4 - высокая; 5 - катастрофа. Поведение свойства: - обязательно |
Тег операции переопределения правила LLD
Объект тега операции переопределения правила LLD содержит имя и значение тега, которые задаются для обнаруженного объекта. Он имеет следующие свойства:
| Свойство | Type | Описание |
|---|---|---|
| tag | string | Новое имя тега. Поведение свойства: - обязательно |
| value | string | Новое значение тега. |
Шаблон операции переопределения правила LLD
Объект шаблона операции переопределения правила LLD, который связан с обнаруженным узлом сети. Он имеет следующие свойства:
| Свойство | Type | Описание |
|---|---|---|
| templateid | ID | Переопределяет шаблон среди связанных шаблонов прототипа узла сети. Поведение свойства: - обязательно |
Значение режима инвентаризации операции переопределения правила LLD
Значение режима инвентаризации операции переопределения правила LLD, которое устанавливается для обнаруженного узла сети. Оно имеет следующие свойства:
| Свойство | Type | Описание |
|---|---|---|
| inventory_mode | integer | Переопределяет режим инвентаризации прототипа узла сети. Возможные значения: -1 - отключено; 0 - (по умолчанию) вручную; 1 - автоматически. Поведение свойства: - обязательно |