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

主机对象

以下对象于主机API直接相关。

主机

主机对象具有以下属性。

属性 类型 描述
hostid ID 主机的ID

属性行为:
- 只读
- 更新操作时 必须 指定。
host string 主机的技术名称

属性行为:
- 创建操作时 必须 指定。
description text 主机的描述。
flags integer 主机的来源。

可能的值:
0 - 普通主机;
4 - 发现的主机.

属性行为:
- 只读
inventory_mode integer 主机资产清单的填充模式。

可能的值:
-1 - (默认) 关闭;
0 - 手动;
1 - 自动。
ipmi_authtype integer IPMI身份验证算法。

可能的值:
-1 - (默认) default;
0 - none;
1 - MD2;
2 - MD5
4 - straight;
5 - OEM;
6 - RMCP+.
ipmi_password string IPMI密码。
ipmi_privilege integer IPMI特权级别。

可能的值:
1 - callback;
2 - (默认) user;
3 - operator;
4 - admin;
5 - OEM.
ipmi_username string IPMI用户名。
maintenance_from timestamp 有效维护的开始时间。

属性行为:
- 只读
maintenance_status integer 有效的维护状态。

可能的值:
0 - (默认) no maintenance;
1 - maintenance in effect.

属性行为:
- 只读
maintenance_type integer 有效的维护类型。

可能的值:
0 - (默认) 有数据收集的维护;
1 - 没有数据收集的维护。

属性行为:
- 只读
maintenanceid ID 当前在主机上有效的维护的ID。

属性行为:
- 只读
name string 主机显示的名称。

默认: host 属性值。
monitored_by integer 监控主机的来源。

可能的值:
0 - (默认) Zabbix server;
1 - Proxy;
2 - Proxy group。
proxyid ID 监控主机的proxy的ID。

属性行为:
- 如果 monitored_by 指定为 "Proxy" 则 必须 指定。
proxy_groupid ID 监控主机的proxy组的ID。

属性行为:
- 如果 monitored_by 指定为 "Proxy group" 则 必须 指定。
status integer 主机的状态。

可能的值:
0 - (默认) 被监控的主机;
1 - 未被监控的主机。
tls_connect integer 主机的连接。

可能的值:
1 - (默认) 未加密;
2 - PSK;
4 - 证书。
tls_accept integer 来自主机的连接。
这是一个位掩码字段,可以接受任何可能的位图值组合。

可能的位图值:
1 - (默认) 未加密;
2 - PSK;
4 - 证书.
tls_issuer string 证书颁发者。
tls_subject string 证书主题。
tls_psk_identity string PSK标识。
不要将敏感信息放在PSK标识中,它是在未加密的情况下通过网络传输的,以通知接收器要使用哪个PSK。

属性行为:
- 只写
- 如果 tls_connect 指定为 "PSK" 或者 tls_accept 包含 "PSK" 则 必须 指定。
tls_psk string 预共享密钥,至少32位十六进制值。

属性行为:
- 只写
- 如果 tls_connect 指定为 "PSK" 或者 tls_accept 包含 "PSK" 则 必须 指定。
active_available integer 主机活动接口的可用状态。

可能的值:
0 -未知的接口状态;
1 - 接口可用;
2 - 接口不可用。

属性行为:
- 只读
assigned_proxyid ID 如果主机是被proxy组监控,则为Zabbix server分配的proxy的ID。

属性行为:
- 只读

主机资产清单

主机资产清单包含以下属性。

每个属性都有自己唯一的ID,用于将主机资产清单字段与监控项关联。

ID 属性 类型 描述 最大长度
4 alias string Alias. 128个字符
11 asset_tag string Asset tag. 64个字符
28 chassis string Chassis. 64个字符
23 contact string Contact person. 依赖于使用的数据库:
- SQL数据库使用65535个字符
- Oracle数据库使用2048个字符
32 contract_number string Contract number. 64个字符
47 date_hw_decomm string HW decommissioning date. 64个字符
46 date_hw_expiry string HW maintenance expiry date. 64个字符
45 date_hw_install string HW installation date. 64个字符
44 date_hw_purchase string HW purchase date. 64个字符
34 deployment_status string Deployment status. 64个字符
14 hardware string Hardware. 255个字符
15 hardware_full string Detailed hardware. 依赖于使用的数据库:
- SQL数据库使用65535个字符
- Oracle数据库使用2048个字符
39 host_netmask string Host subnet mask. 39个字符
38 host_networks string Host networks. 依赖于使用的数据库:
- SQL数据库使用65535个字符
- Oracle数据库使用2048个字符
40 host_router string Host router. 39个字符
30 hw_arch string HW architecture. 32个字符
33 installer_name string Installer name. 64个字符
24 location string Location. 依赖于使用的数据库:
- SQL数据库使用65535个字符
- Oracle数据库使用2048个字符
25 location_lat string Location latitude. 16个字符
26 location_lon string Location longitude. 16个字符
12 macaddress_a string MAC address A. 64个字符
13 macaddress_b string MAC address B. 64个字符
29 model string Model. 64 characters
3 name string Name. 128 characters
27 notes string Notes. 依赖于使用的数据库:
- SQL数据库使用65535个字符
- Oracle数据库使用2048个字符
41 oob_ip string OOB IP address. 39个字符
42 oob_netmask string OOB host subnet mask. 39个字符
43 oob_router string OOB router. 39个字符
5 os string OS name. 128个字符
6 os_full string Detailed OS name. 255个字符
7 os_short string Short OS name. 128个字符
61 poc_1_cell string Primary POC mobile number. 64个字符
58 poc_1_email string Primary email. 128个字符
57 poc_1_name string Primary POC name. 128个字符
63 poc_1_notes string Primary POC notes. 依赖于使用的数据库:
- SQL数据库使用65535个字符
- Oracle数据库使用2048个字符
59 poc_1_phone_a string Primary POC phone A. 64个字符
60 poc_1_phone_b string Primary POC phone B. 64个字符
62 poc_1_screen string Primary POC screen name. 64个字符
68 poc_2_cell string Secondary POC mobile number. 64个字符
65 poc_2_email string Secondary POC email. 128个字符
64 poc_2_name string Secondary POC name. 128个字符
70 poc_2_notes string Secondary POC notes. 依赖于使用的数据库:
- SQL数据库使用65535个字符
- Oracle数据库使用2048个字符
66 poc_2_phone_a string Secondary POC phone A. 64个字符
67 poc_2_phone_b string Secondary POC phone B. 64个字符
69 poc_2_screen string Secondary POC screen name. 64个字符
8 serialno_a string Serial number A. 64个字符
9 serialno_b string Serial number B. 64个字符
48 site_address_a string Site address A. 128个字符
49 site_address_b string Site address B. 128个字符
50 site_address_c string Site address C. 128个字符
51 site_city string Site city. 128个字符
53 site_country string Site country. 64个字符
56 site_notes string Site notes. 依赖于使用的数据库:
- SQL数据库使用65535个字符
- Oracle数据库使用2048个字符
55 site_rack string Site rack location. 128个字符
52 site_state string Site state. 64个字符
54 site_zip string Site ZIP/postal code. 64个字符
16 software string Software. 255个字符
18 software_app_a string Software application A. 64个字符
19 software_app_b string Software application B. 64个字符
20 software_app_c string Software application C. 64个字符
21 software_app_d string Software application D. 64个字符
22 software_app_e string Software application E. 64个字符
17 software_full string Software details. 依赖于使用的数据库:
- SQL数据库使用65535个字符
- Oracle数据库使用2048个字符
10 tag string Tag. 64个字符
1 type string Type. 64个字符
2 type_full string Type details. 64个字符
35 url_a string URL A. 2048个字符
36 url_b string URL B. 2048个字符
37 url_c string URL C. 2048个字符
31 vendor string Vendor. 64个字符

主机标签

主机标签对象有以下属性。

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

属性行为:
- 必须
value string 主机标签的值。
automatic integer 主机标签类型。

可能的值:
0 - (默认) 手动 (用户创建的标签);
1 - 自动 (低级别自动发现创建的标签)