Table of Contents

4 主机

4 主机

概述

导出（exported）的主机具有许多相关对象和对象关系。

主机导出的内容包含：

链接的主机组
主机数据
模板链接
主机组链接
主机接口
直接链接的应用集
直接链接的监控项
直接链接的触发器
直接链接的具有所有原型的发现规则
直接链接的web场景
主机宏
主机资产清单数据
值映射

导出

要导出主机，请执行以下操作: - 前往: Configuration → Hosts - 标记要导出的主机的复选框 - 单击列表下方的导出

根据选定的格式，主机将导出到具有默认名称的本地文件：

zabbix_export_hosts.yaml - 导出YAML格式 (默认导出)
zabbix_export_hosts.xml - 导出XML格式
zabbix_export_hosts.json - 导出JSON格式

导入

要导入主机，请按照以下步骤操作： 1. 进入 数据收集 → 主机。 2. 点击右上角的导入。 3. 选择导入文件。 4. 在配置表单的右下角点击导入。

如果勾选了高级选项* 复选框，将显示所有可导入元素的详细列表 - 按需标记或取消标记每个导入规则。

如果在全部行中点击复选框，将会标记/取消标记其下所有元素。

导入规则：

规则	描述
Update existing	使用导入文件中的数据更新现有元素。否则，它们将不会被更新。
Create new	使用导入文件中的数据创建新元素。否则，它们将不会被创建。
Delete missing	从导入文件中缺失的现有元素将被删除。否则，它们将不会被删除。如果为 Delete missing 标记了 Template linkage，那么导入文件中不存在的当前模板链接将被取消链接。从未链接模板继承的实体（监控项、触发器、图形等）将不会被删除（除非对每个实体也选择了 Delete missing 选项）。

导入操作的成功或失败消息将显示在前端界面中。

导出格式

使用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: Application
                     value: 'Zabbix server'
                 triggers:
                   - expression: 'last(/Zabbix server 1/trap)=0'
                     name: 'Last value is zero'
                     priority: WARNING
                     tags:
                       - tag: Process
                         value: 'Internal test'
             tags:
               - tag: Process
                 value: Zabbix
             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]'

导出的元素

导出的元素在下表中进行解释。 |元素|<|类型|描述| |-|---|---|-----------------------| |version|<|string|(必需)Zabbix版本。| |host_groups|<| |(必需)主机组的根元素。| |<|uuid|string|(必需)此主机组的唯一标识符。| |^|name|string|(必需)主机组名称。| |hosts|<| |主机的根元素。|

主机

元素		类型	描述
host		string	（必需）唯一的主机名。
name		string	可见的主机名。
description		text	主机描述。
monitored_by		string	监控主机的实体：SERVER（服务器）、PROXY（代理）、或 PROXY_GROUP（代理组）。
proxy			代理的根元素。
	name	string	（必需）监控主机的代理名称（如果有）。
proxy_group			代理组的根元素。
	name	string	（必需）用于监控主机的代理组名称（如果有）。
status		string	主机状态。可能的值:¹ ENABLED（0，默认）、DISABLED（1）。
ipmi_authtype		string	IPMI 会话认证类型。可能的值:¹ DEFAULT（-1，默认）、NONE（0）、MD2（1）、MD5（2）、STRAIGHT（4）、OEM（5）、RMCP_PLUS（6）。
ipmi_privilege		string	IPMI 会话特权级别。可能的值:¹ 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			主机接口的根元素。
items			主机监控项的根元素。
discovery_rules			主机低级别发现规则的根元素。
http_tests			主机Web场景的根元素。
tags			主机标签的根元素。
	tag	string	（必需）标签名称。
	value	string	标签值。
macros			主机宏的根元素。
	macro	string	（必需）用户宏名称。
	type	string	用户宏类型。可能的值:¹ TEXT（0，默认）、SECRET_TEXT（1）、VAULT（2）。
	value	string	用户宏值。
	description	string	用户宏描述。
inventory			主机清单的根元素。
	<inventory_property>	string	清单属性。所有属性都有各自的元素（`type`、`name`、`os`等；例如，参见导出格式）。
inventory_mode		string	清单模式。可能的值:¹ DISABLED（-1）、MANUAL（0，默认）、AUTOMATIC（1）。
valuemaps			主机值映射的根元素。

另请参阅: 主机对象（参考相应的具有匹配名称的属性）。

主机接口

元素		类型	描述
default		string	是否为主机的主要接口。注意每种类型的主机只能有一个主要接口。可能的值:¹ NO（0）、YES（1，默认）。
type		string	接口类型。可能的值:¹ ZABBIX（1，默认）、SNMP（2）、IPMI（3）、JMX（4）。
useip		string	是否使用 IP 作为连接主机的接口（否则将使用 DNS）。可能的值:¹ NO（0）、YES（1，默认）。
ip		string	（IP 连接所需）IP 地址（IPv4 或 IPv6）。
dns		string	（DNS 连接所需）DNS 名称。
port		string	端口号。
details			接口详细信息的根元素。
	version	string	使用的 SNMP 版本。可能的值:¹ 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 项目。可能的值:¹ NOAUTHNOPRIV（0，默认）、AUTHNOPRIV（1）、AUTHPRIV（2）。
	authprotocol	string	SNMPv3 认证协议。适用于 SNMPv3 项目。可能的值:¹ MD5（0，默认）、SHA1（1）、SHA224（2）、SHA256（3）、SHA384（4）、SHA512（5）。
	authpassphrase	string	SNMPv3 认证密码。适用于 SNMPv3 项目。
	privprotocol	string	SNMPv3 隐私协议。适用于 SNMPv3 项目。可能的值:¹ DES（0，默认）、AES128（1）、AES192（2）、AES256（3）、AES192C（4）、AES256C（5）。
	privpassphrase	string	SNMPv3 隐私密码。适用于 SNMPv3 项目。
	bulk	string	是否使用 SNMP 批量请求。可能的值:¹ NO（0）、YES（1，默认）。
interface_ref		string	用于项目中的接口引用名称（格式为 `if<N>`）。

另请参阅: 主机接口对象（参考相应的具有匹配名称的属性）。

主机监控项

元素		类型	描述
name		string	(必填) 监控项名称。
type		string	监控项类型。可能的取值：¹ 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)。
snmp_oid		string	(对于 SNMP_AGENT 类型的监控项必填) SNMP 对象 ID。
key		string	(必填) 监控项键。
delay		string	监控项更新间隔。默认值：1m。对于 TRAP 类型的监控项，该值总是为 0。
history		string	历史数据保留时长（使用时间后缀，用户宏或LLD宏）。默认值：31d。
trends		string	趋势数据保留时长（使用时间后缀，用户宏或LLD宏）。默认值：365d。
status		string	监控项状态。可能的取值：¹ ENABLED (0, 默认), DISABLED (1)。
value_type		string	接收值类型。可能的取值：¹ FLOAT (0), CHAR (1), LOG (2), UNSIGNED (3, 默认), TEXT (4), BINARY (5)。
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 监控项可能的取值：¹ PASSWORD (0, 默认), PUBLIC_KEY (1)。 HTTP_AGENT 监控项可能的取值：¹ NONE (0, 默认), BASIC (1), NTLM (2)。
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	由监控项填充的主机清单字段。可能的取值：¹ NONE (0), ALIAS (4)，等等（参见主机清单支持的字段）。
valuemap			监控项值映射的根元素。
	name	string	(必填) 用于监控项的值映射的名称。
logtimefmt		string	日志条目中时间的格式。支持 LOG 类型的监控项。
preprocessing			监控项值预处理的根元素。
	step		主机监控项值预处理步骤的根元素。
interface_ref		string	主机接口的引用（格式：`if<N>`）。
jmx_endpoint		string	JMX 终端点。适用于 JMX 类型的监控项。
master_item			（对于依赖监控项必需）依赖监控项的主监控项的根元素。
	key	string	（必需）依赖监控项的主监控项键。
timeout		string	监控项数据轮询请求超时。适用于监控项类型中的超时列表。
url		string	（对于 HTTP_AGENT 类型必需）URL string。
query_fields			查询参数的根元素。适用于 HTTP_AGENT 类型的监控项。
		name	（对于 HTTP_AGENT 类型必需）查询参数名称。
		value	string	查询参数值。适用于 HTTP_AGENT 类型的监控项。
parameters			用户定义参数的根元素。适用于 ITEM_TYPE_SCRIPT 和 ITEM_TYPE_BROWSER 类型的监控项。
		name	（对于 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 类型的监控项。可能的值:¹ NO (0), YES (1, 默认).
post_type		string	请求数据主体类型。适用于 HTTP_AGENT 类型的监控项。可能的值:¹ RAW (0, 默认), JSON (2), XML (3).
http_proxy		string	HTTP(S) 代理连接string。适用于 HTTP_AGENT 类型的监控项。
headers			HTTP(S) 请求头的根元素。适用于 HTTP_AGENT 类型的监控项。
		name	（对于 HTTP_AGENT 类型必需）请求头名称。
		value	string	（对于 HTTP_AGENT 类型必需）请求头值。
retrieve_mode		string	应存储响应的哪部分。适用于 HTTP_AGENT 类型的监控项。可能的值:¹ BODY (0, 默认), HEADERS (1), BOTH (2).
request_method		string	请求方法类型。适用于 HTTP_AGENT 类型的监控项。可能的值:¹ GET (0, 默认), POST (1), PUT (2), HEAD (3).
output_format		string	如何处理响应。适用于 HTTP_AGENT 类型的监控项。可能的值:¹ RAW (0, 默认), JSON (1).
allow_traps		string	允许类似于陷阱项的方式填充值。适用于 HTTP_AGENT 类型的监控项。可能的值:¹ 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 类型的监控项。可能的值:¹ NO (0, 默认), YES (1).
verify_host		string	是否验证连接主机名是否与主机证书中的名称匹配。适用于 HTTP_AGENT 类型的监控项。可能的值:¹ NO (0, 默认), YES (1).
tags			监控项标签的根元素。
		tag	（必需）标签名称。
		value	string	标签值。
triggers			主机监控项触发器的根元素（参考 host item triggers）。

还请参阅：监控项对象（查阅具有匹配名称的相关属性）。

主机监控项值预处理步骤

元素	类型	描述
type	字符串	（必需）监控项值预处理步骤类型。可能的值:¹ 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	（必需）监控项值预处理步骤的单个参数。
error_handler	字符串	预处理步骤失败时使用的操作类型。可能的值:¹ ORIGINAL_ERROR (0, 默认), DISCARD_VALUE (1), CUSTOM_VALUE (2), CUSTOM_ERROR (3).
error_handler_params	字符串	错误处理程序参数。

还请参阅：监控项预处理对象（查阅具有匹配名称的相关属性）。

主机低级发现规则

大多数主机低级发现规则的元素与主机监控项相同。下表描述了与主机监控项不同的那些元素。

元素		类型	描述
type		string	监控项类型。可能的取值:¹ 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			主机低级发现规则过滤器的根元素。
lifetime		string	资源不再被发现后删除的时间段（使用秒、时间后缀或用户宏）。默认值: 7d。
lifetime_type		string	删除丢失的LLD资源的情景。可能的取值: DELETE_NEVER, DELETE_IMMEDIATELY, DELETE_AFTER。
enabled_lifetime		string	资源不再被发现后禁用的时间段（使用秒、时间后缀或用户宏）。
enabled_lifetime_type		string	禁用丢失的LLD资源的情景。可能的取值: DISABLE_NEVER, DISABLE_IMMEDIATELY, DISABLE_AFTER。
item_prototypes			主机监控项原型元素的根元素，与主机监控项相同。
trigger_prototypes			主机触发器原型元素的根元素，与主机监控项触发器相同。
graph_prototypes			主机图表原型元素的根元素，与主机图表相同。
host_prototypes			主机原型元素的根元素，与主机相同。
master_item		string	(DEPENDENT规则必需) 依赖规则的主监控项的根元素。
lld_macro_paths			低级发现规则宏路径的根元素。
	lld_macro	string	(必需) 低级发现规则宏名称。
	path	string	(必需) 被分配给相应宏的值的选择器。
preprocessing			低级发现规则值预处理的根元素。
	step		低级发现规则值预处理步骤元素的根元素，与主机监控项值预处理步骤相同，但可用值更少。参见: LLD规则预处理对象。
overrides			低级发现规则覆盖规则的根元素。
	name	string	(必需) 唯一的覆盖名称。
	step	string	(必需) 覆盖的顺序号。
	stop	string	如果匹配，则停止处理下一个覆盖。
	filter		低级发现规则覆盖规则过滤器的根元素，与主机低级发现规则过滤器相同。
	operations		主机低级发现规则覆盖操作的根元素。

另请参阅: LLD规则对象（参考相应属性的匹配名称）。

主机低等级发现规则过滤器

元素		类型	描述
evaltype		string	覆盖过滤条件评估方法。可能的取值:¹ AND_OR (0, 默认), AND (1), OR (2), FORMULA (3)。
formula		string	过滤条件的自定义计算公式。
conditions			过滤条件的根元素。
	macro	string	(必需) 执行检查的低等级发现宏的名称。
	value	string	用于比较的值。
	operator	string	条件操作符。可能的取值:¹ MATCHES_REGEX (8, 默认), NOT_MATCHES_REGEX (9)。
	formulaid	string	(必需) 用于从自定义表达式中引用条件的任意唯一ID。只能包含大写字母。用户在修改过滤条件时必须定义ID，但在请求后会生成新的ID。

另请参阅: LLD规则过滤器对象（参考相应属性的匹配名称）。

主机低等级发现规则覆盖操作

元素		类型	描述
operationobject		string	应用操作的对象。可能的取值:¹ ITEM_PROTOTYPE (0), TRIGGER_PROTOTYPE (1), GRAPH_PROTOTYPE (2), HOST_PROTOTYPE (3)。
operator		string	覆盖条件的操作符。可能的取值:¹ 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	覆盖操作后设置的主机原型清单模式。

另请参阅: LLD规则覆盖操作对象（参考相应属性的匹配名称）。

主机监控项触发器

元素	类型	描述
uuid	string	（必需）触发器的唯一标识符。
expression	string	（必需）触发器表达式。
recovery_mode	string	生成OK事件的基础。可能的值:¹ EXPRESSION (0, 默认), RECOVERY_EXPRESSION (1), NONE (2).
recovery_expression	string	触发器恢复表达式。
correlation_mode	string	关联模式（无事件关联或按标签进行事件关联）。可能的值:¹ DISABLED (0, 默认), TAG_VALUE (1).
correlation_tag	string	用于事件关联的标签名称。
name	string	（必需）触发器名称。
event_name	string	事件名称。
opdata	string	操作数据。
url_name	string	与触发器关联的URL标签。
url	string	与触发器关联的URL。
status	string	触发器状态。可能的值:¹ ENABLED (0, 默认), DISABLED (1).
priority	string	触发器严重性。可能的值:¹ NOT_CLASSIFIED (0, 默认), INFO (1), WARNING (2), AVERAGE (3), HIGH (4), DISASTER (5).
description	文本	触发器描述。
type	string	事件生成类型（单个问题事件或多个问题事件）。可能的值:¹ SINGLE (0, 默认), MULTIPLE (1).
manual_close	string	手动关闭问题事件。可能的值:¹ NO (0, 默认), YES (1).
dependencies		依赖关系的根元素。
		依赖触发器名称。
	string	（必需）依赖触发器表达式。
	string	依赖触发器恢复表达式。
tags		触发器标签的根元素。
		标签名称。
	string	（必需）标签值。

还请参阅：触发器对象（查阅具有匹配名称的相关属性）。

主机图表

元素		类型	描述
uuid		string	图表的唯一标识符。
name		string	(必填) 图表名称。
width		integer	图表宽度，以像素为单位。用于预览：饼图/分解饼状图。可能的取值:¹ 20-65535 (默认值: 900)。
height		integer	图表高度，以像素为单位。用于预览：饼图/分解饼状图。可能的取值:¹ 20-65535 (默认值: 900)。
yaxismin		double	Y 轴最小值。支持固定的 Y 轴最小值。默认值: 0。
yaxismax		double	Y 轴最大值。支持固定的 Y 轴最大值。默认值: 0。
show_work_period		string	高亮显示非工作时间。支持普通和堆叠图。可能的取值:¹ NO (0), YES (1, 默认)。
show_triggers		string	显示简单触发器值作为一条线。支持普通和堆叠图。可能的取值:¹ NO (0), YES (1, 默认)。
type		string	图表类型。可能的取值:¹ NORMAL (0, 默认), STACKED (1), PIE (2), EXPLODED (3)。
show_legend		string	显示图例。可能的取值:¹ NO (0), YES (1, 默认)。
show_3d		string	启用 3D 样式。支持普通和堆叠图。可能的取值:¹ NO (0, 默认), YES (1)。
percent_left		double	显示左轴的百分位线。支持普通图。默认值: 0。
percent_right		double	显示右轴的百分位线。支持普通图。默认值: 0。
ymin_type_1		string	Y 轴的最小值。支持普通和堆叠图。可能的取值:¹ CALCULATED (0, 默认), FIXED (1), ITEM (2)。
ymin_item_1			(如果 `ymin_type_1` 设置为 `ITEM`，则必填) 单个监控项详细信息的根元素。
	host	string	(必填) 监控项主机。
	key	string	(必填) 监控项键。
ymax_type_1		string	Y 轴的最大值。支持普通和堆叠图。可能的取值:¹ CALCULATED (0, 默认), FIXED (1), ITEM (2)。
ymax_item_1			(如果 `ymax_type_1` 设置为 `ITEM`，则必填) 单个监控项详细信息的根元素。
	host	string	(必填) 监控项主机。
	key	string	(必填) 监控项键。
graph_items			(必填) 主机图表项的根元素。

参见: 图表对象（请参考相应名称的属性）。

主机图表项

元素		类型	描述
sortorder		integer	绘制顺序。数值较小的先绘制。可以用于在另一个图形项的后面（或前面）绘制线条或区域。
drawtype		string	图形项的绘制样式。支持普通图。可能的取值:¹ SINGLE_LINE (0, 默认), FILLED_REGION (1), BOLD_LINE (2), DOTTED_LINE (3), DASHED_LINE (4), GRADIENT_LINE (5)。
color		string	元素颜色（6 个字符的十六进制）。
yaxisside		string	图形项的 Y 轴刻度绘制位置。支持普通和堆叠图。可能的取值:¹ LEFT (0, 默认), RIGHT (1)。
calc_fnc		string	如果一个监控项有多个值，用于绘制的数据。可能的取值:¹ MIN (1), AVG (2, 默认), MAX (4), ALL (7; 最小值、平均值和最大值; 仅支持简单图), LAST (9; 仅支持饼图/分解饼图)。
type		string	图形项类型。可能的取值:¹ SIMPLE (0, 默认), GRAPH_SUM (2; 监控项的值代表整个饼图; 仅支持饼图/分解饼图)。
item			(必填) 单个监控项。
	host	string	(必填) 监控项主机。
	key	string	(必填) 监控项键。

参见：图形项对象（请参考相应名称的属性）。

主机数值映射

元素		类型	描述
uuid		string	(必填) 此数值映射的唯一标识符。
name		string	(必填) 数值映射的名称。
mapping			映射的根元素。
	type	string	匹配类型。可能的取值:¹ EQUAL (0, 默认), GREATER_OR_EQUAL (2), LESS_OR_EQUAL (3), IN_RANGE (4), REGEXP (5), DEFAULT (6)。
	value	string	原始值。
	newvalue	string	(必填) 原始值映射到的新值。

参见：数值映射对象（请参考相应名称的属性）。

主机Web场景

元素		类型	描述
uuid		string	（必需）此Web场景的唯一标识符。
name		string	（必需）Web场景的名称。
delay		string	执行Web场景的频率（使用秒、时间后缀或用户宏）。默认值：1m。
attempts		整数	执行Web场景步骤的尝试次数。可能的取值：1-10（默认值：1）。
agent		string	客户端代理。Zabbix将伪装成选择的浏览器。当网站针对不同的浏览器返回不同内容时，这很有用。默认值：Zabbix。
http_proxy		string	Web场景使用的代理，格式为：`http://[用户名[:密码]@]proxy.example.com[:端口]`。
variables			Web场景步骤中可能使用的变量的根元素。
	name	string	（必需）变量名称。
	value	文本	（必需）变量值。
headers			执行请求时发送的HTTP头的根元素。头部应使用与它们在HTTP协议中出现的相同语法列出。
	name	string	（必需）头部名称。
	value	文本	（必需）头部值。
status		string	Web场景的状态。可能的取值:¹ ENABLED (0, 默认), DISABLED (1)。
authentication		string	认证方法。可能的取值:¹ NONE (0, 默认), BASIC (1), NTLM (2)。
http_user		string	BASIC（HTTP）或NTLM认证使用的用户名。
http_password		string	BASIC（HTTP）或NTLM认证使用的密码。
verify_peer		string	验证Web服务器的SSL证书。可能的取值:¹ NO (0, 默认), YES (1)。
verify_host		string	验证Web服务器证书的通用名称字段或主题备用名称字段是否匹配。可能的取值:¹ NO (0, 默认), YES (1)。
ssl_cert_file		string	用于客户端认证的SSL证书文件的名称（必须为PEM格式）。
ssl_key_file		string	用于客户端认证的SSL私钥文件的名称（必须为PEM格式）。
ssl_key_password		string	SSL私钥文件的密码。
steps			（必需）主机Web场景步骤的根元素。
tags			Web场景标签的根元素。
	tag	string	（必需）标签名称。
	value	string	标签值。

另请参阅：Web场景对象（参考相应属性的匹配名称）。

主机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重定向。可能的取值:¹ NO (0), YES (1, 默认)。
retrieve_mode		string	HTTP响应检索模式。可能的取值:¹ BODY (0, 默认), HEADERS (1), BOTH (2)。
timeout		string	步骤执行的超时时间（使用秒、时间后缀或用户宏）。默认值：15s。
required		string	响应中必须存在的文本（如果为空则忽略）。
status_codes		string	接受的HTTP状态码的逗号分隔列表（例如`200-201,210-299`；如果为空则忽略）。

另请参阅：Web场景步骤对象（参考相应属性的匹配名称）。

附注

¹ API 中的整数值用括号表示，例如，ENABLED (0)，仅供参考。要获取更多信息，请查看表中每个条目的链接 API 对象页面或各节末尾的链接。

Documentation