2022 Zabbix中国峰会
2022 Zabbix中国峰会

连接器对象

以下对象与connector API直接相关。

连接器

连接器对象具有以下属性。

属性 类型 描述
connectorid ID 连接器的ID。

属性行为
- 只读
- 更新操作时必需
name string 连接器的名称。

属性行为
- 创建操作时必需
url string 端点URL,即接收器的URL。
支持用户宏。

属性行为
- 创建操作时必需
protocol integer 通信协议。

可能的值:
0 - (默认) Zabbix Streaming Protocol v1.0。
data_type integer 数据类型。

可能的值:
0 - (默认) 监控项值;
1 - 事件。
item_value_type integer 要发送的监控项值类型的总和。

可能的值:
1 - 数值(浮点数);
2 - 字符;
4 - 日志;
8 - 数值(无符号);
16 - 文本。

默认值:31 - 所有监控项类型。

属性行为
- 如果data_type设置为"监控项值",则支持
max_records integer 单条消息中可以发送的最大事件或监控项数。

可能的值:0-2147483647(32位有符号整数的最大值)。

默认值:0 - 不限制。
max_senders integer 此连接器的发送进程数。

可能的值:1-100。

默认值:1。
max_attempts integer 尝试次数。

可能的值:1-5。

默认值:1。
attempt_interval string 重试尝试之间的间隔。
接受秒为单位。

可能值:0s-10s。

默认值:5s。

属性行为
- 如果max_attempts大于1,则支持
timeout string 超时。
支持时间后缀(例如,30s,1m)。
支持用户宏。

可能值:1s-60s。

默认值:5s。
http_proxy string HTTP(S)代理连接字符串,格式为
[protocol]://[username[:password]@]proxy.example.com[:port]

支持用户宏。
authtype integer HTTP身份验证方法。

可能值:
0 - (默认) 无;
1 - Basic;base64 编码凭据。
2 - NTLM;
3 - Kerberos;
4 - Digest;Firefox 93 及更高版本支持 SHA-256 算法。以前的版本仅支持 MD5 散列(不建议)。
5 - Bearer。bearer 令牌通过 OAuth 2.0 保护资源。
username string 用户名。
支持用户宏。

属性行为
- 如果authtype设置为"Basic","NTLM","Kerberos"或"Digest",则支持
password string 密码。
支持用户宏。

属性行为
- 如果authtype设置为"Basic","NTLM","Kerberos"或"Digest",则支持
token string Bearer令牌。
支持用户宏。

属性行为
- 如果authtype设置为"Bearer",则必需
verify_peer integer 验证主机的证书是否真实。

可能的值:
0 - 不验证;
1 - (默认) 验证。
verify_host integer 验证连接的主机名是否与主机证书中的主机名匹配。

可能的值:
0 - 不验证;
1 - (默认) 验证。
ssl_cert_file string SSL公钥文件路径。
支持用户宏。
ssl_key_file string SSL私钥文件路径。
支持用户宏。
ssl_key_password string SSL密钥文件的密码。
支持用户宏。
description text 连接器的描述。
status integer 连接器是否启用。

可能的值:
0 - 禁用;
1 - (默认) 启用。
tags_evaltype integer 标签评估方法。

可能的值:
0 - (默认) 并且/或者;
2 - 或者。

标签过滤

标签过滤允许仅导出匹配的监控项值或事件。如果未设置,则将导出所有内容。 标签过滤对象具有以下属性。

属性 类型 描述
tag string 标签名称。

属性行为:
- 必填
operator integer 条件运算符。

可能的值:
0 - (默认) 等于;
1 - 不等于;
2 - 包含;
3 - 不包含;
12 - 存在;
13 - 不存在。
value string 标签值。