4 主机

概述

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

主机导出的内容包含:

  • 链接的主机组

  • 主机数据

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

导出

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

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>字符串清单属性。所有属性都有各自的元素(typenameos等;例如,参见导出格式)。
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 对象页面或各节末尾的链接。