[comment]: # ({8b893994-ae6d2ebd})
# 4 主机
[comment]: # ({/8b893994-ae6d2ebd})
[comment]: # ({45b081d7-907c3faa})
#### 概述
导出（exported） 的主机具有许多相关对象和对象关系。
主机导出的内容包含：
- 链接的主机组
- 主机数据
- 模板链接
- 主机组链接
- 主机接口
- 直接链接的应用集
- 直接链接的监控项
- 直接链接的触发器
- 直接链接的具有所有原型的发现规则
- 直接链接的web场景
- 主机宏
- 主机资产清单数据
- 值映射
[comment]: # ({/45b081d7-907c3faa})
[comment]: # ({ec949d61-55d6da26})
#### 导出
要导出主机，请执行以下操作:
- 前往: *Configuration* → *Hosts*
- 标记要导出的主机的复选框
- 单击列表下方的*导出*
根据选定的格式，主机将导出到具有默认名称的本地文件：
- *zabbix\_export\_hosts.yaml* - 导出YAML格式 (默认导出)
- *zabbix\_export\_hosts.xml* - 导出XML格式
- *zabbix\_export\_hosts.json* - 导出JSON格式
[comment]: # ({/ec949d61-55d6da26})
[comment]: # ({43bc5fc8-158cdcbf})
#### 导入
要导入主机，请执行以下操作：
1. 前往 *数据采集* → *主机*。
2. 单击右上角的 *导入*。
3. 选择导入文件。
4. 单击配置表单右下角的 *导入*。
{width="600"}
如果勾选 *高级选项* 复选框，将显示所有可导入元素的详细列表 - 根据需要勾选或取消勾选各项导入规则。
如果单击 *全部* 行中的复选框，其下方所有元素都将被勾选/取消勾选。
导入规则：
|规则|说明|
|----|-----------|
|*更新现有项*|现有元素将使用导入文件中的数据进行更新。否则，它们将不会被更新。|
|*创建新的*|将使用导入文件中的数据创建新元素。否则，它们将不会被创建。|
|*删除缺失项*|导入文件中不存在的现有元素将被移除。否则，它们将不会被移除。
如果为 *模板关联* 勾选了 *删除缺失项*，则当前在导入文件中不存在的模板关联将被取消关联。从已取消关联的模板继承的实体（监控项、触发器、图形等）不会被移除（除非也为每个实体选择了 *删除缺失项* 选项）。|
前端中将显示导入成功或失败的消息。
[comment]: # ({/43bc5fc8-158cdcbf})
[comment]: # ({29f2a90b-93059e09})
#### 导出格式
导出主机时，Zabbix 会生成结构化的 YAML、JSON 或 XML 格式。
导出内容包括主机元素，例如主机元数据、监控项、宏、触发器等。
每个元素都有特定用途，并且可能包含嵌套元素。
以下各节将说明导出格式中的每个元素。
示例使用了一个链接了 [MySQL by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mysql_agent2) 模板的主机。
为演示各元素的用途，在创建主机后会取消链接该模板。
取消链接会将所有元素保留在配置中（不同于取消链接并清除，后者会将其移除）。
省略号 `(...)` 表示为简洁起见而省略的元素。
当某个元素会在后续章节中进行更详细说明时，会使用注释 `(见下表)`。
[comment]: # ({/29f2a90b-93059e09})
[comment]: # ({4baa0480-dacbced3})
## 主机元数据
```yaml
zabbix_export:
version: '8.0'
host_groups:
- uuid: 748ad4d098d447d492bb935c907f652f
name: Databases
hosts: (见下表)
graphs: (见下表)
```
|元素|<|Type|描述|
|-|---|---|-----------------------|
|version|<|string|（必填）Zabbix 版本。|
|host_groups|<| |（必填）主机组的根元素。|
|<|uuid|string|（必填）此主机组的唯一标识符。|
|^|name|string|（必填）主机组名称。|
|hosts|<| |[主机](#hosts) 的根元素。|
|graphs|<| |[主机图形](#host-graphs) 的根元素。|
[comment]: # ({/4baa0480-dacbced3})
[comment]: # ({1d48a90c-eedfe2b9})
### 主机
```yaml
zabbix_export:
(...)
hosts:
- host: 'MySQL server'
name: 'MySQL server'
groups:
- name: Databases
interfaces: (见下表)
items: (见下表)
discovery_rules: (见下表)
tags:
- tag: location
value: Riga
macros:
(...)
- macro: '{$MYSQL.DSN}'
value: 192.0.2.0
(...)
- macro: '{$MYSQL.PASSWORD}'
type: SECRET_TEXT
description: 'MySQL user password.'
(...)
valuemaps: (见下表)
(...)
```
|元素|<|Type|描述|
|-|---|---|-----------------------|
|host|<|string|（必填）唯一主机名称。|
|name|<|string|可见主机名称。|
|description|<|text|主机描述。|
|monitored_by|<|string|主机的监控方式。
可能的值：^[1](#footnotes)^ SERVER (0，默认)、PROXY (1) 或 PROXY_GROUP (2)。|
|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|<| |[主机接口](#host-interfaces)的根元素。|
|items|<| |[主机监控项](#host-items)的根元素。|
|discovery_rules|<| |[主机低级别发现规则](#host-low-level-discovery-rules)的根元素。|
|http_tests|<| |[主机 Web 场景](#host-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](#export-format)）。|
|inventory\_mode|<|string|资产记录模式。
可能的值：^[1](#footnotes)^ DISABLED (-1)、MANUAL (0，默认)、AUTOMATIC (1)。|
|valuemaps|<| |[主机值映射](#host-value-maps)的根元素。|
::: noteclassic
另请参见：[Host object](/manual/api/reference/host/object)（请参考名称匹配的相关属性）。
:::
[comment]: # ({/1d48a90c-eedfe2b9})
[comment]: # ({f6776097-c8da7bba})
#### 主机接口
```yaml
zabbix_export:
(...)
hosts:
- host: 'MySQL server'
(...)
interfaces:
- ip: 192.0.2.0
interface_ref: if1
(...)
```
|Element|<|Type|Description|
|-|---|---|-----------------------|
|default|<|string|此接口是否为主主机接口。请注意，一台主机上每种类型只能有一个主接口。
可能的值：^[1](#footnotes)^ NO (0), YES (1，默认)。|
|type|<|string|接口类型。
可能的值：^[1](#footnotes)^ ZABBIX (1，默认), SNMP (2), IPMI (3), JMX (4)。|
|useip|<|string|连接到主机时是否使用 IP 作为接口（否则将使用 DNS）。
可能的值：^[1](#footnotes)^ NO (0), YES (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 community。|
|^|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)^ NO (0), YES (1，默认)。|
|interface\_ref|<|string|在监控项中使用的接口引用名称（格式：`if`）。|
::: noteclassic
另请参见：[主机接口对象](/manual/api/reference/hostinterface/object)（请参考名称匹配的相关属性）。
:::
[comment]: # ({/f6776097-c8da7bba})
[comment]: # ({9a905a3e-8a2e4e2f})
#### 主机监控项
```yaml
zabbix_export:
(...)
hosts:
- host: 'MySQL server'
(...)
items:
(...)
- name: 'Binlog cache disk use'
type: DEPENDENT
key: mysql.binlog_cache_disk_use
value_type: FLOAT
description: '由于事务大于 `binlog_cache_size`，无法放入常规二进制日志缓存，因此使用临时磁盘缓存的事务数量。'
preprocessing: (见下表)
master_item:
key: 'mysql.get_status_variables["{$MYSQL.DSN}","{$MYSQL.USER}","{$MYSQL.PASSWORD}"]'
tags:
- tag: component
value: cache
(...)
- name: 'Buffer pool utilization'
type: CALCULATED
key: mysql.buffer_pool_utilization
value_type: FLOAT
units: '%'
params: |
( last(//mysql.innodb_buffer_pool_pages_total) -
last(//mysql.innodb_buffer_pool_pages_free) ) /
( last(//mysql.innodb_buffer_pool_pages_total) +
( last(//mysql.innodb_buffer_pool_pages_total) = 0 ) ) * 100 *
( last(//mysql.innodb_buffer_pool_pages_total) > 0 )
description: '缓冲池中已使用页数与总页数的比率。'
tags:
- tag: component
value: memory
triggers: (见下表)
(...)
- name: Uptime
type: DEPENDENT
key: mysql.uptime
units: uptime
description: '服务器已运行的秒数。'
preprocessing: (见下表)
master_item:
key: 'mysql.get_status_variables["{$MYSQL.DSN}","{$MYSQL.USER}","{$MYSQL.PASSWORD}"]'
tags:
- tag: component
value: application
triggers: (见下表)
(...)
```
|Element|<|Type|Description|
|-|---|---|-----------------------|
|name|<|string|（必填）监控项名称。|
|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)、CALCULATED (15)、JMX (16)、SNMP\_TRAP (17)、DEPENDENT (18)、HTTP\_AGENT (19)、SNMP\_AGENT (20)、ITEM\_TYPE\_SCRIPT (21)、ITEM\_TYPE\_BROWSER (22)、ITEM\_TYPE\_NESTED (23)。|
|snmp\_oid|<|string|（SNMP\_AGENT 监控项必填）SNMP 对象 ID。|
|key|<|string|（必填）监控项键值。|
|delay|<|string|监控项更新间隔。
默认值：1m。对于 TRAP 监控项，该值始终为 0。|
|history|<|string|历史数据的存储时长（使用 [time suffix](/manual/appendix/suffixes#time-suffixes)、[user macro](/manual/config/macros/user_macros) 或 [LLD macro](/manual/config/macros/lld_macros)）。
默认值：31d。|
|trends|<|string|趋势数据的存储时长（使用 [time suffix](/manual/appendix/suffixes#time-suffixes)、[user macro](/manual/config/macros/user_macros) 或 [LLD macro](/manual/config/macros/lld_macros)）。
默认值：365d。|
|status|<|string|监控项状态。
可能的值：^[1](#footnotes)^ ENABLED (0，默认)、DISABLED (1)。|
|value\_type|<|string|接收值类型。
可能的值：^[1](#footnotes)^ FLOAT (0)、CHAR (1)、LOG (2)、UNSIGNED (3，默认)、TEXT (4)、BINARY (5)、JSON (6)。|
|allowed\_hosts|<|string|允许为该监控项发送数据的主机 IP 地址列表，以逗号分隔。
支持 TRAP 和 HTTP\_AGENT 监控项。|
|units|<|string|接收值单位（bps、B 等）。|
|params|<|text|取决于监控项类型的附加参数（SSH 和 TELNET 监控项的执行脚本；ODBC 监控项的 SQL 查询；CALCULATED 监控项的公式；ITEM\_TYPE\_SCRIPT 和 ITEM\_TYPE\_BROWSER 监控项的脚本）。|
|ipmi\_sensor|<|string|IPMI 传感器。
支持 IPMI 监控项。|
|authtype|<|string|认证类型。
支持 SSH 和 HTTP\_AGENT 监控项。
SSH 监控项可能的值：^[1](#footnotes)^ PASSWORD (0，默认)、PUBLIC\_KEY (1)。
HTTP\_AGENT 监控项可能的值：^[1](#footnotes)^ NONE (0，默认)、BASIC (1)、NTLM (2)、Kerberos (3) 或 Digest (4)。|
|username|<|string|（SSH 和 TELNET 监控项必填）用于认证的用户名。
支持 SIMPLE、ODBC、JMX 和 HTTP\_AGENT 监控项。
用于 JMX 监控项时，还应指定 `password`（见下文），或者两个元素都留空。|
|password|<|string|（SSH 和 TELNET 监控项必填）用于认证的密码。
支持 SIMPLE、ODBC、JMX 和 HTTP\_AGENT 监控项。
用于 JMX 监控项时，还应指定 `username`（见上文），或者两个元素都留空。|
|publickey|<|string|（SSH 监控项必填）公钥文件名称。|
|privatekey|<|string|（SSH 监控项必填）私钥文件名称。|
|description|<|text|监控项描述。|
|inventory\_link|<|string|由该监控项填充的主机资产字段。
可能的值：^[1](#footnotes)^ NONE (0)、ALIAS (4) 等（支持的字段请参见 [Host inventory](/manual/api/reference/host/object#host-inventory)）。|
|valuemap|<| |监控项值映射的根元素。|
| |name|string|（必填）要用于该监控项的值映射名称。|
|logtimefmt|<|string|日志条目中的时间格式。
支持值类型为 LOG 的监控项。|
|preprocessing|<| |监控项值预处理的根元素。|
| |step| |[主机监控项值预处理步骤](#host-item-value-preprocessing-steps)的根元素。|
|interface\_ref|<|string|主机接口的引用（格式：`if`）。|
|jmx\_endpoint|<|string|JMX 端点。
支持 JMX 监控项。|
|master_item|<| |（DEPENDENT 监控项必填）依赖监控项的主监控项根元素。|
| |key|string|（必填）依赖监控项的主监控项键值。|
|timeout|<|string|监控项数据轮询请求超时。
支持 [Timeouts](/manual/web_interface/frontend_sections/administration/general#timeouts) 列表中的监控项类型。|
|url|<|string|（HTTP\_AGENT 监控项必填）URL 字符串。|
|query_fields|<| |查询参数的根元素。
支持 HTTP\_AGENT 监控项。|
|<|name|string|（HTTP\_AGENT 监控项必填）查询参数名称。|
|^|value|string|查询参数值。
支持 HTTP\_AGENT 监控项。|
|parameters|<| |用户定义参数的根元素。
支持 ITEM\_TYPE\_SCRIPT 和 ITEM\_TYPE\_BROWSER 监控项。|
|<|name|string|（ITEM\_TYPE\_SCRIPT 和 ITEM\_TYPE\_BROWSER 监控项必填）用户定义参数名称。|
|^|value|string|用户定义参数值。
支持 ITEM\_TYPE\_SCRIPT 和 ITEM\_TYPE\_BROWSER 监控项。|
|posts|<|string|HTTP(S) 请求正文数据。
支持 HTTP\_AGENT 监控项。|
|status\_codes|<|string|所需 HTTP 状态码范围，以逗号分隔。
支持 HTTP\_AGENT 监控项。|
|follow\_redirects|<|string|轮询数据时是否跟随响应重定向。
支持 HTTP\_AGENT 监控项。
可能的值：^[1](#footnotes)^ NO (0)、YES (1，默认)。|
|post\_type|<|string|提交数据正文的类型。
支持 HTTP\_AGENT 监控项。
可能的值：^[1](#footnotes)^ RAW (0，默认)、JSON (2)、XML (3)。|
|http\_proxy|<|string|HTTP(S) proxy 连接字符串。
支持 HTTP\_AGENT 监控项。|
|headers|<| |HTTP(S) 请求头的根元素。
支持 HTTP\_AGENT 监控项。|
|<|name|string|（HTTP\_AGENT 监控项必填）请求头名称。|
|^|value|string|（HTTP\_AGENT 监控项必填）请求头值。|
|retrieve\_mode|<|string|应存储响应的哪一部分。
支持 HTTP\_AGENT 监控项。
可能的值：^[1](#footnotes)^ BODY (0，默认)、HEADERS (1)、BOTH (2)。|
|request\_method|<|string|请求方法类型。
支持 HTTP\_AGENT 监控项。
可能的值：^[1](#footnotes)^ GET (0，默认)、POST (1)、PUT (2)、HEAD (3)。|
|output\_format|<|string|如何处理响应。
支持 HTTP\_AGENT 监控项。
可能的值：^[1](#footnotes)^ RAW (0，默认)、JSON (1)。|
|allow\_traps|<|string|允许以类似 trapper 监控项的方式填充值。
支持 HTTP\_AGENT 监控项。
可能的值：^[1](#footnotes)^ NO (0，默认)、YES (1)。|
|ssl\_cert\_file|<|string|公共 SSL 密钥文件路径。
支持 HTTP\_AGENT 监控项。|
|ssl\_key\_file|<|string|私有 SSL 密钥文件路径。
支持 HTTP\_AGENT 监控项。|
|ssl\_key\_password|<|string|SSL 密钥文件的密码。
支持 HTTP\_AGENT 监控项。|
|verify\_peer|<|string|是否验证主机证书的真实性。
支持 HTTP\_AGENT 监控项。
可能的值：^[1](#footnotes)^ NO (0，默认)、YES (1)。|
|verify\_host|<|string|是否验证连接所用主机名与主机证书中的主机名是否匹配。
支持 HTTP\_AGENT 监控项。
可能的值：^[1](#footnotes)^ NO (0，默认)、YES (1)。|
|tags|<| |监控项标签的根元素。|
|<|tag|string|（必填）标签名称。|
|^|value|string|标签值。|
|triggers|<| |[主机监控项触发器](#host-item-triggers)的根元素。|
::: noteclassic
另请参见：[Item object](/manual/api/reference/item/object)（请参考名称匹配的相关属性）。
:::
[comment]: # ({/9a905a3e-8a2e4e2f})
[comment]: # ({247c14c6-f0f3fd08})
##### 主机监控项值预处理步骤
```yaml
zabbix_export:
(...)
hosts:
- host: 'MySQL server'
(...)
items:
(...)
- name: 'Binlog cache disk use'
(...)
preprocessing:
- type: JSONPATH
parameters:
- $.Binlog_cache_disk_use
- type: DISCARD_UNCHANGED_HEARTBEAT
parameters:
- 6h
(...)
```
|Element|<|Type|Description|
|-|---|---|-----------------------|
|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|<| |（必填）监控项值预处理步骤参数的根元素。|
| |parameter|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#item-preprocessing)（请参考名称匹配的相关属性）。
:::
[comment]: # ({/247c14c6-f0f3fd08})
[comment]: # ({ca2003ed-5ff5f79a})
##### 主机监控项触发器
```yaml
zabbix_export:
(...)
hosts:
- host: 'MySQL server'
(...)
items:
(...)
- name: Uptime
(...)
triggers:
- expression: 'nodata(/MySQL server/mysql.uptime,30m)=1'
name: 'MySQL: Failed to fetch info data'
event_name: 'MySQL: Failed to fetch info data (or no data for 30m)'
priority: INFO
description: 'Zabbix has not received any data for items for the last 30 minutes.'
dependencies:
- name: 'MySQL: Service is down'
expression: 'last(/MySQL server/mysql.ping["{$MYSQL.DSN}","{$MYSQL.USER}","{$MYSQL.PASSWORD}"])=0'
tags:
- tag: scope
value: availability
- expression: 'last(/MySQL server/mysql.uptime)<10m'
name: 'MySQL: Service has been restarted'
event_name: 'MySQL: Service has been restarted (uptime < 10m)'
priority: INFO
description: 'MySQL uptime is less than 10 minutes.'
tags:
- tag: scope
value: notice
(...)
```
|元素|<|Type|描述|
|-|---|---|-----------------------|
|uuid|<|string|（必填）此触发器的唯一标识符。|
|expression|<|string|（必填）触发器表达式。|
|recovery\_mode|<|string|生成 OK 事件的依据。
可能的值：^[1](#footnotes)^ EXPRESSION (0, default), RECOVERY\_EXPRESSION (1), NONE (2)。|
|recovery\_expression|<|string|触发器恢复表达式。|
|correlation\_mode|<|string|关联模式（不进行事件关联，或按标签进行事件关联）。
可能的值：^[1](#footnotes)^ DISABLED (0, default), 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, default), DISABLED (1)。|
|priority|<|string|触发器严重性。
可能的值：^[1](#footnotes)^ NOT\_CLASSIFIED (0, default), INFO (1), WARNING (2), AVERAGE (3), HIGH (4), DISASTER (5)。|
|description|<|text|触发器描述。|
|type|<|string|事件生成类型（单个问题事件或多个问题事件）。
可能的值：^[1](#footnotes)^ SINGLE (0, default), MULTIPLE (1)。|
|manual\_close|<|string|手动关闭问题事件。
可能的值：^[1](#footnotes)^ NO (0, default), YES (1)。|
|dependencies|<| |依赖关系的根元素。|
|<|name|string|（必填）依赖触发器名称。|
|^|expression|string|（必填）依赖触发器表达式。|
|^|recovery\_expression|string|依赖触发器恢复表达式。|
|tags|<| |触发器标签的根元素。|
|<|tag|string|（必填）标签名称。|
|^|value|string|标签值。|
::: noteclassic
另请参见：[Trigger object](/manual/api/reference/trigger/object)（请参考名称匹配的相关属性）。
:::
[comment]: # ({/ca2003ed-5ff5f79a})
[comment]: # ({cf04fcb5-19e8eae6})
#### 主机低级发现规则
```yaml
zabbix_export:
(...)
hosts:
- host: 'MySQL server'
(...)
discovery_rules:
- name: 'Database discovery'
key: 'mysql.db.discovery["{$MYSQL.DSN}","{$MYSQL.USER}","{$MYSQL.PASSWORD}"]'
delay: 1h
filter: (see table below)
description: 'Scanning databases in DBMS.'
interface_ref: if1
item_prototypes:
- name: 'Size of database {#DATABASE}'
key: 'mysql.db.size["{$MYSQL.DSN}","{$MYSQL.USER}","{$MYSQL.PASSWORD}","{#DATABASE}"]'
delay: 5m
units: B
description: 'Database size.'
preprocessing:
- type: DISCARD_UNCHANGED_HEARTBEAT
parameters:
- 1h
interface_ref: if1
tags:
- tag: component
value: storage
- tag: database
value: '{#DATABASE}'
lld_macro_paths:
- lld_macro: '{#DATABASE}'
path: $.Database
preprocessing:
- type: DISCARD_UNCHANGED_HEARTBEAT
parameters:
- 1d
(...)
```
::: noteimportant
大多数主机低级发现规则元素与[主机监控项](#host-items)相同。
下表描述了与主机监控项不同的那些元素。
:::
|Element|<|Type|Description|
|-|---|---|-----------------------|
|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)、ITEM\_TYPE\_SCRIPT (21)、ITEM\_TYPE\_BROWSER (22)。|
|key|<|string|（必填）低级发现规则键值。|
|filter|<| |[主机低级发现规则过滤器](#host-low-level-discovery-rule-filters)的根元素。|
|lifetime|<|string|时间周期（使用秒、[时间后缀](/manual/appendix/suffixes#time-suffixes)或[用户宏](/manual/config/macros/user_macros)），超过该时间后，不再发现的资源将被删除。
默认值：7d。|
|lifetime_type|<|string|删除丢失的 LLD 资源的场景。
可能的值：DELETE\_NEVER、DELETE\_IMMEDIATELY、DELETE\_AFTER。|
|enabled_lifetime|<|string|时间周期（使用秒、[时间后缀](/manual/appendix/suffixes#time-suffixes)或[用户宏](/manual/config/macros/user_macros)），超过该时间后，不再发现的资源将被禁用。|
|enabled_lifetime_type|<|string|禁用丢失的 LLD 资源的场景。
可能的值：DISABLE\_NEVER、DISABLE\_IMMEDIATELY、DISABLE\_AFTER。|
|item\_prototypes|<| |主机监控项原型元素的根元素，其内容与[主机监控项](#host-items)相同。|
|trigger\_prototypes|<| |主机触发器原型元素的根元素，其内容与[主机监控项触发器](#host-item-triggers)相同。|
|graph\_prototypes|<| |主机图形原型的根元素，其内容与[主机图形](#host-graphs)相同。|
|host\_prototypes|<| |主机原型的根元素，其内容与[主机](#hosts)相同。|
|parent\_discovery\_rule|<| |低级发现规则原型的父低级发现规则（或规则原型）的根元素。此属性表示它是一个 LLD 规则原型，是所引用规则/规则原型的直接子级。|
|<|key|string|（必填）父低级发现规则（或规则原型）键值。|
|master\_item|<|string|（DEPENDENT 规则必填）依赖规则的主监控项的根元素。|
|lld\_macro\_paths|<| |低级发现规则宏路径的根元素。|
|<|lld\_macro|string|（必填）低级发现规则宏名称。|
|^|path|string|（必填）值的选择器，该值将被赋给相应的宏。|
|preprocessing|<| |低级发现规则值预处理的根元素。|
| |step| |低级发现规则值预处理步骤元素的根元素，其内容与[主机监控项值预处理步骤](#host-item-preprocessing-steps)相同，但可用值更少。另请参见：[LLD rule preprocessing object](/manual/api/reference/discoveryrule/object#lld-rule-preprocessing)。|
|overrides|<| |低级发现规则覆盖规则的根元素。|
|<|name|string|（必填）唯一的覆盖名称。|
|^|step|string|（必填）覆盖规则的唯一顺序号。|
|^|stop|string|如果匹配，则停止处理后续覆盖规则。|
|^|filter| |低级发现规则覆盖规则过滤器元素的根元素，其内容与[主机低级发现规则过滤器](#host-low-level-discovery-rule-filters)相同。|
|^|operations| |[主机低级发现规则覆盖操作](#host-low-level-discovery-rule-override-operations)的根元素。|
::: noteclassic
另请参见：[LLD rule object](/manual/api/reference/discoveryrule/object)（请参考具有相同名称的相关属性）。
:::
[comment]: # ({/cf04fcb5-19e8eae6})
[comment]: # ({48ff3e35-a75b2d66})
##### 主机低级别发现规则过滤器
```yaml
zabbix_export:
(...)
hosts:
- host: 'MySQL server'
(...)
discovery_rules:
- name: 'Database discovery'
(...)
filter:
evaltype: AND
conditions:
- macro: '{#DATABASE}'
value: '{$MYSQL.DBNAME.MATCHES}'
- macro: '{#DATABASE}'
value: '{$MYSQL.DBNAME.NOT_MATCHES}'
operator: NOT_MATCHES_REGEX
(...)
```
|元素|<|类型|描述|
|-|---|---|-----------------------|
|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 rule filter object](/manual/api/reference/discoveryrule/object#lld-rule-filter)（请参考具有相同名称的相关属性）。
:::
[comment]: # ({/48ff3e35-a75b2d66})
[comment]: # ({c3385649-77148deb})
##### 主机低级别发现规则覆盖操作
|元素|<|类型|描述|
|-|---|---|-----------------------|
|operationobject|<|string|应用该操作的对象。
可能的值：^[1](#footnotes)^ ITEM_PROTOTYPE (0)、TRIGGER_PROTOTYPE (1)、GRAPH_PROTOTYPE (2)、HOST_PROTOTYPE (3)、DISCOVERY_PROTOTYPE (4)。|
|operator|<|string|覆盖条件运算符。
可能的值：^[1](#footnotes)^ EQUAL (1)、NOT_EQUAL (2)、LIKE (3)、NOT_LIKE (4)、REGEXP (5)、NOT_REGEXP (6)。|
|value|<|string|用于覆盖条件运算符的正则表达式或字符串。|
|status|<|string|执行覆盖操作后对象的状态。|
|discover|<|string|该对象是否因发现而被添加。|
|delay|<|string|执行覆盖操作后为监控项原型设置的更新间隔。|
|history|<|string|执行覆盖操作后为监控项原型设置的历史数据存储周期。|
|trends|<|string|执行覆盖操作后为监控项原型设置的趋势数据存储周期。|
|severity|<|string|执行覆盖操作后设置的触发器原型严重性。|
|tags|<| |执行覆盖操作后为对象设置的标签的根元素。|
|<|tag|string|（必填）标签名称。|
|^|value|string|标签值。|
|templates|<| |执行覆盖操作后链接到主机原型的模板的根元素。|
| |name|string|（必填）模板名称。|
|inventory_mode|<|string|执行覆盖操作后设置的主机原型资产记录模式。|
::: noteclassic
另请参见：[LLD 规则覆盖操作对象](/manual/api/reference/discoveryrule/object#lld-rule-override-operation)（请参考具有相同名称的相关属性）。
:::
[comment]: # ({/c3385649-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) 或 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 scenario object](/manual/api/reference/httptest/object)（请参阅名称匹配的相关属性）。
:::
[comment]: # ({/776aa762-cae5eb15})
[comment]: # ({2818e5c8-3645afb3})
#### 主机Web场景步骤
| 元素 | < | 类型 | 描述 |
|-|---|---|-----------------------|
| name | < | string | （必需）Web场景步骤名称。|
| url | < | string | （必需）监视的URL。|
| query\_fields | < | | 查询参数的根元素（执行请求时要添加到URL的HTTP字段数组）。|
| < | name | string | （必需）查询参数名称。|
| ^ | value | string | 查询参数值。|
| posts | < | | HTTP POST变量的根元素（原始POST数据string或HTTP字段（表单字段数据）的数组）。|
| < | name | string | （必需）POST字段名称。|
| ^ | value | string | （必需）POST字段值。|
| variables | < | | 步骤级别变量（宏），在此步骤后应用。
如果变量值以'regex:'前缀开头，则根据此步骤返回的数据使用正则表达式模式提取值。|
| < | name | string | （必需）变量名称。|
| ^ | value | 文本 | （必需）变量值。|
| headers | < | | 执行请求时发送的HTTP头的根元素。|
| < | name | string | （必需）头部名称。|
| ^ | value | 文本 | （必需）头部值。|
| follow\_redirects | < | string | 是否跟随HTTP重定向。
可能的取值:^[1](#footnotes)^ NO (0), YES (1, 默认)。|
| retrieve\_mode | < | string | HTTP响应检索模式。
可能的取值:^[1](#footnotes)^ BODY (0, 默认), HEADERS (1), BOTH (2)。|
| timeout | < | string | 步骤执行的超时时间（使用秒、[时间后缀](/manual/appendix/suffixes#time-suffixes)或[用户宏](/manual/config/macros/user_macros)）。
默认值：15s。|
| required | < | string | 响应中必须存在的文本（如果为空则忽略）。|
| status\_codes | < | string | 接受的HTTP状态码的逗号分隔列表（例如`200-201,210-299`；如果为空则忽略）。|
::: noteclassic
另请参阅：[Web场景步骤对象](/manual/api/reference/httptest/object#scenario-step)（参考相应属性的匹配名称）。
:::
[comment]: # ({/2818e5c8-3645afb3})
[comment]: # ({a08107ef-0a8a430a})
#### 主机图形
```yaml
zabbix_export:
(...)
graphs:
- name: 'MySQL: Bandwidth'
graph_items: (见下表)
(...)
```
|Element|<|Type|Description|
|-|---|---|-----------------------|
|uuid|<|string|图形的唯一标识符。|
|name|<|string|（必填）图形名称。|
|width|<|integer|图形宽度，单位为像素。
用于预览以及饼图/分离饼图。
可能的值：^[1](#footnotes)^ 20-65535（默认：900）。|
|height|<|integer|图形高度，单位为像素。
用于预览以及饼图/分离饼图。
可能的值：^[1](#footnotes)^ 20-65535（默认：900）。|
|yaxismin|<|double|Y 轴最小值。
支持 Y 轴最小值为 FIXED 的情况。
默认值：0。|
|yaxismax|<|double|Y 轴最大值。
支持 X 轴最小值为 FIXED 的情况。
默认值：0。|
|show\_work\_period|<|string|高亮显示非工作时间。
支持 NORMAL 和 STACKED 图形。
可能的值：^[1](#footnotes)^ NO (0)，YES (1，默认)。|
|show\_triggers|<|string|以线条形式显示简单触发器值。
支持 NORMAL 和 STACKED 图形。
可能的值：^[1](#footnotes)^ NO (0)，YES (1，默认)。|
|type|<|string|图形类型。
可能的值：^[1](#footnotes)^ NORMAL (0，默认)，STACKED (1)，PIE (2)，EXPLODED (3)。|
|show\_legend|<|string|显示图形图例。
可能的值：^[1](#footnotes)^ NO (0)，YES (1，默认)。|
|show\_3d|<|string|启用 3D 样式。
支持 NORMAL 和 STACKED 图形。
可能的值：^[1](#footnotes)^ NO (0，默认)，YES (1)。|
|percent\_left|<|double|显示左轴的百分位线。
支持 NORMAL 图形。
默认值：0。|
|percent\_right|<|double|显示右轴的百分位线。
支持 NORMAL 图形。
默认值：0。|
|ymin\_type\_1|<|string|Y 轴最小值。
支持 NORMAL 和 STACKED 图形。
可能的值：^[1](#footnotes)^ CALCULATED (0，默认)，FIXED (1)，ITEM (2)。|
|ymin\_item\_1|<| |（当 `ymin_type_1` 设置为 `ITEM` 时必填）各个监控项详细信息的根元素。|
|<|host|string|（必填）监控项主机。|
|^|key|string|（必填）监控项键值。|
|ymax\_type\_1|<|string|Y 轴最大值。
支持 NORMAL 和 STACKED 图形。
可能的值：^[1](#footnotes)^ CALCULATED (0，默认)，FIXED (1)，ITEM (2)。|
|ymax\_item\_1|<| |（当 `ymax_type_1` 设置为 `ITEM` 时必填）各个监控项详细信息的根元素。|
|<|host|string|（必填）监控项主机。|
|^|key|string|（必填）监控项键值。|
|graph\_items|<| |（必填）[主机图形监控项](#host-graph-items)的根元素。|
::: noteclassic
另请参见：[Graph object](/manual/api/reference/graph/object)（请参考名称匹配的相关属性）。
:::
[comment]: # ({/a08107ef-0a8a430a})
[comment]: # ({ff2cd1a3-21ce205d})
##### 主机图形监控项
```yaml
zabbix_export:
(...)
graphs:
- name: 'MySQL: Bandwidth'
graph_items:
- drawtype: GRADIENT_LINE
color: 199C0D
item:
host: 'MySQL server'
key: mysql.bytes_received.rate
- sortorder: '1'
drawtype: GRADIENT_LINE
color: F63100
item:
host: 'MySQL server'
key: mysql.bytes_sent.rate
(...)
```
|元素|<|类型|描述|
|-|---|---|-----------------------|
|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)^ LEFT（0，默认）、RIGHT（1）。|
|calc\_fnc|<|string|当一个监控项存在多个值时要绘制的数据。
可能的值：^[1](#footnotes)^ MIN（1）、AVG（2，默认）、MAX（4）、ALL（7；最小值、平均值和最大值；支持简单图形）、LAST（9，支持饼图/分离饼图）。|
|type|<|string|图形监控项类型。
可能的值：^[1](#footnotes)^ SIMPLE（0，默认）、GRAPH\_SUM（2；监控项的值表示整个饼图；支持饼图/分离饼图）。|
|item|<| |（必填）单个监控项。|
|<|host|string|（必填）监控项所在主机。|
|^|key|string|（必填）监控项键值。|
::: noteclassic
另请参见：[图形监控项对象](/manual/api/reference/graphitem/object)（请参阅名称匹配的相关属性）。
:::
[comment]: # ({/ff2cd1a3-21ce205d})
[comment]: # ({8573b93a-216805df})
#### 主机值映射
```yaml
zabbix_export:
(...)
hosts:
- host: 'MySQL server'
(...)
valuemaps:
- name: 示例值映射
mappings:
- value: '1'
newvalue: 示例值
(...)
```
|元素|<|类型|描述|
|-|---|---|-----------------------|
|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
另请参见：[值映射对象](/manual/api/reference/valuemap/object)（请参考名称匹配的相关属性）。
:::
[comment]: # ({/8573b93a-216805df})
[comment]: # ({8a9ebde1-869bd76e})
## 附注
^1^ API 中的整数值用括号表示，例如，ENABLED (0)，仅供参考。
要获取更多信息，请查看表中每个条目的链接 API 对象页面或各节末尾的链接。
[comment]: # ({/8a9ebde1-869bd76e})