4 主机

概述

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

主机导出的内容包含：

  • 链接的主机组

  • 主机数据

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

导出

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

4 主机 - 图1

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

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

导入

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

4 主机 - 图2

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

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

导入规则：

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

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

导出格式

使用YAML进行导出的格式:

  1. zabbix_export:
  2.          version: '7.0'
  3.          host_groups:
  4.            - uuid: f2481361f99448eea617b7b1d4765566
  5.              name: 'Discovered hosts'
  6.            - uuid: 6f6799aa69e844b4b3918f779f2abf08
  7.              name: 'Zabbix servers'
  8.          hosts:
  9.            - host: 'Zabbix server 1'
  10.              name: 'Main Zabbix server'
  11.              monitored_by: 'SERVER'
  12.              templates:
  13.                - name: 'Linux by Zabbix agent'
  14.                - name: 'Zabbix server health'
  15.              groups:
  16.                - name: 'Discovered hosts'
  17.                - name: 'Zabbix servers'
  18.              interfaces:
  19.                - ip: 192.168.1.1
  20.                  interface_ref: if1
  21.              items:
  22.                - name: 'Zabbix trap'
  23.                  type: TRAP
  24.                  key: trap
  25.                  delay: '0'
  26.                  history: 1w
  27.                  preprocessing:
  28.                    - type: MULTIPLIER
  29.                      parameters:
  30.                        - '8'
  31.                  tags:
  32.                    - tag: Application
  33.                      value: 'Zabbix server'
  34.                  triggers:
  35.                    - expression: 'last(/Zabbix server 1/trap)=0'
  36.                      name: 'Last value is zero'
  37.                      priority: WARNING
  38.                      tags:
  39.                        - tag: Process
  40.                          value: 'Internal test'
  41.              tags:
  42.                - tag: Process
  43.                  value: Zabbix
  44.              macros:
  45.                - macro: '{$HOST.MACRO}'
  46.                  value: '123'
  47.                - macro: '{$PASSWORD1}'
  48.                  type: SECRET_TEXT
  49.              inventory:
  50.                type: 'Zabbix server'
  51.                name: yyyyyy-HP-Pro-3010-Small-Form-Factor-PC
  52.                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'
  53.              inventory_mode: AUTOMATIC
  54.          graphs:
  55.            - name: 'CPU utilization server'
  56.              show_work_period: 'NO'
  57.              show_triggers: 'NO'
  58.              graph_items:
  59.                - drawtype: FILLED_REGION
  60.                  color: FF5555
  61.                  item:
  62.                    host: 'Zabbix server 1'
  63.                    key: 'system.cpu.util[,steal]'
  64.                - sortorder: '1'
  65.                  drawtype: FILLED_REGION
  66.                  color: 55FF55
  67.                  item:
  68.                    host: 'Zabbix server 1'
  69.                    key: 'system.cpu.util[,softirq]'
  70.                - sortorder: '2'
  71.                  drawtype: FILLED_REGION
  72.                  color: '009999'
  73.                  item:
  74.                    host: 'Zabbix server 1'
  75.                    key: 'system.cpu.util[,interrupt]'
  76.                - sortorder: '3'
  77.                  drawtype: FILLED_REGION
  78.                  color: '990099'
  79.                  item:
  80.                    host: 'Zabbix server 1'
  81.                    key: 'system.cpu.util[,nice]'
  82.                - sortorder: '4'
  83.                  drawtype: FILLED_REGION
  84.                  color: '999900'
  85.                  item:
  86.                    host: 'Zabbix server 1'
  87.                    key: 'system.cpu.util[,iowait]'
  88.                - sortorder: '5'
  89.                  drawtype: FILLED_REGION
  90.                  color: '990000'
  91.                  item:
  92.                    host: 'Zabbix server 1'
  93.                    key: 'system.cpu.util[,system]'
  94.                - sortorder: '6'
  95.                  drawtype: FILLED_REGION
  96.                  color: '000099'
  97.                  calc_fnc: MIN
  98.                  item:
  99.                    host: 'Zabbix server 1'
  100.                    key: 'system.cpu.util[,user]'
  101.                - sortorder: '7'
  102.                  drawtype: FILLED_REGION
  103.                  color: '009900'
  104.                  item:
  105.                    host: 'Zabbix server 1'
  106.                    key: 'system.cpu.util[,idle]'

导出的元素

导出的元素在下表中进行解释。

元素类型描述
versionstring(必需)Zabbix版本。
host_groups(必需)主机组的根元素。
uuidstring(必需)此主机组的唯一标识符。
namestring(必需)主机组名称。
hosts主机的根元素。

主机

元素类型描述
host字符串（必需）唯一的主机名。
name字符串可见的主机名。
description文本主机描述。
monitoredby字符串监控主机的实体：SERVER（服务器）、PROXY（代理）、或PROXY_GROUP（代理组）。
proxy代理的根元素。
name字符串（必需）监控主机的代理名称（如果有）。
proxy_group代理组的根元素。
name字符串（必需）用于监控主机的代理组名称（如果有）。
status字符串主机状态。
可能的值:1 ENABLED（0，默认）、DISABLED（1）。
ipmi_authtype字符串IPMI会话认证类型。
可能的值:1 DEFAULT（-1，默认）、NONE（0）、MD2（1）、MD5（2）、STRAIGHT（4）、OEM（5）、RMCP_PLUS（6）。
ipmi_privilege字符串IPMI会话特权级别。
可能的值:1 CALLBACK（1）、USER（2，默认）、OPERATOR（3）、ADMIN（4）、OEM（5）。
ipmi_username字符串IPMI检查的用户名。
ipmi_password字符串IPMI检查的密码。
templates链接模板的根元素。
name字符串（必需）模板名称。
groups主机所属的主机组的根元素。
name字符串（必需）主机组名称。
interfaces主机接口的根元素。
items主机监控项的根元素。
discovery_rules主机低级别发现规则的根元素。
http_tests主机Web场景的根元素。
tags主机标签的根元素。
tag字符串（必需）标签名称。
value字符串标签值。
macros主机宏的根元素。
macro字符串（必需）用户宏名称。
type字符串用户宏类型。
可能的值:1 文本（0，默认）、SECRET文本（1）、VAULT（2）。
value字符串用户宏值。
description字符串用户宏描述。
inventory主机清单的根元素。
<inventory_property>字符串清单属性。所有属性都有各自的元素（type、name、os等；例如，参见导出格式）。
inventory_mode字符串清单模式。
可能的值:1 DISABLED（-1）、MANUAL（0，默认）、AUTOMATIC（1）。
valuemaps主机值映射的根元素。

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

主机接口

元素类型描述
default字符串是否为主机的主要接口。注意每种类型的主机只能有一个主要接口。
可能的值:1 NO（0）、YES（1，默认）。
type字符串接口类型。
可能的值:1 ZABBIX（1，默认）、SNMP（2）、IPMI（3）、JMX（4）。
useip字符串是否使用IP作为连接主机的接口（否则将使用DNS）。
可能的值:1 NO（0）、YES（1，默认）。
ip字符串（IP连接所需）IP地址（IPv4或IPv6）。
dns字符串（DNS连接所需）DNS名称。
port字符串端口号。
details接口详细信息的根元素。
version字符串使用的SNMP版本。
可能的值:1 SNMPV1（1）、SNMP_V2C（2，默认）、SNMP_V3（3）。
community字符串（SNMPv1和SNMPv2需要）SNMP社区名称。
max_repetitions字符串用于原生SNMP批量请求（GetBulkRequest-PDUs）的最大重复值。
适用于SNMPv2和SNMPv3 监控项（discovery[ ]和walk[ ]监控项）。
默认值:10。
contextname字符串SNMPv3上下文名称。
适用于SNMPv3 监控项。
securityname字符串SNMPv3安全名称。
适用于SNMPv3 监控项。
securitylevel字符串SNMPv3安全级别。
适用于SNMPv3 监控项。
可能的值:1 NOAUTHNOPRIV（0，默认）、AUTHNOPRIV（1）、AUTHPRIV（2）。
authprotocol字符串SNMPv3认证协议。
适用于SNMPv3 监控项。
可能的值:1 MD5（0，默认）、SHA1（1）、SHA224（2）、SHA256（3）、SHA384（4）、SHA512（5）。
authpassphrase字符串SNMPv3认证密码。
适用于SNMPv3 监控项。
privprotocol字符串SNMPv3隐私协议。
适用于SNMPv3 监控项。
可能的值:1 DES（0，默认）、AES128（1）、AES192（2）、AES256（3）、AES192C（4）、AES256C（5）。
privpassphrase字符串SNMPv3隐私密码。
适用于SNMPv3 监控项。
bulk字符串是否使用SNMP批量请求。
可能的值:1 NO（0）、YES（1，默认）。
interface_ref字符串用于监控项中的接口引用名称（格式为if<N>）。

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

主机监控项

元素类型描述
namestring(必填)监控项名称。
typestring监控项类型。
可能的取值：1 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_oidstring(对于SNMP_AGENT类型的监控项必填)SNMP对象ID。
keystring(必填)监控项键。
delaystring监控项更新间隔。
默认值：1m。对于TRAP类型的监控项，该值总是为0。
historystring历史数据保留时长（使用时间后缀，用户宏或LLD宏）。
默认值：31d。
trendsstring趋势数据保留时长（使用时间后缀，用户宏或LLD宏）。
默认值：365d。
statusstring监控项状态。
可能的取值：1 ENABLED(0,默认),DISABLED(1)。
value_typestring接收值类型。
可能的取值：1 FLOAT(0),CHAR(1),LOG(2),UNSIGNED(3,默认),TEXT(4),BINARY(5)。
allowed_hostsstring允许发送数据的主机的逗号分隔IP地址列表。
支持TRAP和HTTP_AGENT类型的监控项。
unitsstring接收值的单位（bps,B等）。
paramstext根据监控项类型的附加参数（SSH和TELNET监控项的执行脚本；ODBC监控项的SQL查询；CALCULATED监控项的公式；ITEM_TYPE_SCRIPT和ITEM_TYPE_BROWSER监控项的脚本）。
ipmi_sensorstringIPMI传感器。
支持IPMI类型的监控项。
authtypestring认证类型。
支持SSH和HTTP_AGENT类型的监控项。
SSH监控项可能的取值：1 PASSWORD(0,默认),PUBLIC_KEY(1)。
HTTP_AGENT监控项可能的取值：1 NONE(0,默认),BASIC(1),NTLM(2)。
usernamestring(对SSH和TELNET类型的监控项必填)认证的用户名。
支持SIMPLE,ODBC,JMX和HTTP_AGENT类型的监控项。
对于JMX监控项，还应指定password（见下文），或两个元素都留空。
passwordstring(对SSH和TELNET类型的监控项必填)认证的密码。
支持SIMPLE,ODBC,JMX和HTTP_AGENT类型的监控项。
对于JMX监控项，还应指定username（见上文），或两个元素都留空。
publickeystring(对SSH类型的监控项必填)公钥文件名。
privatekeystring(对SSH类型的监控项必填)私钥文件名。
descriptiontext监控项描述。
inventory_linkstring由监控项填充的主机清单字段。
可能的取值：1 NONE(0),ALIAS(4)，等等（参见主机清单支持的字段）。
valuemap监控项值映射的根元素。
namestring(必填)用于监控项的值映射的名称。
logtimefmtstring日志条目中时间的格式。
支持LOG类型的监控项。
preprocessing监控项值预处理的根元素。
step主机监控项值预处理步骤的根元素。
interface_refstring主机接口的引用（格式：if<N>）。
jmx_endpointstringJMX终端点。
适用于JMX类型的监控项。
master_item（对于依赖监控项必需）依赖监控项的主监控项的根元素。
keystring（必需）依赖监控项的主监控项键。
timeoutstring监控项数据轮询请求超时。
适用于监控项类型中的超时列表。
urlstring（对于HTTP_AGENT类型必需）URLstring。
query_fields查询参数的根元素。
适用于HTTP_AGENT类型的监控项。
name（对于HTTP_AGENT类型必需）查询参数名称。
valuestring查询参数值。
适用于HTTP_AGENT类型的监控项。
parameters用户定义参数的根元素。
适用于ITEM_TYPE_SCRIPT和ITEM_TYPE_BROWSER类型的监控项。
name（对于ITEM_TYPE_SCRIPT和ITEM_TYPE_BROWSER类型必需）用户定义参数名称。
valuestring用户定义参数值。
适用于ITEM_TYPE_SCRIPT和ITEM_TYPE_BROWSER类型的监控项。
postsstringHTTP(S)请求体数据。
适用于HTTP_AGENT类型的监控项。
status_codesstring所需的HTTP状态码范围，逗号分隔。
适用于HTTP_AGENT类型的监控项。
follow_redirectsstring在轮询数据时跟随重定向响应。
适用于HTTP_AGENT类型的监控项。
可能的值:1NO(0),YES(1,默认).
post_typestring请求数据主体类型。
适用于HTTP_AGENT类型的监控项。
可能的值:1RAW(0,默认),JSON(2),XML(3).
http_proxystringHTTP(S)代理连接string。
适用于HTTP_AGENT类型的监控项。
headersHTTP(S)请求头的根元素。
适用于HTTP_AGENT类型的监控项。
name（对于HTTP_AGENT类型必需）请求头名称。
valuestring（对于HTTP_AGENT类型必需）请求头值。
retrieve_modestring应存储响应的哪部分。
适用于HTTP_AGENT类型的监控项。
可能的值:1BODY(0,默认),HEADERS(1),BOTH(2).
request_methodstring请求方法类型。
适用于HTTP_AGENT类型的监控项。
可能的值:1GET(0,默认),POST(1),PUT(2),HEAD(3).
output_formatstring如何处理响应。
适用于HTTP_AGENT类型的监控项。
可能的值:1RAW(0,默认),JSON(1).
allow_trapsstring允许类似于陷阱项的方式填充值。
适用于HTTP_AGENT类型的监控项。
可能的值:1NO(0,默认),YES(1).
ssl_cert_filestring公共SSL密钥文件路径。
适用于HTTP_AGENT类型的监控项。
ssl_key_filestring私有SSL密钥文件路径。
适用于HTTP_AGENT类型的监控项。
ssl_key_passwordstringSSL密钥文件的密码。
适用于HTTP_AGENT类型的监控项。
verify_peerstring是否验证主机的证书是否真实。
适用于HTTP_AGENT类型的监控项。
可能的值:1NO(0,默认),YES(1).
verify_hoststring是否验证连接主机名是否与主机证书中的名称匹配。
适用于HTTP_AGENT类型的监控项。
可能的值:1NO(0,默认),YES(1).
tags监控项标签的根元素。
tag（必需）标签名称。
valuestring标签值。
triggers主机监控项触发器的根元素（参考hostitemtriggers）。

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

主机监控项值预处理步骤

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

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

主机低级发现规则

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

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

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

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

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

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

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

元素类型描述
operationobjectstring应用操作的对象。
可能的取值:1 ITEM_PROTOTYPE (0), TRIGGER_PROTOTYPE (1), GRAPH_PROTOTYPE (2), HOST_PROTOTYPE (3)。
operatorstring覆盖条件的操作符。
可能的取值:1 EQUAL (1), NOT_EQUAL (2), LIKE (3), NOT_LIKE (4), REGEXP (5), NOT_REGEXP (6)。
valuestring用于覆盖条件操作符的正则表达式或字符串。
statusstring覆盖操作后对象的状态。
discoverstring指示对象是否作为发现的结果添加。
delaystring覆盖操作后为监控项原型设置的更新间隔。
historystring覆盖操作后为监控项原型设置的历史存储周期。
trendsstring覆盖操作后为监控项原型设置的趋势存储周期。
severitystring覆盖操作后设置的触发器原型严重性。
tags为覆盖操作后的对象设置标签的根元素。
tagstring（必需）标签名称。
valuestring标签值。
templates与主机原型关联的模板在覆盖操作后的根元素。
namestring（必需）模板名称。
inventory_modestring覆盖操作后设置的主机原型清单模式。

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

主机监控项触发器

元素类型描述
uuidstring（必需）触发器的唯一标识符。
expressionstring（必需）触发器表达式。
recovery_modestring生成OK事件的基础。
可能的值:1 EXPRESSION (0, 默认), RECOVERY_EXPRESSION (1), NONE (2).
recovery_expressionstring触发器恢复表达式。
correlation_modestring关联模式（无事件关联或按标签进行事件关联）。
可能的值:1 DISABLED (0, 默认), TAG_VALUE (1).
correlation_tagstring用于事件关联的标签名称。
namestring（必需）触发器名称。
event_namestring事件名称。
opdatastring操作数据。
url_namestring与触发器关联的URL标签。
urlstring与触发器关联的URL。
statusstring触发器状态。
可能的值:1 ENABLED (0, 默认), DISABLED (1).
prioritystring触发器严重性。
可能的值:1 NOT_CLASSIFIED (0, 默认), INFO (1), WARNING (2), AVERAGE (3), HIGH (4), DISASTER (5).
description文本触发器描述。
typestring事件生成类型（单个问题事件或多个问题事件）。
可能的值:1 SINGLE (0, 默认), MULTIPLE (1).
manual_closestring手动关闭问题事件。
可能的值:1 NO (0, 默认), YES (1).
dependencies依赖关系的根元素。
依赖触发器名称。
string（必需）依赖触发器表达式。
string依赖触发器恢复表达式。
tags触发器标签的根元素。
标签名称。
string（必需）标签值。

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

主机图表

元素类型描述
uuidstring图表的唯一标识符。
namestring(必填) 图表名称。
widthinteger图表宽度，以像素为单位。
用于预览：饼图/分解饼状图。
可能的取值:1 20-65535 (默认值: 900)。
heightinteger图表高度，以像素为单位。
用于预览：饼图/分解饼状图。
可能的取值:1 20-65535 (默认值: 900)。
yaxismindoubleY 轴最小值。
支持固定的 Y 轴最小值。
默认值: 0。
yaxismaxdoubleY 轴最大值。
支持固定的 Y 轴最大值。
默认值: 0。
show_work_periodstring高亮显示非工作时间。
支持普通和堆叠图。
可能的取值:1 NO (0), YES (1, 默认)。
show_triggersstring显示简单触发器值作为一条线。
支持普通和堆叠图。
可能的取值:1 NO (0), YES (1, 默认)。
typestring图表类型。
可能的取值:1 NORMAL (0, 默认), STACKED (1), PIE (2), EXPLODED (3)。
show_legendstring显示图例。
可能的取值:1 NO (0), YES (1, 默认)。
show_3dstring启用 3D 样式。
支持普通和堆叠图。
可能的取值:1 NO (0, 默认), YES (1)。
percent_leftdouble显示左轴的百分位线。
支持普通图。
默认值: 0。
percent_rightdouble显示右轴的百分位线。
支持普通图。
默认值: 0。
ymin_type_1stringY 轴的最小值。
支持普通和堆叠图。
可能的取值:1 CALCULATED (0, 默认), FIXED (1), ITEM (2)。
ymin_item_1(如果 ymin_type_1 设置为 ITEM，则必填) 单个监控项详细信息的根元素。
hoststring(必填) 监控项主机。
keystring(必填) 监控项键。
ymax_type_1stringY 轴的最大值。
支持普通和堆叠图。
可能的取值:1 CALCULATED (0, 默认), FIXED (1), ITEM (2)。
ymax_item_1(如果 ymax_type_1 设置为 ITEM，则必填) 单个监控项详细信息的根元素。
hoststring(必填) 监控项主机。
keystring(必填) 监控项键。
graph_items(必填) 主机图表项的根元素。

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

主机图表项

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

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

主机数值映射

元素类型描述
uuidstring(必填) 此数值映射的唯一标识符。
namestring(必填) 数值映射的名称。
mapping映射的根元素。
typestring匹配类型。
可能的取值:1 EQUAL (0, 默认), GREATER_OR_EQUAL (2), LESS_OR_EQUAL (3), IN_RANGE (4), REGEXP (5), DEFAULT (6)。
valuestring原始值。
newvaluestring(必填) 原始值映射到的新值。

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

主机Web场景

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

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

主机Web场景步骤

元素类型描述
namestring（必需）Web场景步骤名称。
urlstring（必需）监视的URL。
query_fields查询参数的根元素（执行请求时要添加到URL的HTTP字段数组）。
namestring（必需）查询参数名称。
valuestring查询参数值。
postsHTTP POST变量的根元素（原始POST数据string或HTTP字段（表单字段数据）的数组）。
namestring（必需）POST字段名称。
valuestring（必需）POST字段值。
variables步骤级别变量（宏），在此步骤后应用。
如果变量值以’regex:’前缀开头，则根据此步骤返回的数据使用正则表达式模式提取值。
namestring（必需）变量名称。
value文本（必需）变量值。
headers执行请求时发送的HTTP头的根元素。
namestring（必需）头部名称。
value文本（必需）头部值。
follow_redirectsstring是否跟随HTTP重定向。
可能的取值:1 NO (0), YES (1, 默认)。
retrieve_modestringHTTP响应检索模式。
可能的取值:1 BODY (0, 默认), HEADERS (1), BOTH (2)。
timeoutstring步骤执行的超时时间（使用秒、时间后缀或用户宏）。
默认值：15s。
requiredstring响应中必须存在的文本（如果为空则忽略）。
status_codesstring接受的HTTP状态码的逗号分隔列表（例如200-201,210-299；如果为空则忽略）。

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

附注

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