- Объект правила LLD
- Правило НУО
- Фильтр правила LLD
- Путь макроса LLD
- Предобработка правила LLD
- Переопределения правил LLD
- Фильтр переопределения правила LLD
- Операция переопределения правила LLD
- Статус операции переопределения правила LLD
- Операция переопределения правила LLD: discover
- Период выполнения операции переопределения правила LLD
- История операций переопределения правила LLD
- Тренды операции переопределения правила LLD
- Переопределение серьезности операции правила LLD
- Тег операции переопределения правила LLD
- Шаблон операции переопределения правила LLD
- Инвентарь операции переопределения правила LLD
Объект правила LLD
Следующие объекты напрямую связаны с API discoveryrule.
Правило НУО
Объект правила низкоуровневого обнаружения имеет следующие свойства.
| Свойство | Тип | Описание |
|---|---|---|
| itemid | ID | Идентификатор правила НУО. Поведение свойства: - только для чтения - обязательно для операций обновления |
| delay | string | Интервал обновления правила НУО. Принимает количество секунд (например, 1, 60, 300), значение с суффиксом времени (например, 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 | Идентификатор узла сети, которому принадлежит правило НУО. Поведение свойства: - постоянное - обязательно для операций создания |
| flags | integer | Источник правила обнаружения. Возможные значения: 1 - правило низкоуровневого обнаружения; 5 - правило низкоуровневого обнаружения, преобразованное из прототипа. Поведение свойства: - только для чтения |
| interfaceid | ID | Идентификатор интерфейса узла сети правила НУО. Поведение свойства: - обязательно, если правило НУО принадлежит узлу сети, а type имеет значение "Zabbix agent", "IPMI agent", "JMX agent" или "SNMP agent"- поддерживается, если правило НУО принадлежит узлу сети, а type имеет значение "Simple check", "External check", "SSH agent", "TELNET agent" или "HTTP agent" |
| key_ | string | Ключ правила НУО. Поведение свойства: - обязательно для операций создания - только для чтения для унаследованных объектов |
| name | string | Имя правила НУО. Поведение свойства: - обязательно для операций создания - только для чтения для унаследованных объектов |
| type | integer | Тип правила НУО. Возможные значения: 0 - Zabbix agent; 2 - Zabbix trapper; 3 - Simple check; 5 - Zabbix internal; 7 - Zabbix agent (active); 10 - External check; 11 - Database monitor; 12 - IPMI agent; 13 - SSH agent; 14 - TELNET agent; 16 - JMX agent; 18 - Зависимый элемент данных; 19 - HTTP agent; 20 - SNMP agent; 21 - Script; 22 - Browser; 23 - Вложенное. Этот тип разрешён только в том случае, если родитель правила является шаблоном (предполагается, что он связан с прототипом узла сети при обнаружении) или обнаруженным узлом сети (у которого в корне есть правило НУО). Поведение свойства: - обязательно для операций создания - только для чтения для унаследованных объектов |
| 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 - базовая; 2 - NTLM; 3 - Kerberos; 4 - Digest. Поведение свойства: - поддерживается, если type имеет значение "SSH agent" или "HTTP agent"- только для чтения для унаследованных объектов (если type имеет значение "HTTP agent") |
| description | string | Описание правила НУО. |
| error | string | Текст ошибки, если при обновлении значения правила НУО возникли проблемы. Поведение свойства: - только для чтения |
| 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 | Период времени, по истечении которого элементы данных, больше не обнаруживаемые, будут удалены. Принимает количество секунд (например, 3600), значение с суффиксом времени (например, 3600s, 180m, 24h, 1d) или пользовательский макрос.По умолчанию: 7d. |
| lifetime_type | integer | Сценарий удаления потерянных ресурсов НУО. Возможные значения: 0 - (по умолчанию) удалить после достижения порога времени хранения; 1 - не удалять; 2 - удалить немедленно. |
| enabled_lifetime | string | Период времени, по истечении которого элементы данных, больше не обнаруживаемые, будут отключены. Принимает количество секунд (например, 1, 60, 300), значение с суффиксом времени (например, 30s, 1m, 2h, 1d) или пользовательский макрос.По умолчанию: 0. |
| enabled_lifetime_type | integer | Сценарий отключения потерянных ресурсов НУО. Возможные значения: 0 - отключить после достижения порога времени хранения; 1 - не отключать; 2 - (по умолчанию) отключить немедленно. |
| master_itemid | ID | Идентификатор главного элемента данных. Правило обнаружения не может быть главным элементом данных для другого правила обнаружения. Поведение свойства: - обязательно, если type имеет значение "Dependent item"- только для чтения для унаследованных объектов |
| output_format | integer | Следует ли преобразовать ответ в JSON. Возможные значения: 0 - (по умолчанию) сохранять без изменений; 1 - преобразовать в JSON. Поведение свойства: - поддерживается, если type имеет значение "HTTP agent"- только для чтения для унаследованных объектов |
| params | string | Дополнительные параметры в зависимости от типа правила НУО: - выполняемый скрипт для правил НУО SSH и Telnet; - SQL-запрос для правил НУО мониторинга баз данных; - формула для вычисляемых правил НУО; - скрипт для правил НУО типа 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 | OID SNMP. Поведение свойства: - обязательно, если 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 | Состояние правила НУО. Возможные значения: 0 - (по умолчанию) нормальное; 1 - не поддерживается. Поведение свойства: - только для чтения |
| status | integer | Состояние правила НУО. Возможные значения: 0 - (по умолчанию) правило НУО включено; 1 - правило НУО отключено. |
| status_codes | string | Диапазоны требуемых кодов состояния HTTP, разделённые запятыми. Также поддерживает пользовательские макросы как часть списка, разделённого запятыми. Пример: 200,200-{$M},{$M},200-400 Поведение свойства: - поддерживается, если type имеет значение "HTTP agent"- только для чтения для унаследованных объектов |
| templateid | ID | Идентификатор родительского правила НУО шаблона. Поведение свойства: - только для чтения |
| timeout | string | Тайм-аут запроса на опрос данных элемента данных. Принимает количество секунд (например, 1, 60, 300) или значение с суффиксом времени (например, 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".Если свойство не указано, ему автоматически присваивается пользовательский макрос {$TRAPPER.ALLOWED_HOSTS} (значение по умолчанию). По умолчанию {$TRAPPER.ALLOWED_HOSTS} имеет значение 127.0.0.1,::1.Если свойству присвоена пустая строка, входящие подключения будут запрещены со всех узлов сети. |
| username | string | Имя пользователя для аутентификации. Поведение свойства: - обязательно, если type имеет значение "SSH agent", "TELNET agent" или если type имеет значение "JMX agent", а password задан- поддерживается, если type имеет значение "Simple check", "Database monitor" или "HTTP agent"- только для чтения для унаследованных объектов (если type имеет значение "HTTP agent") |
| uuid | string | Универсальный уникальный идентификатор, используемый для связывания импортированных правил НУО с уже существующими. Создаётся автоматически, если не указан. Поведение свойства: - поддерживается, если правило НУО принадлежит шаблону |
| verify_host | integer | Следует ли проверять, совпадает ли имя узла сети для подключения с именем в сертификате узла сети. Возможные значения: 0 - (по умолчанию) не проверять; 1 - проверять. Поведение свойства: - поддерживается, если type имеет значение "HTTP agent"- только для чтения для унаследованных объектов |
| verify_peer | integer | Следует ли проверять подлинность сертификата узла сети. Возможные значения: 0 - (по умолчанию) не проверять; 1 - проверять. Поведение свойства: - поддерживается, если type имеет значение "HTTP agent"- только для чтения для унаследованных объектов |
HTTP-заголовок
Объект заголовка имеет следующие свойства:
| Property | Type | Description |
|---|---|---|
| name | string | Имя HTTP-заголовка. Поведение свойства: - required |
| value | string | Значение заголовка. Поведение свойства: - required |
Поле HTTP-запроса
Объект поля запроса определяет имя и значение, которые используются для указания параметра URL. Он имеет следующие свойства:
| Property | Type | Description |
|---|---|---|
| name | string | Имя параметра. Property behavior: - required |
| value | string | Значение параметра. Property behavior: - required |
Фильтр правила LLD
Объект фильтра правила LLD определяет набор условий, которые можно использовать для фильтрации обнаруженных объектов. Он имеет следующие свойства:
| Property | Type | Description |
|---|---|---|
| conditions | object/array | Набор условий фильтра, используемых для фильтрации результатов. Условия будут отсортированы в порядке их размещения в формуле. Поведение свойства: - required |
| evaltype | integer | Метод оценки условий фильтра. Возможные значения: 0 - And/Or; 1 - And; 2 - Or; 3 - Пользовательское выражение. Поведение свойства: - required |
| eval_formula | string | Сгенерированное выражение, которое будет использоваться для оценки условий фильтра. Выражение содержит идентификаторы, которые ссылаются на конкретные условия фильтра через их formulaid. Значение eval_formula равно значению formula для фильтров с пользовательским выражением.Поведение свойства: - read-only |
| formula | string | Определяемое пользователем выражение, используемое для оценки условий фильтров с пользовательским выражением. Выражение должно содержать идентификаторы, которые ссылаются на конкретные условия фильтра через их formulaid. Идентификаторы, используемые в выражении, должны в точности совпадать с теми, что определены в условиях фильтра: ни одно условие не может остаться неиспользованным или быть пропущенным.Поведение свойства: - required если evaltype установлен в "custom expression" |
Условие фильтра правила LLD
Объект условия фильтра правила LLD определяет отдельную проверку, выполняемую для значения макроса LLD. Он имеет следующие свойства:
| Property | Type | Description |
|---|---|---|
| macro | string | Макрос LLD, для которого выполняется проверка. Property behavior: - required |
| value | string | Значение для сравнения. Property behavior: - required if operator is set to "matches regular expression" or "does not match regular expression" |
| formulaid | string | Произвольный уникальный ID, который используется для ссылки на условие из пользовательского выражения. Может содержать только заглавные буквы. ID должен быть задан пользователем при изменении условий фильтра, но будет сгенерирован заново при последующем запросе. Property behavior: - required if evaltype of LLD rule filter object is set to "custom expression" |
| operator | integer | Оператор условия. Possible values: 8 - (default) matches regular expression; 9 - does not match regular expression; 12 - exists; 13 - does not exist. |
Чтобы лучше понять, как использовать фильтры с различными типами выражений, см. примеры на страницах методов discoveryrule.get и discoveryrule.create.
Путь макроса LLD
Путь макроса LLD имеет следующие свойства:
| Property | Type | Description |
|---|---|---|
| lld_macro | string | Макрос LLD. Поведение свойства: - required |
| path | string | Селектор для значения, которое будет назначено соответствующему макросу. Поведение свойства: - required |
Предобработка правила 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. Поведение свойства: - обязательное |
| 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» (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» (30) |
| error_handler_params | string | Параметры обработчика ошибок. Поведение свойства: - обязательное, если для error_handler установлено значение «Установить пользовательское значение» или «Установить пользовательское сообщение об ошибке» |
Для каждого типа предобработки поддерживаются следующие параметры и обработчики ошибок.
| Тип предобработки | Название | Параметр 1 | Параметр 2 | Параметр 3 | Поддерживаемые обработчики ошибок |
|---|---|---|---|---|---|
| 5 | Регулярное выражение | pattern1 | output2 | 0, 1, 2, 3 | |
| 11 | XML XPath | path3 | 0, 1, 2, 3 | ||
| 12 | JSONPath | path3 | 0, 1, 2, 3 | ||
| 14 | Соответствует регулярному выражению | pattern1 | 0, 1, 2, 3 | ||
| 15 | Не соответствует регулярному выражению | pattern1 | 0, 1, 2, 3 | ||
| 16 | Проверка наличия ошибки в JSON | path3 | 0, 1, 2, 3 | ||
| 17 | Проверка наличия ошибки в XML | path3 | 0, 1, 2, 3 | ||
| 20 | Отбрасывать неизменившиеся значения с контролем доступности | seconds4, 5 | |||
| 21 | JavaScript | script2 | |||
| 23 | Prometheus в JSON | pattern5, 6 | 0, 1, 2, 3 | ||
| 24 | CSV в JSON | character2 | character2 | 0,1 | 0, 1, 2, 3 |
| 25 | Замена | search string2 | replacement2 | ||
| 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 | Field name2 | OID prefix2 | Формат: 0 - Без изменений 1 - UTF-8 из Hex-STRING 2 - MAC из Hex-STRING 3 - Целое число из BITS |
0, 1, 2, 3 |
| 30 | Получение значения SNMP | Формат: 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 определяет набор правил (фильтры, условия и операции), которые используются для переопределения свойств различных объектов прототипов. Он имеет следующие свойства:
| Property | Type | Description |
|---|---|---|
| name | string | Уникальное имя переопределения. Property behavior: - required |
| step | integer | Уникальный порядковый номер переопределения. Property behavior: - required |
| stop | integer | Остановить обработку следующих переопределений, если совпадает. Possible values: 0 - (default) не останавливать обработку переопределений; 1 - остановить обработку переопределений, если фильтр совпадает. |
| filter | object | Фильтр переопределения. |
| operations | object/array | Операции переопределения. |
Фильтр переопределения правила LLD
Объект фильтра переопределения правила LLD определяет набор условий, и если они совпадают с обнаруженным объектом, применяется переопределение. Он имеет следующие свойства:
| Property | Type | Description |
|---|---|---|
| conditions | object/array | Набор условий фильтра переопределения, используемых для сопоставления обнаруженных объектов. Условия будут отсортированы в порядке их размещения в формуле. Поведение свойства: - required |
| evaltype | integer | Метод оценки условий фильтра переопределения. Возможные значения: 0 - And/Or; 1 - And; 2 - Or; 3 - Custom expression. Поведение свойства: - required |
| eval_formula | string | Сгенерированное выражение, которое будет использоваться для оценки условий фильтра переопределения. Выражение содержит идентификаторы, которые ссылаются на конкретные условия фильтра переопределения по их formulaid. Значение eval_formula равно значению formula для фильтров с пользовательским выражением.Поведение свойства: - read-only |
| formula | string | Определяемое пользователем выражение, используемое для оценки условий фильтров переопределения с пользовательским выражением. Выражение должно содержать идентификаторы, которые ссылаются на конкретные условия фильтра переопределения по их formulaid. Идентификаторы, используемые в выражении, должны в точности совпадать с теми, что определены в условиях фильтра переопределения: ни одно условие не может остаться неиспользованным или быть пропущенным.Поведение свойства: - required if evaltype is set to "custom expression" |
Условие фильтра переопределения правила LLD
Объект условия фильтра переопределения правила LLD определяет отдельную проверку, выполняемую для значения макроса LLD. Он имеет следующие свойства:
| Property | Type | Description |
|---|---|---|
| macro | string | Макрос LLD, для которого выполняется проверка. Property behavior: - required |
| value | string | Значение для сравнения. Property behavior: - required if operator is set to "matches regular expression" or "does not match regular expression" |
| formulaid | string | Произвольный уникальный ID, который используется для ссылки на условие из пользовательского выражения. Может содержать только заглавные буквы. ID должен быть задан пользователем при изменении условий фильтра, но будет сгенерирован заново при последующем запросе. Property behavior: - required if evaltype of LLD rule override filter object is set to "custom expression" |
| operator | integer | Оператор условия. Possible values: 8 - (default) matches regular expression; 9 - does not match regular expression; 12 - exists; 13 - does not exist. |
Операция переопределения правила LLD
Операция переопределения правила LLD представляет собой комбинацию условий и действий, выполняемых над объектом-прототипом. Она имеет следующие свойства:
| Property | Type | Description |
|---|---|---|
| operationobject | integer | Тип обнаруженного объекта, для которого выполняется действие. Возможные значения: 0 - прототип элемента данных; 1 - прототип триггера; 2 - прототип графика; 3 - прототип узла сети; 4 - прототип обнаружения. Поведение свойства: - required |
| operator | integer | Оператор условия переопределения. Возможные значения: 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, который задается для обнаруженного объекта. Он имеет следующие свойства:
| Property | Type | Description |
|---|---|---|
| status | integer | Переопределяет статус для выбранного объекта. Возможные значения: 0 - Создать включенным; 1 - Создать отключенным. Поведение свойства: - required |
Операция переопределения правила LLD: discover
Статус операции переопределения правила LLD discover, который задается для обнаруженного объекта. Он имеет следующие свойства:
| Property | Type | Description |
|---|---|---|
| discover | integer | Переопределяет статус discover для выбранного объекта. Возможные значения: 0 - Да, продолжать обнаружение объектов; 1 - Нет, новые объекты не будут обнаруживаться, а существующие будут помечены как потерянные. Поведение свойства: - required |
Период выполнения операции переопределения правила LLD
Период выполнения операции переопределения правила LLD — это значение интервала обновления, заданное для обнаруженного элемента данных. Он имеет следующие свойства:
| Property | Type | Description |
|---|---|---|
| delay | string | Переопределяет интервал обновления прототипа элемента данных. Принимает количество секунд (например, 1, 60, 300), значение с суффиксом времени (например, 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}Поведение свойства: - обязательное |
История операций переопределения правила LLD
Значение истории операций переопределения правила LLD, которое задается для обнаруженного элемента данных. Оно имеет следующие свойства:
| Property | Type | Description |
|---|---|---|
| history | string | Переопределяет историю прототипа элемента данных, которая представляет собой единицу времени, определяющую, как долго должны храниться данные истории. Также принимает пользовательский макрос и LLD-макрос. Property behavior: - required |
Тренды операции переопределения правила LLD
Значение трендов операции переопределения правила LLD, которое задается для обнаруженного элемента данных. Оно имеет следующие свойства:
| Property | Type | Description |
|---|---|---|
| trends | string | Переопределяет тренды прототипа элемента данных, то есть задает единицу времени, в течение которой должны храниться данные трендов. Также принимает пользовательский макрос и макрос LLD. Property behavior: - required |
Переопределение серьезности операции правила LLD
Значение серьезности операции переопределения правила LLD, которое задается для обнаруженного триггера. Оно имеет следующие свойства:
| Property | Type | Description |
|---|---|---|
| severity | integer | Переопределяет серьезность прототипа триггера. Возможные значения: 0 - (по умолчанию) не классифицировано; 1 - информация; 2 - предупреждение; 3 - средняя; 4 - высокая; 5 - катастрофа. Поведение свойства: - required |
Тег операции переопределения правила LLD
Объект тега операции переопределения правила LLD содержит имя тега и значение, которые задаются для обнаруженного объекта. Он имеет следующие свойства:
| Property | Type | Description |
|---|---|---|
| tag | string | Новое имя тега. Также принимает пользовательский макрос и LLD-макрос. Property behavior: - required |
| value | string | Новое значение тега. Также принимает пользовательский макрос и LLD-макрос. |
Шаблон операции переопределения правила LLD
Объект шаблона операции переопределения правила LLD, который связан с обнаруженным узлом сети. Он имеет следующие свойства:
| Property | Type | Description |
|---|---|---|
| templateid | ID | Переопределяет шаблон связанных шаблонов прототипа узла сети. Property behavior: - required |
Инвентарь операции переопределения правила LLD
Значение режима инвентаря операции переопределения правила LLD, которое задается для обнаруженного узла сети. Имеет следующие свойства:
| Property | Type | Description |
|---|---|---|
| inventory_mode | integer | Переопределяет режим инвентаря прототипа узла сети. Возможные значения: -1 - отключено; 0 - (по умолчанию) вручную; 1 - автоматически. Поведение свойства: - required |