> LLD 规则对象

下面的对象直接关联到discoveryrule(发现规则) API。

LLD 规则

低级发现规则对象有如下属性。

属性类型说明
itemidstring(只读) ID of the LLD rule. LLD规则的ID
delay
(必须)
stringLLD规则的更新时间间隔。接受带后缀的秒或时间单位,包含或不包含一个或多个自定义时间间隔,它由灵活的时间间隔和调度时间间隔作为序列化字符串组成。也接受用户宏。灵活的间隔可以写成用正斜杠分隔的两个宏。间隔用分号分隔
hostid
(必须)
stringLLD规则所属的Host的ID。
interfaceid
(必须)
stringLLD规则的主机接口ID。仅用于主机LLD规则。

Zabbix agent (active), Zabbix internal, Zabbix trapper and 数据库监控LLD规则的可选参数。
key_
(必须)
stringLLD规则键。
name
(必须)
stringLLD规则名称。
type
(必须)
integerLLD规则类型。

可能的值:
0 - Zabbix agent;
1 - SNMPv1 agent;
2 - Zabbix trapper;
3 - simple check;
4 - SNMPv2 agent;
5 - Zabbix internal;
6 - SNMPv3 agent;
7 - Zabbix agent (active);
10 - external check;
11 - database monitor;
12 - IPMI agent;
13 - SSH agent;
14 - TELNET agent;
16 - JMX agent;
19 - HTTP agent;
19 -SNMP agent;
url
(必须)
stringURL字符串,HTTP agent LLD rule要求有。支持用户宏, {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}。
allow_trapsintegerHTTP agent LLD规则字段。在陷阱监控项类型中也允许填充值

0 - (默认)不允许接受输入数据
1 - 允许输入数据
authtypeinteger只能被SSH agent或HTTP agent使用
\SSH agent认证方法可能的值:
0 - (默认) 密码;
1 - 公钥.

HTTP agent认证方法可能的值:
0 - (默认) none
1 - basic
2 - NTLM
descriptionstringLLD规则说明。
errorstring(只读) 如果更新LLD规则出问题时的错误文本。
follow_redirectsintegerHTTP agentLLD规则字段。当合并数据时进行重定向。

0 - 不跟随重定向。
1 - (默认)跟随重定向。
headersobjectHTTP agent LLD规则字段。该对象带有HTTP(S)已键为名称,包头的值作为值的请求头。

事例:
{ “User-Agent”: “Zabbix” }
http_proxystringHTTP agent LLD规则字段。HTTP(S) proxy连接字符串。
ipmi_sensorstringIPMI sensor.只用于IPMILLD规则
jmx_endpointstringJMX agent自定义连接字符串。

默认值:
service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT}/jmxrmi
lifetimestring不在发现的时间周期内监控项将被删除。接受秒、带后缀和用户宏的时间单位。

Default: 30d.
master_itemidinteger主条目ID。允许递归至多3个相关项,且相关项的最大计数为999。发现规则不能是其他发现规则的主项。相关项必需。
output_formatintegerHTTP agent LLD规则字段。应返回传递给JSON.

0 - (默认) Store raw.
1 - Convert to JSON.
paramsstring依赖于LLD规则类型的其他参数:
- 为SSH何Telnet LLD规则执行脚本;
- 数据库监控LLD规则的SQL查询;
- 计算类的LLD规则公式。
passwordstring认证密码。用于simple check, SSH, Telnet, database monitor, JMX and HTTP agent LLD 规则。
portstringLLD规则使用的端口。仅SNMP LLD规则使用
post_typeintegerHTTP agent LLD 规则字段。post数据body部分存储在posts属性中的类型。

0 - (默认) Raw data.
2 - JSON data.
3 - XML data.
postsstringHTTP agent LLD规则字段。HTTP(S)请求body数据,在post_type中使用。
privatekeystring私钥文件名。
publickeystring公共键文件的名称。
query_fieldsarrayHTTP agent LLD规则字段。查询参数。带有’key’:’value’ 键值对的数组对象,值可以为空。
request_methodintegerHTTP agent LLD规则字段。请求方法类型。

0 - GET
1 - (默认) POST
2 - PUT
3 - HEAD
retrieve_modeintegerHTTP agent LLD规则字段。指明哪部分响应应被存储起来。

0 - (默认) Body.
1 - Headers.
2 - HTTP正文和HTTP Headers都将被存储.

对于http 请求方法头,只允许值为1。
snmp_oidstringSNMP OID.
ssl_cert_filestringHTTP agent LLD规则字段。公共SSL键文件路径。
ssl_key_filestringHTTP agent LLD规则字段。私有SSL键文件路径。
ssl_key_passwordstringHTTP agent LLD规则字段。SSL键文件密码。
stateinteger(只读) LLD规则的状态。

取值:
0 - (默认) 正常;
1 - 不支持
statusintegerStatus of the LLD rule.

取值:
0 - (默认) 启用LLD规则;
1 - 关闭LLD规则.
status_codesstringHTTP agent LLD规则字段。以逗号分隔的HTTP要求的状态码范围。

事例: 200,200-{$M},{$M},200-400
templateidstring(只读)父模板LLD规则的ID。
timeoutstringHTTP agent LLD规则字段。Item数据轮训请求超时时间。支持用户宏。

默认: 3s
最大值: 60s
trapper_hostsstring允许的主机。用于trapper LLD规则或HTTP agent LLD规则。
usernamestring用户名进行身份验证。使用简单检查,SSH, Telnet,数据库监控,JMX和HTTP代理LLD规则。

SSH 和 Telnet LLD 规则要求。
verify_hostintegerHTTP agent LLD规则字段。URL中的主机名处于通用名称字段或主机证书的主题备用名称字段的合法性。

0 - (默认) 不验证.
1 - 验证.
verify_peerintegerHTTP agent LLD规则字段。主机认证证书合法性。

0 - (默认) 不验证.
1 - 验证.

LLD 规则 过滤器

LLD规则筛选器对象定义一套能被用于过滤器发现对象的条件。它包含如下属性:

属性类型说明
conditions
(必须)
array用于过滤结果的过滤条件集。
evaltype
(必须)
integer过滤条件评价方法。

取值:
0 - and/or;
1 - and;
2 - or;
3 - 自定义表达式.
eval_formulastring(只读) 生成的表达式,将用于计算筛选器条件。表达式包含通过其“formulaid”引用特定筛选条件的id。“eval_formula”的值等于带有自定义表达式的过滤器的“formula”的值。
formulastring用户定义的表达式,用于使用自定义表达式计算过滤器的条件。表达式必须包含通过其“formulaid”引用特定筛选条件的id。表达式中使用的id必须与过滤器条件中定义的id完全匹配:任何条件都不能被使用或省略。

自定义表达式筛选器所需。

LLD rule 过滤器条件

LLD规则过滤器条件对象定义对LLD宏的值执行的单独检查:

属性类型说明
macro
(必须)
string对LLD宏执行检查。
value
(必须)
string比较值
formulaidstring用于从自定义表达式引用条件的任意唯一ID。只能包含大写字母。在修改过滤条件时,ID必须由用户定义,但在请求之后,将重新生成ID。
operatorinteger条件运算符.

取值:
8 - (默认) 匹配正则表达式;
9 - 不匹配正则表达式.

更好地理解如何使用各种类型的表达式的过滤器, 参见 发现规则.查看发现规则.创建 方法页面.