> Объект правила LLD

Следующие объекты напрямую связаны с discoveryrule API.

Правило LLD

Объект низкоуровневого правила обнаружения имеет следующие свойства.

Свойство Тип Описание
itemid строка (только чтение) ID правила LLD.
delay
(требуется)
строка Интервал обновления LLD правила. Принимает секунды или единицы времени с суффиксом и с или без одного или нескольких пользовательских интервалов, которые состоят как из гибких интервалов, так и интервалов по расписанию в виде сериализованных строк. Также принимает пользовательские макросы. Гибкие интервалы можно записать в виде двух макросов, разделенных прямой косой чертой. Интервалы разделаются точкой с запятой.
hostid
(требуется)
строка ID узла сети, которому принадлежит правило LLD.
interfaceid
(требуется)
строка ID интерфейса узла сети правила LLD. Используется только правилами LLD на узлах сети.

Опционален для правил LLD Zabbix агента (активный), Zabbix внутренний, Zabbix траппер и монитор баз данных.
key_
(требуется)
строка Ключ правила LLD.
name
(требуется)
строка Имя правила LLD.
type
(требуется)
целое число Тип правила LLD.

Возможные значения:
0 - Zabbix агент;
1 - SNMPv1 агент;
2 - Zabbix траппер;
3 - простая проверка;
4 - SNMPv2 агент;
5 - Zabbix внутренний;
6 - SNMPv3 агент;
7 - Zabbix агент (активный);
10 - внушняя проверка;
11 - монитор баз данных;
12 - IPMI агент;
13 - SSH агент;
14 - TELNET агент;
16 - JMX агент.
authtype целое число Метод аутентификации SSH. Используется только правилами LLD SSH агента.

Возможные значения:
0 - (по умолчанию) пароль;
1 - публичный ключ.
description строка Описание правила LLD.
error строка (только чтение) Текст ошибки, если имеются проблемы с обновлением правила LD.
ipmi_sensor строка Сенсор IPMI. Используется только правилами LLD IPMI.
lifetime строка Период времени после которого элементы данных, которые более не обнаруживаются, будут удалены. Принимает секунды, единицы времени с суффиксом и пользовательские макросы.

По умолчанию: 30d.
params строка Дополнительные параметры, которые зависят от типа правила LLD:
- выполняемый скрипт в случае SSH и Telnet правил LLD;
- SQL запрос в случае правила LLD монитора базы данных;
- формула в случае вычисляемых правил LLD.
password строка Пароль для аутентификации. Используется правилами LLD простой проверки, SSH, Telnet, монитором баз данных и JMX.
port строка Используемый правилом LLD порт. Используется только SNMP правилами LLD.
privatekey строка Имя файла приватного ключа.
publickey строка Имя файла публичного ключа.
snmp_community строка SNMP community. Используется только SNMPv1 и SNMPv2 правилами LLD.
snmp_oid строка SNMP OID.
snmpv3_authpassphrase строка Фраза-пароль аутентификации SNMPv3. Используется только SNMPv3 правилами LLD.
snmpv3_authprotocol целое число Протокол аутентификации SNMPv3. Используется только SNMPv3 правилами LLD.

Возможные значения:
0 - (по умолчанию) MD5;
1 - SHA.
snmpv3_contextname строка Имя контекста SNMPv3. Используется только SNMPv3 правилами LLD.
snmpv3_privpassphrase строка Фраза-пароль безопасности SNMPv3. Используется только SNMPv3 правилами LLD.
snmpv3_privprotocol целое число Протокол безопасности SNMPv3. Используется только SNMPv3 правилами LLD.

Возможные значения:
0 - (по умолчанию) DES;
1 - AES.
snmpv3_securitylevel целое число Уровень безопасности SNMPv3. Используется только SNMPv3 правилами LLD.

Возможные значения:
0 - noAuthNoPriv;
1 - authNoPriv;
2 - authPriv.
snmpv3_securityname строка Имя безопасности SNMPv3. Используется только SNMPv3 правилами LLD.
state целое число (только чтение) Статус правила LLD.

Возможные значения:
0 - (по умолчанию) нормальный;
1 - неподдерживается.
status целое число Состояние правила LLD.

Возможные значения:
0 - (по умолчанию) активированное правило LLD;
1 - деактивированное правило LLD.
templateid строка (только чтение) ID родительского правила LLD из шаблона.
trapper_hosts строка Разрешенные хосты. Используется только траппер правилами LLD.
username строка Имя пользователя для аутентификации. Используется правилами LLD простой проверкой, SSH, Telnet, монитором баз данных и JMX.

Требуется для SSH и Telnet правил LLD.
jmx_endpoint строка Строка пользовательского соединения с JMX агентом.

Значение по умолчанию:
service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT}/jmxrmi

Фильтр правила LLD

Объект фильтра правила LLD определяет набор условий, которые можно использовать для фильтрации обнаруженных объектов. Этот объект имеет следующие свойства:

Свойство Тип Описание
conditions
(требуется)
массив Набор условий фильтрации, которые используются для фильтрации результатов.
evaltype
(требуется)
целое число Метод вычисления условий фильтрации.

Возможные значения:
0 - и/или;
1 - и;
2 - или;
3 - пользовательское выражение.
eval_formula строка (только чтение) Сгенерированное выражение, которое будет использоваться для вычисления условий фильтрации. Выражение содержит ID, которые являются ссылкой на определенные условия фильтрации по их formulaid полю. Значение eval_formula равно значению formula для фильтров с пользовательским выражением.
formula строка Заданное пользователем выражение, которое используется для вычисления условий фильтров с пользовательским выражением. Выражение должно содержать ID, которые являются ссылкой на определенные условия фильтрации по их formulaid. Эти ID используемые в выражении должны в точности совпадать с выражениями, которые заданы в условиях фильтрации: ни одно условие не должно остаться неиспользуемым или пропущенным.

Требуется для фильтров с пользовательским выражением.

Условие фильтрации правила LLD

Объект условия фильтрации правила LLD определяет индивидуальную проверку, которая проверяет соответствие значения LLD макроса. Этот метод имеет следующие свойства:

Свойство Тип Описание
macro
(требуется)
строка LLD макрос для которого необходимо выполнять проверку.
value
(требуется)
строка Значение с которым необходимо выполнить сравнение.
formulaid строка Произвольный уникальный ID, который используется в качестве ссылки на условие из пользовательского выражения. Может содержать только буквы в верхнем регистре. Этот ID должен быть задан пользователем при изменении условий фильтрации, однако ID будут сгенерированы заново при последующих их запросах.
operator целое число Оператор условия.

Возможные значения:
8 - (по умолчанию) совпадение с регулярным выражением.

Чтобы лучше понимать как использовать фильтры с различными типами выражений, смотрите примеры на страницах discoveryrule.get и discoveryrule.create методов.