连接器对象

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

连接器

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

Property Type Description
connectorid ID 连接器的 ID。

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

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

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

可能的值:
0 - (默认) Zabbix 流式传输协议 v1.0。
data_type integer 数据类型。

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

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

默认值:31 - 所有监控项类型(不包括二进制和 JSON)。

属性行为
- 当 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) proxy 连接字符串,格式为
[protocol]://[username[:password]@]proxy.example.com[:port]

支持用户宏。
authtype integer HTTP 认证方法。

可能的值:
0 - (默认) 无;
1 - Basic;
2 - NTLM;
3 - Kerberos;
4 - Digest;
5 - Bearer。
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 - (默认) And/Or;
2 - Or。

标签过滤器

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

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

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

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