[comment]: # ({8b893994-ae6d2ebd}) # 4 主机 [comment]: # ({/8b893994-ae6d2ebd}) [comment]: # ({45b081d7-907c3faa}) #### 概述主机具有 [exported](/manual/xml_export_import)，并包含许多相关的 objects 和 object 关系。主机 export 包含： - 已链接 [host groups](/manual/xml_export_import/hostgroups) - 主机数据 - 模板链接 - 主机组链接 - 主机接口 - 直接关联的监控项 - 直接关联的触发器 - 直接关联的发现规则与所有原型 - 直接关联的网络场景 - 主机宏 - 主机清单数据 - 值映射 - 已链接 [主机图形](/manual/xml_export_import/hosts#主机图形) [comment]: # ({/45b081d7-907c3faa}) [comment]: # ({ec949d61-55d6da26}) #### 导出要export 主机，请执行以下操作： 1. 转到 *数据采集* → *主机*。 2. 选中要导出的主机对应的复选框。 3. 点击列表下方的*导出*。 ![](../../../assets/en/manual/xml_export_import/export_hosts.png) 根据所选格式，主机将被导出到本地file，默认文件名如下： - `zabbix_export_hosts.yaml` - 采用YAMLexport（导出的默认选项）； - `zabbix_export_hosts.xml` - 采用XML导出； - `zabbix_export_hosts.json` - 采用JSON导出。 [comment]: # ({/ec949d61-55d6da26}) [comment]: # ({d8090da8-158cdcbf}) #### 导入要 import 主机，请执行以下操作： 1. 转到 *数据采集* → *主机*。 2. 在Top右上角点击 *导入*。 3. 选择import文件。 4. 在配置表单的右下角点击 *导入*。 ![](../../../assets/en/manual/xml_export_import/import_hosts.png){width="600"} 如果您勾选 *高级选项* 复选框，将会显示所有可导入元素的详细列表 - 根据需要勾选或取消勾选每个import规则。如果您勾选 *全部* 行中的复选框，该行下方的所有元素都将被勾选/取消勾选。导入规则： | 规则 | 描述 | |----|-----------| | *更新现有* | 将使用来自import文件的数据更新现有元素。否则，它们将不会被更新。 | | *创建新项* | 将使用来自import文件的数据创建新元素。否则，它们将不会被创建。 | | *删除缺失项* | 不在import file中存在的现有元素将被移除。否则，它们将不会被移除。
如果为*模板链接*勾选*删除缺失项*，当前不在import file中的模板链接将被解除链接。从解除链接的模板继承的实体（监控项、触发器、图形等）不会被移除（除非也为每个实体选择了*删除缺失项*选项）。 | import的成功或失败消息将在前端显示。 [comment]: # ({/d8090da8-158cdcbf}) [comment]: # ({25e93578-93059e09}) #### 导出格式 YAML格式导出示例： ```yaml zabbix_export: version: '7.0' host_groups: - uuid: f2481361f99448eea617b7b1d4765566 name: 'Discovered hosts' - uuid: 6f6799aa69e844b4b3918f779f2abf08 name: 'Zabbix servers' hosts: - host: 'Zabbix server 1' name: 'Main Zabbix server' monitored_by: 'SERVER' templates: - name: 'Linux by Zabbix agent' - name: 'Zabbix server health' groups: - name: 'Discovered hosts' - name: 'Zabbix servers' interfaces: - ip: 192.168.1.1 interface_ref: if1 items: - name: 'Zabbix trap' type: TRAP key: trap delay: '0' history: 1w preprocessing: - type: MULTIPLIER parameters: - '8' tags: - tag: component value: 'raw' triggers: - expression: 'last(/Zabbix server 1/trap)=0' name: 'Last value is zero' priority: WARNING tags: - tag: scope value: 'availability' tags: - tag: service value: zabbix-server macros: - macro: '{$HOST.MACRO}' value: '123' - macro: '{$PASSWORD1}' type: SECRET_TEXT inventory: type: 'Zabbix server' name: yyyyyy-HP-Pro-3010-Small-Form-Factor-PC os: 'Linux yyyyyy-HP-Pro-3010-Small-Form-Factor-PC 4.4.0-165-generic #193-Ubuntu SMP Tue Sep 17 17:42:52 UTC 2019 x86_64' inventory_mode: AUTOMATIC graphs: - name: 'CPU utilization server' show_work_period: 'NO' show_triggers: 'NO' graph_items: - drawtype: FILLED_REGION color: FF5555 item: host: 'Zabbix server 1' key: 'system.cpu.util[,steal]' - sortorder: '1' drawtype: FILLED_REGION color: 55FF55 item: host: 'Zabbix server 1' key: 'system.cpu.util[,softirq]' - sortorder: '2' drawtype: FILLED_REGION color: '009999' item: host: 'Zabbix server 1' key: 'system.cpu.util[,interrupt]' - sortorder: '3' drawtype: FILLED_REGION color: '990099' item: host: 'Zabbix server 1' key: 'system.cpu.util[,nice]' - sortorder: '4' drawtype: FILLED_REGION color: '999900' item: host: 'Zabbix server 1' key: 'system.cpu.util[,iowait]' - sortorder: '5' drawtype: FILLED_REGION color: '990000' item: host: 'Zabbix server 1' key: 'system.cpu.util[,system]' - sortorder: '6' drawtype: FILLED_REGION color: '000099' calc_fnc: MIN item: host: 'Zabbix server 1' key: 'system.cpu.util[,user]' - sortorder: '7' drawtype: FILLED_REGION color: '009900' item: host: 'Zabbix server 1' key: 'system.cpu.util[,idle]' ``` [comment]: # ({/25e93578-93059e09}) [comment]: # ({647dd50a-2c61d3f8}) ## 导出的元素导出的元素在下面的表格中进行说明。 | 元素 | < | 类型 | 描述 | |-|---|---|-----------------------| | version | < | string | （必需）Zabbix 版本。 | | host_groups | < | | （必需）主机组的根元素。 | | < | uuid | string | （必需）此主机组的唯一标识符。 | | ^ | name | string | （必需）主机组名称。 | | hosts | < | | [主机](#主机) 的根元素。 | [comment]: # ({/647dd50a-2c61d3f8}) [comment]: # ({0908afaa-eedfe2b9}) ### 主机 | 元素 | < | 类型 | 描述 | |-|---|---|-----------------------| | host | < | string | (必填) 唯一主机名。 | | name | < | string | 可见主机名。 | | description | < | text | 主机描述。 | | monitored_by | < | string | 主机监控方式: SERVER, PROXY, 或 PROXY_GROUP。 | | proxy | < | | proxy的根元素。 | | | name | string | (必填) 监控主机的proxy名称(如有)。 | | proxy_group | < | | proxy 组的根元素。 | | | name | string | (必填) 用于监控主机的proxy 组名称(如有)。 | | status | < | string | 主机状态。
可能值:^[1](#footnotes)^ ENABLED (0, 默认), DISABLED (1)。 | | ipmi\_authtype | < | string | IPMI会话认证类型。
可能值:^[1](#footnotes)^ DEFAULT (-1, 默认), NONE (0), MD2 (1), MD5 (2), STRAIGHT (4), OEM (5), RMCP\_PLUS (6)。 | | ipmi\_privilege | < | string | IPMI会话权限级别。
可能值:^[1](#footnotes)^ CALLBACK (1), USER (2, 默认), OPERATOR (3), ADMIN (4), OEM (5)。 | | ipmi\_username | < | string | IPMI检查用户名。 | | ipmi\_password | < | string | IPMI检查密码。 | | templates | < | | 关联模板的根元素。 | | | name | string | (必填) 模板名称。 | | groups | < | | 主机所属的主机组根元素。 | | | name | string | (必填) 主机组名称。 | | interfaces | < | | [主机接口](#主机-interfaces)的根元素。 | | items | < | | [主机监控项](#主机-监控项)的根元素。 | | discovery_rules | < | | [主机低级发现规则](#主机-low-level-discovery-rules)的根元素。 | | http_tests | < | | [主机Web场景](#主机-web-scenarios)的根元素。 | | tags | < | | 主机标签的根元素。 | | < | tag | string | (必填) 标签名称。 | | ^ | value | string | 标签值。 | | macros | < | | 主机宏的根元素。 | | < | macro | string | (必填) 用户宏名称。 | | ^ | type | string | 用户宏类型。
可能值:^[1](#footnotes)^ TEXT (0, 默认), SECRET\_TEXT (1), VAULT (2)。 | | ^ | value | string | 用户宏值。 | | ^ | description | string | 用户宏描述。 | | inventory | < | | 主机资产清单的根元素。 | | | | string | 资产清单属性。所有属性都有对应的元素(`type`, `name`, `os`等；例如参见[导出格式](#export-format))。 | | inventory\_mode | < | string | 资产清单模式。
可能值:^[1](#footnotes)^ DISABLED (-1), MANUAL (0, 默认), AUTOMATIC (1)。 | | valuemaps | < | | [主机值映射](#主机-value-maps)的根元素。 | ::: noteclassic 另请参阅: [Host object](/manual/api/reference/host/object) (参考具有匹配名称的相关属性)。 ::: [comment]: # ({/0908afaa-eedfe2b9}) [comment]: # ({5f212fe4-c8da7bba}) #### 主机接口 | 元素 | < | 类型 | 描述 | |-|---|---|-----------------------| | default | < | string | 是否为主机的主接口。注意，每个一个主机只能有一个主接口类型。
可能值:^[1](#footnotes)^ 否 (0)，是 (1, 默认)。 | | type | < | string | 接口类型。
可能值:^[1](#footnotes)^ ZABBIX (1, 默认), SNMP (2), IPMI (3), JMX (4)。 | | useip | < | string | 是否使用IP作为连接主机的接口（否则将使用DNS）。
可能值:^[1](#footnotes)^ 否 (0)，是 (1, 默认)。 | | ip | < | string | （IP连接时必需）IP地址（IPv4或IPv6）。 | | dns | < | string | （DNS连接时必需）DNS名称。 | | port | < | string | 端口号。 | | details | < | | 接口详细信息的根元素。 | | < | version | string | 使用的SNMP版本。
可能值:^[1](#footnotes)^ SNMPV1 (1), SNMP\_V2C (2, 默认), SNMP\_V3 (3)。 | | ^ | community | string | （SNMPv1和SNMPv2 监控项时必需）SNMP团体名。 | | ^ | max_repetitions | string | 原生SNMP批量请求（GetBulkRequest-PDUs）的最大重复值。
适用于SNMPv2和SNMPv3 监控项（`discovery[]` 和 `walk[]` 监控项）。
默认值: 10。 | | ^ | contextname | string | SNMPv3上下文名称。
适用于SNMPv3 监控项。 | | ^ | securityname | string | SNMPv3安全名称。
适用于SNMPv3 监控项。 | | ^ | securitylevel | string | SNMPv3安全级别。
适用于SNMPv3 监控项。
可能值:^[1](#footnotes)^ NOAUTHNOPRIV (0, 默认), AUTHNOPRIV (1), AUTHPRIV (2)。 | | ^ | authprotocol | string | SNMPv3认证协议。
适用于SNMPv3 监控项。
可能值:^[1](#footnotes)^ MD5 (0, 默认), SHA1 (1), SHA224 (2), SHA256 (3), SHA384 (4), SHA512 (5)。 | | ^ | authpassphrase | string | SNMPv3认证口令。
适用于SNMPv3 监控项。 | | ^ | privprotocol | string | SNMPv3隐私协议。
适用于SNMPv3 监控项。
可能值:^[1](#footnotes)^ DES (0, 默认), AES128 (1), AES192 (2), AES256 (3), AES192C (4), AES256C (5)。 | | ^ | privpassphrase | string | SNMPv3隐私口令。
适用于SNMPv3 监控项。 | | ^ | bulk | string | 对SNMP使用批量请求。
可能值:^[1](#footnotes)^ 否 (0)，是 (1, 默认)。 | | interface\_ref | < | string | 在监控项中使用的接口引用名称（格式：`if`）。 | ::: noteclassic 另请参阅：[Host interface object](/manual/api/reference/hostinterface/object)（参考具有匹配名称的相关属性）。 ::: [comment]: # ({/5f212fe4-c8da7bba}) [comment]: # ({11a71dce-8a2e4e2f}) #### 主机监控项 |Element|<|Type|Description| |-|---|---|-----------------------| |name|<|string|(required) 监控项名称。| |type|<|string|监控项类型。
Possible values:^[1](#footnotes)^ ZABBIX\_PASSIVE (0, default), TRAP (2), SIMPLE (3), INTERNAL (5), ZABBIX\_ACTIVE (7), EXTERNAL (10), ODBC (11), IPMI (12), SSH (13), TELNET (14), CALCULATED (15), JMX (16), SNMP\_TRAP (17), DEPENDENT (18), HTTP\_AGENT (19), SNMP\_AGENT (20), ITEM\_TYPE\_SCRIPT (21), ITEM\_TYPE\_BROWSER (22).| |snmp\_oid|<|string|(required for SNMP\_AGENT items) SNMP 对象 ID。| |key|<|string|(required) 监控项键值。| |delay|<|string|监控项的更新间隔。
Default: 1m. The value will always be 0 for TRAP items.| |history|<|string|历史数据的保存时长（使用 [time suffix](/manual/appendix/suffixes#time-suffixes)、[user macro](/manual/config/macros/user_macros) 或 [LLD macro](/manual/config/macros/lld_macros)）。
Default: 31d.| |trends|<|string|趋势数据的保存时长（使用 [time suffix](/manual/appendix/suffixes#time-suffixes)、[user macro](/manual/config/macros/user_macros) 或 [LLD macro](/manual/config/macros/lld_macros)）。
Default: 365d.| |status|<|string|监控项状态。
Possible values:^[1](#footnotes)^ ENABLED (0, default), DISABLED (1).| |value\_type|<|string|接收值的类型。
Possible values:^[1](#footnotes)^ FLOAT (0), CHAR (1), LOG (2), UNSIGNED (3, default), TEXT (4), BINARY (5).| |allowed\_hosts|<|string|允许向该监控项发送数据的主机 IP 地址列表，以逗号分隔。
Supported for TRAP and HTTP\_AGENT items.| |units|<|string|接收值的单位（bps、B 等）。| |params|<|text|根据监控项类型而定的附加参数（SSH 和 TELNET 监控项执行的脚本；ODBC 监控项的 SQL 查询；CALCULATED 监控项的公式；ITEM\_TYPE\_SCRIPT 和 ITEM\_TYPE\_BROWSER 监控项的脚本）。| |ipmi\_sensor|<|string|IPMI 传感器。
Supported for IPMI items.| |authtype|<|string|认证类型。
Supported for SSH and HTTP\_AGENT items.
Possible values for SSH items:^[1](#footnotes)^ PASSWORD (0, default), PUBLIC\_KEY (1).
Possible values for HTTP\_AGENT items:^[1](#footnotes)^ NONE (0, default), BASIC (1), NTLM (2), Kerberos (3), or Digest (4).| |username|<|string|(required for SSH and TELNET items) 认证用户名。
Supported for SIMPLE, ODBC, JMX and HTTP\_AGENT items.
When used for JMX items, `password` (see below) should also be specified or both elements should be left blank.| |password|<|string|(required for SSH and TELNET items) 认证密码。
Supported for SIMPLE, ODBC, JMX and HTTP\_AGENT items.
When used for JMX items, `username` (see above) should also be specified or both elements should be left blank.| |publickey|<|string|(required for SSH items) 公钥文件名。| |privatekey|<|string|(required for SSH items) 私钥文件名。| |description|<|text|监控项描述。| |inventory\_link|<|string|由该监控项填充的主机清单字段。
Possible values:^[1](#footnotes)^ NONE (0), ALIAS (4), etc. (see [Host inventory](/manual/api/reference/host/object#host-inventory) for supported fields).| |valuemap|<| |监控项值映射的根元素。| | |name|string|(required) 监控项使用的值映射名称。| |logtimefmt|<|string|日志条目中的时间格式。
Supported for items of LOG value type.| |preprocessing|<| |监控项值预处理的根元素。| | |step| |[主机监控项值预处理步骤](#host-item-value-preprocessing-steps) 的根元素。| |interface\_ref|<|string|主机接口引用（格式：`if`）。| |jmx\_endpoint|<|string|JMX 端点。
Supported for JMX items.| |master_item|<| |(required for DEPENDENT items) 依赖项主监控项的根元素。| | |key|string|(required) 依赖项主监控项键值。| |timeout|<|string|监控项数据轮询请求超时时间。
Supported for the [Timeouts](/manual/web_interface/frontend_sections/administration/general#timeouts) list of item types.| |url|<|string|(required for HTTP\_AGENT items) URL 字符串。| |query_fields|<| |查询参数的根元素。
Supported for HTTP\_AGENT items.| |<|name|string|(required for HTTP\_AGENT items) 查询参数名称。| |^|value|string|查询参数值。
Supported for HTTP\_AGENT items.| |parameters|<| |用户自定义参数的根元素。
Supported for ITEM\_TYPE\_SCRIPT and ITEM\_TYPE\_BROWSER items.| |<|name|string|(required for ITEM\_TYPE\_SCRIPT and ITEM\_TYPE\_BROWSER items) 用户自定义参数名称。| |^|value|string|用户自定义参数值。
Supported for ITEM\_TYPE\_SCRIPT and ITEM\_TYPE\_BROWSER items.| |posts|<|string|HTTP(S) 请求正文数据。
Supported for HTTP\_AGENT items.| |status\_codes|<|string|所需 HTTP 状态码范围，以逗号分隔。
Supported for HTTP\_AGENT items.| |follow\_redirects|<|string|轮询数据时跟随响应重定向。
Supported for HTTP\_AGENT items.
Possible values:^[1](#footnotes)^ NO (0), YES (1, default).| |post\_type|<|string|POST 数据正文类型。
Supported for HTTP\_AGENT items.
Possible values:^[1](#footnotes)^ RAW (0, default), JSON (2), XML (3).| |http\_proxy|<|string|HTTP(S) proxy 连接字符串。
Supported for HTTP\_AGENT items.| |headers|<| |HTTP(S) 请求头的根元素。
Supported for HTTP\_AGENT items.| |<|name|string|(required for HTTP\_AGENT items) 请求头名称。| |^|value|string|(required for HTTP\_AGENT items) 请求头值。| |retrieve\_mode|<|string|应保存响应的哪一部分。
Supported for HTTP\_AGENT items.
Possible values:^[1](#footnotes)^ BODY (0, default), HEADERS (1), BOTH (2).| |request\_method|<|string|请求方法类型。
Supported for HTTP\_AGENT items.
Possible values:^[1](#footnotes)^ GET (0, default), POST (1), PUT (2), HEAD (3).| |output\_format|<|string|如何处理响应。
Supported for HTTP\_AGENT items.
Possible values:^[1](#footnotes)^ RAW (0, default), JSON (1).| |allow\_traps|<|string|允许像 trapper 监控项一样填充值。
Supported for HTTP\_AGENT items.
Possible values:^[1](#footnotes)^ NO (0, default), YES (1).| |ssl\_cert\_file|<|string|公用 SSL 密钥文件路径。
Supported for HTTP\_AGENT items.| |ssl\_key\_file|<|string|私有 SSL 密钥文件路径。
Supported for HTTP\_AGENT items.| |ssl\_key\_password|<|string|SSL 密钥文件密码。
Supported for HTTP\_AGENT items.| |verify\_peer|<|string|是否验证主机证书是否真实有效。
Supported for HTTP\_AGENT items.
Possible values:^[1](#footnotes)^ NO (0, default), YES (1).| |verify\_host|<|string|是否验证连接所用主机名是否与主机证书中的名称匹配。
Supported for HTTP\_AGENT items.
Possible values:^[1](#footnotes)^ NO (0, default), YES (1).| |tags|<| |监控项标签的根元素。| |<|tag|string|(required) 标签名称。| |^|value|string|标签值。| |triggers|<| |[主机监控项触发器](#host-item-triggers) 的根元素。| ::: noteclassic 另请参见：[监控项对象](/manual/api/reference/item/object)（请参考名称匹配的相关属性）。 ::: [comment]: # ({/11a71dce-8a2e4e2f}) [comment]: # ({4928b4c6-f0f3fd08}) ##### 主机监控项值预处理步骤 | 元素 | < | 类型 | 描述 | |-|---|---|-----------------------| | type | < | string | （必填）监控项值预处理步骤的类型。
可能的值：^[1](#footnotes)^ MULTIPLIER（1）、RTRIM（2）、LTRIM（3）、TRIM（4）、REGEX（5）、BOOL\_TO\_DECIMAL（6）、OCTAL\_TO\_DECIMAL（7）、HEX\_TO\_DECIMAL（8）、SIMPLE\_CHANGE（9，计算方式：接收值 - 上一个值）、CHANGE\_PER\_SECOND（10，计算方式：(接收值 - 上一个值)/(当前时间 - 上次检查时间)）、XMLPATH（11）、JSONPATH（12）、IN\_RANGE（13）、MATCHES\_REGEX（14）、NOT\_MATCHES\_REGEX（15）、CHECK\_JSON\_ERROR（16）、CHECK\_XML\_ERROR（17）、CHECK\_REGEX\_ERROR（18）、DISCARD\_UNCHANGED（19）、DISCARD\_UNCHANGED\_HEARTBEAT（20）、JAVASCRIPT（21）、PROMETHEUS\_PATTERN（22）、PROMETHEUS\_TO\_JSON（23）、CSV\_TO\_JSON（24）、STR\_REPLACE（25）、CHECK\_NOT\_SUPPORTED（26）、XML\_TO\_JSON（27）、SNMP\_WALK\_VALUE（28）、SNMP\_WALK\_TO\_JSON（29）、SNMP\_GET\_VALUE（30）。 | | parameters | < | | （必填）监控项值预处理步骤参数的根元素。 | | | 参数 | string | 监控项值预处理步骤的单个参数。 | | error\_handler | < | string | 预处理步骤失败时使用的动作类型。
可能的值：^[1](#footnotes)^ ORIGINAL\_ERROR（0，默认）、DISCARD\_VALUE（1）、CUSTOM\_VALUE（2）、CUSTOM\_ERROR（3）。 | | error\_handler\_params | < | string | 错误处理程序参数。 | ::: noteclassic 另请参见：[预处理](/manual/api/reference/item/object#预处理)（参考具有匹配名称的相关属性）。 ::: [comment]: # ({/4928b4c6-f0f3fd08}) [comment]: # ({6fddf74c-5ff5f79a}) ##### 主机监控项触发器 | 元素 | < | 类型 | 描述 | |-|---|---|-----------------------| | uuid | < | string | （必填）此触发器的唯一标识符。 | | expression | < | string | （必填）触发器表达式。 | | recovery\_mode | < | string | 生成OK事件的基础。
可能的值：^[1](#footnotes)^ EXPRESSION（0，默认），RECOVERY\_EXPRESSION（1），NONE（2）。 | | recovery\_expression | < | string | 触发器恢复表达式。 | | correlation\_mode | < | string | 关联模式（无事件关联或按标签进行事件关联）。
可能的值：^[1](#footnotes)^ DISABLED（0，默认），TAG\_VALUE（1）。 | | correlation\_tag | < | string | 用于事件关联的标签名称。 | | name | < | string | （必填）触发器名称。 | | event\_name | < | string | 事件名称。 | | opdata | < | string | 操作数据。 | | url\_name | < | string | 与触发器关联的URL标签。 | | url | < | string | 与触发器关联的URL。 | | status | < | string | 触发器状态。
可能的值：^[1](#footnotes)^ ENABLED（0，默认），DISABLED（1）。 | | priority | < | string | 触发器严重程度。
可能的值：^[1](#footnotes)^ NOT\_CLASSIFIED（0，默认），INFO（1），WARNING（2），AVERAGE（3），HIGH（4），DISASTER（5）。 | | description | < | text | 触发器描述。 | | type | < | string | 事件生成类型（单个问题事件或多个问题事件）。
可能的值：^[1](#footnotes)^ SINGLE（0，默认），MULTIPLE（1）。 | | manual\_close | < | string | 问题事件的手动关闭。
可能的值：^[1](#footnotes)^ NO（0，默认），YES（1）。 | | dependencies | < | | 依赖关系的根元素。 | | < | name | string | （必填）依赖触发器名称。 | | ^ | expression | string | （必填）依赖触发器表达式。 | | ^ | recovery\_expression | string | 依赖触发器恢复表达式。 | | tags | < | | 触发器标签的根元素。 | | < | tag | string | （必填）标签名称。 | | ^ | value | string | 标签值。 | ::: noteclassic 另请参见：[Trigger object](/manual/api/reference/trigger/object)（参考具有匹配名称的相关属性）。 ::: [comment]: # ({/6fddf74c-5ff5f79a}) [comment]: # ({df622d27-19e8eae6}) #### 主机低级别自动发现规则 ::: noteimportant 大多数主机低级别自动发现规则元素与 [主机监控项](#主机-监控项) 中的相同。下表描述了与主机监控项不同的元素。 ::: | 元素 | < | 类型 | 描述 | |-|---|---|-----------------------| | type | < | string | 监控项类型。
可能的值：^[1](#footnotes)^ ZABBIX\_PASSIVE（0，默认），TRAP（2），SIMPLE（3），INTERNAL（5），ZABBIX\_ACTIVE（7），EXTERNAL（10），ODBC（11），IPMI（12），SSH（13），TELNET（14），JMX（16），DEPENDENT（18），HTTP\_AGENT（19），SNMP\_AGENT（20），监控项\_TYPE\_SCRIPT（21），监控项\_TYPE\_BROWSER（22）。 | | key | < | string | （必填）低级别自动发现规则的键值。 | | filter | < | | [主机低级别自动发现规则过滤器](#主机-low-level-discovery-rule-filters) 的根元素。 | | lifetime | < | string | 经过指定时间（以秒为单位，[时间后缀](/manual/appendix/suffixes#时间后缀) 或 [user macro](/manual/config/macros/user_macros)）后，不再发现的资源将被删除。
默认值：7d。 | | lifetime_type | < | string | 删除丢失的LLD资源的场景。
可能的值：DELETE\_NEVER，DELETE\_IMMEDIATELY，DELETE\_AFTER。 | | enabled_lifetime | < | string | 经过指定时间（以秒为单位，[时间后缀](/manual/appendix/suffixes#时间后缀) 或 [user macro](/manual/config/macros/user_macros)）后，不再发现的资源将被禁用。 | | enabled_lifetime_type | < | string | 禁用丢失的LLD资源的场景。
可能的值：DISABLE\_NEVER，DISABLE\_IMMEDIATELY，DISABLE\_AFTER。 | | item\_prototypes | < | | 主机监控项原型元素的根元素，其与 [主机监控项](#主机-监控项) 中的相同。 | | trigger\_prototypes | < | | 主机触发器原型元素的根元素，其与 [主机监控项触发器](#主机-监控项-triggers) 中的相同。 | | graph\_prototypes | < | | 主机图形原型的根元素，其与 [主机图形](#主机-graphs) 中的相同。 | | host\_prototypes | < | | 主机原型的根元素，其与 [主机](#主机) 中的相同。 | | master_item | < | string | （对于DEPENDENT规则必填）依赖规则主监控项的根元素。 | | lld\_macro\_paths | < | | 低级别自动发现规则宏路径的根元素。 | | < | lld\_macro | string | （必填）低级别自动发现规则宏名称。 | | ^ | path | string | （必填）值的选择器，将被分配给相应的宏。 | | preprocessing | < | | 低级别自动发现规则值预处理的根元素。 | | | step | | 低级别自动发现规则值预处理步骤元素的根元素，其与 [主机监控项值预处理步骤](#主机-监控项-preprocessing-steps) 中的相同，但可能值较少。另请参见：[lld-规则预处理](/manual/api/reference/discoveryrule/object#lld-规则预处理)。 | | overrides | < | | 低级别自动发现规则覆盖规则的根元素。 | | < | name | string | （必填）唯一的覆盖名称。 | | ^ | step | string | （必填）覆盖的唯一顺序号。 | | ^ | stop | string | 如果匹配，则停止处理后续覆盖。 | | ^ | filter | | 低级别自动发现规则覆盖规则过滤器元素的根元素，其与 [主机低级别自动发现规则过滤器](#主机-low-level-discovery-rule-filters) 中的相同。 | | ^ | operations | | [主机低级别自动发现规则覆盖操作](#主机-low-level-discovery-rule-override-operations) 的根元素。 | ::: noteclassic 另请参见：[LLD rule object](/manual/api/reference/discoveryrule/object)（请参考具有匹配名称的相关属性）。 ::: [comment]: # ({/df622d27-19e8eae6}) [comment]: # ({0d030aaa-a75b2d66}) ##### 主机低级别自动发现规则过滤器 | 元素 | < | 类型 | 说明 | |-|---|---|-----------------------| | evaltype | < | string | 覆盖过滤条件评估方法。
可能的值：^[1](#footnotes)^ AND\_OR（0，默认），AND（1），OR（2），FORMULA（3）。 | | formula | < | string | 过滤条件的自定义计算公式。 | | conditions | < | | 过滤条件的根元素。 | | < | macro | string | （必填）要执行检查的低级别发现宏的名称。 | | ^ | value | string | 要比较的值。 | | ^ | operator | string | 条件运算符。
可能的值：^[1](#footnotes)^ MATCHES\_REGEX（8，默认），NOT\_MATCHES\_REGEX（9）。 | | ^ | formulaid | string | （必填）用于从自定义表达式中引用条件的任意唯一ID。只能包含大写字母。该ID在修改过滤条件时由用户定义，但在之后请求条件时将重新生成。 | ::: noteclassic 另请参阅：[lld-规则过滤器](/manual/api/reference/discoveryrule/object#lld-规则过滤器)（参考具有匹配名称的相关属性）。 ::: [comment]: # ({/0d030aaa-a75b2d66}) [comment]: # ({f62c5cea-77148deb}) ##### 主机低级别自动发现规则覆盖操作 | 元素 | < | 类型 | 描述 | |-|---|---|-----------------------| | operationobject | < | string | 操作所应用的object。
可能的值：^[1](#footnotes)^ ITEM_PROTOTYPE (0), TRIGGER_PROTOTYPE (1), GRAPH_PROTOTYPE (2), HOST_PROTOTYPE (3)。 | | operator | < | string | 覆盖条件运算符。
可能的值：^[1](#footnotes)^ EQUAL (1), NOT_EQUAL (2), LIKE (3), NOT_LIKE (4), REGEXP (5), NOT_REGEXP (6)。 | | value | < | string | 覆盖条件运算符的正则表达式或string。 | | status | < | string | 覆盖操作期间object的状态。 | | discover | < | string | object是否由于发现而添加。 | | delay | < | string | 覆盖操作期间为监控项原型设置的更新间隔。 | | history | < | string | 覆盖操作期间为监控项原型设置的历史存储周期。 | | trends | < | string | 覆盖操作期间为监控项原型设置的趋势存储周期。 | | severity | < | string | 覆盖操作期间为触发器原型设置的严重性。 | | tags | < | | 覆盖操作期间为object设置的标签的根元素。 | | < | 标签 | string | （必填）标签名称。 | | ^ | 值 | string | 标签值。 | | templates | < | | 覆盖操作期间链接到主机原型的模板的根元素。 | | | 名称 | string | （必填）模板名称。 | | inventory_mode | < | string | 覆盖操作期间为主机原型设置的资产清单模式。 | ::: noteclassic 另请参阅：[lld-规则覆盖操作](/manual/api/reference/discoveryrule/object#lld-规则覆盖操作)（请参考名称匹配的相关属性）。 ::: [comment]: # ({/f62c5cea-77148deb}) [comment]: # ({776aa762-cae5eb15}) #### 主机 web 场景 |Element|<|Type|Description| |-|---|---|-----------------------| |uuid|<|string|(必填) 此 web 场景的唯一标识符。| |name|<|string|(必填) web 场景名称。| |delay|<|string>执行 web 场景的频率（使用秒、[时间后缀](/manual/appendix/suffixes#time-suffixes)或[用户宏](/manual/config/macros/user_macros)）。
默认值：1m。| |attempts|<|integer>执行 web 场景步骤的尝试次数。
可能的值：1-10（默认值：1）。| |agent|<|string>客户端 agent。Zabbix 将伪装成所选浏览器。
当网站针对不同浏览器返回不同内容时，这很有用。
默认值：Zabbix。| |http\_proxy|<|string>web 场景将使用的 proxy，格式为：`http://[username[:password]@]proxy.example.com[:port]`| |variables|<| |web 场景变量的根元素，这些变量可在场景步骤中使用。| |<|name|string|(必填) 变量名称。| |^|value|text|(必填) 变量值。| |headers|<| |发送请求时要使用的 HTTP 标头根元素。
标头应使用与 HTTP 协议中相同的语法列出。| |<|name|string|(必填) 标头名称。| |^|value|text|(必填) 标头值。| |status|<|string>web 场景状态。
可能的值：^[1](#footnotes)^ ENABLED (0, default), DISABLED (1).| |authentication|<|string>认证方法。
可能的值：^[1](#footnotes)^ NONE (0, default), BASIC (1), NTLM (2), Kerberos (3), or Digest (4).| |http\_user|<|string>用于 BASIC (HTTP)、NTLM、Kerberos 或 Digest 认证的用户名。| |http\_password|<|string>用于 BASIC (HTTP)、NTLM、Kerberos 或 Digest 认证的密码。| |verify\_peer|<|string>验证 web 服务器的 SSL 证书。
可能的值：^[1](#footnotes)^ NO (0, default), YES (1).| |verify\_host|<|string>验证 web 服务器证书的 *Common Name* 字段或 *Subject Alternate Name* 字段是否匹配。
可能的值：^[1](#footnotes)^ NO (0, default), YES (1).| |ssl\_cert\_file|<|string>用于客户端认证的 SSL 证书文件名（必须为 PEM 格式）。| |ssl\_key\_file|<|string>用于客户端认证的 SSL 私钥文件名（必须为 PEM 格式）。| |ssl\_key\_password|<|string>SSL 私钥文件密码。| |steps|<| |(必填) [主机 web 场景步骤](#host-web-scenario-steps)的根元素。| |tags|<| |web 场景标签的根元素。| |<|tag|string|(必填) 标签名称。| |^|value|string|标签值。| ::: noteclassic 另请参见：[Web 场景对象](/manual/api/reference/httptest/object)（请参阅名称匹配的相关属性）。 ::: [comment]: # ({/776aa762-cae5eb15}) [comment]: # ({2818e5c8-3645afb3}) ##### 主机网页场景步骤 | 元素 | < | 类型 | 说明 | |-|---|---|-----------------------| | name | < | string | （必填）Web场景步骤名称。 | | url | < | string | （必填）用于监控的URL。 | | query\_fields | < | | query 参数的根元素（在执行请求时添加到URL的HTTP字段的array）。 | | < | name | string | （必填）query 参数名称。 | | ^ | value | string | query 参数值。 | | posts | < | | HTTP POST变量的根元素（string（原始POST数据）或HTTP字段的array（表单字段数据））。 | | < | name | string | （必填）Post字段名称。 | | ^ | value | string | （必填）Post字段值。 | | variables | < | | 应用于该步骤之后的步骤级变量（宏）的根元素。
如果变量值带有“regex:”前缀，则其值将根据“regex:”前缀后的正则表达式模式从该步骤返回的数据中提取 | | < | name | string | （必填）变量名称。 | | ^ | value | text | （必填）变量值。 | | headers | < | | 发送请求时要使用的HTTP头的根元素。 | | < | name | string | （必填）头名称。 | | ^ | value | text | （必填）头值。 | | follow\_redirects | < | string | 跟随HTTP重定向。
可能的值：^[1](#footnotes)^ 否（0），是（1，默认）。 | | retrieve\_mode | < | string | HTTP响应检索模式。
可能的值：^[1](#footnotes)^ BODY（0，默认），HEADERS（1），BOTH（2）。 | | timeout | < | string | 步骤执行的超时时间（以秒为单位，[时间后缀](/manual/appendix/suffixes#时间后缀)，或[user macro](/manual/config/macros/user_macros)）。
默认值：15秒。 | | required | < | string | 必须出现在响应中的文本（如果为空则忽略）。 | | status\_codes | < | string | 逗号分隔的可接受HTTP状态码列表（例如，`200-201,210-299`；如果为空则忽略）。 | ::: noteclassic 另请参阅：[场景步骤](/manual/api/reference/httptest/object#场景步骤)（参考具有匹配名称的相关属性）。 ::: [comment]: # ({/2818e5c8-3645afb3}) [comment]: # ({eefa7133-0a8a430a}) #### 主机图形 | 元素 | < | 类型 | 描述 | |-|---|---|-----------------------| | uuid | < | string | 图形的唯一标识符。 | | name | < | string | （必填）图形名称。 | | width | < | integer | 图形宽度，单位为像素。
用于预览以及饼图/爆炸图。
可能值：^[1](#footnotes)^ 20-65535（默认值：900）。 | | height | < | integer | 图形高度，单位为像素。
用于预览以及饼图/爆炸图。
可能值：^[1](#footnotes)^ 20-65535（默认值：900）。 | | yaxismin | < | double | Y轴最小值。
支持Y轴的固定最小值。
默认值：0。 | | yaxismax | < | double | Y轴最大值。
支持X轴的固定最小值。
默认值：0。 | | show\_work\_period | < | string | 高亮显示非工作时间。
支持普通图和堆叠图。
可能值：^[1](#footnotes)^ 否（0），是（1，默认值）。 | | show\_triggers | < | string | 将简单触发器值显示为线条。
支持普通图和堆叠图。
可能值：^[1](#footnotes)^ 否（0），是（1，默认值）。 | | type | < | string | 图形类型。
可能值：^[1](#footnotes)^ 普通（0，默认值），堆叠（1），饼图（2），爆炸图（3）。 | | show\_legend | < | string | 显示图形图例。
可能值：^[1](#footnotes)^ 否（0），是（1，默认值）。 | | show\_3d | < | string | 启用3D样式。
支持普通图和堆叠图。
可能值：^[1](#footnotes)^ 否（0，默认值），是（1）。 | | percent\_left | < | double | 显示左轴的百分位线。
支持普通图。
默认值：0。 | | percent\_right | < | double | 显示右轴的百分位线。
支持普通图。
默认值：0。 | | ymin\_type\_1 | < | string | Y轴最小值。
支持普通图和堆叠图。
可能值：^[1](#footnotes)^ 自动计算（0，默认值），固定（1），监控项（2）。 | | ymin\_item\_1 | < | | （如果 `ymin_type_1` 设置为 `ITEM` 时必填）单个监控项详情的根元素。 | | < | 主机 | string | （必填）监控项主机。 | | ^ | key | string | （必填）监控项键。 | | ymax\_type\_1 | < | string | Y轴最大值。
支持普通图和堆叠图。
可能值：^[1](#footnotes)^ 自动计算（0，默认值），固定（1），监控项（2）。 | | ymax\_item\_1 | < | | （如果 `ymax_type_1` 设置为 `ITEM` 时必填）单个监控项详情的根元素。 | | < | 主机 | string | （必填）监控项主机。 | | ^ | key | string | （必填）监控项键。 | | graph\_items | < | | （必填）[主机图形监控项](#主机-graph-监控项) 的根元素。 | ::: noteclassic 另请参见：[Graph object](/manual/api/reference/graph/object)（参考具有匹配名称的相关属性）。 ::: [comment]: # ({/eefa7133-0a8a430a}) [comment]: # ({7b0dd7dd-21ce205d}) ##### 主机图形监控项 | 元素 | < | 类型 | 描述 | |-|---|---|-----------------------| | sortorder | < | integer | 绘制顺序。数值较小的优先绘制。可用于将线条或区域绘制在另一对象后方（或前方）。 | | drawtype | < | string | 图表监控项的绘制样式。
仅支持普通(NORMAL)图表。
可选值：^[1](#footnotes)^ 单线(SINGLE\_LINE, 0默认)、填充区域(FILLED\_REGION, 1)、粗线(BOLD\_LINE, 2)、虚线(DOTTED\_LINE, 3)、短划线(DASHED\_LINE, 4)、渐变线(GRADIENT\_LINE, 5)。 | | color | < | string | 元素颜色（6符号，十六进制）。 | | yaxisside | < | string | 图表监控项的Y轴刻度将绘制在图形的哪一侧。
支持NORMAL和STACKED类型的图表。 |
可选值：^[1](#footnotes)^ 左侧（0，默认值），右侧（1）。 | | calc\_fnc | < | string | 当某个监控项存在多个值时使用的绘图数据。
可选值：^[1](#脚注)^ 最小值（1）、平均值（2，默认）、最大值（4）、全部（7；包含最小值、平均值和最大值；仅支持简单图表）、最后值（9；支持饼图/爆炸图）。 | | type | < | string | 图形监控项类型。
可选值：^[1](#footnotes)^ SIMPLE（0，默认值）、GRAPH\_SUM（2；该监控项的值代表整个饼图；支持饼图/爆炸式饼图）。 | | item | < | | （必填）单个监控项。 | | < | 主机 | string | (必填) 监控项主机。 | | ^ | 键 | string | (必填) 监控项键。 | ::: noteclassic 另请参阅：[Graph item object](/manual/api/reference/graphitem/object)（参考具有匹配名称的相关属性）。 ::: [comment]: # ({/7b0dd7dd-21ce205d}) [comment]: # ({33208c4a-216805df}) #### 主机值映射 | 元素 | < | 类型 | 说明 | |-|---|---|-----------------------| | uuid | < | string | （必填）此值映射的唯一标识符。 | | name | < | string | （必填）值映射名称。 | | mapping | < | | 映射的根元素。 | | < | type | string | 映射匹配类型。
可能的值：^[1](#footnotes)^ EQUAL（0，默认）、GREATER_OR_EQUAL（2）、LESS_OR_EQUAL（3）、IN_RANGE（4）、REGEXP（5）、DEFAULT（6）。 | | ^ | value | string | 原始值。 | | ^ | newvalue | string | （必填）原始值映射到的值。 | ::: noteclassic 另请参阅：[Value map object](/manual/api/reference/valuemap/object)（参考具有匹配名称的相关属性）。 ::: [comment]: # ({/33208c4a-216805df}) [comment]: # ({8a9ebde1-869bd76e}) ## 脚注 ^ 1 ^ API integer 括号中的值，例如 ENABLED (0)，仅为参考。如需更多信息，请参见表格条目中的链接 API object 页面或每个章节末尾的链接。 [comment]: # ({/8a9ebde1-869bd76e})