4 主机

概述

主机 具有 exported,并包含许多相关的 objects 和 object 关系。

主机 export 包含:

  • 已链接 host groups
  • 主机 数据
  • 模板链接
  • 主机组 链接
  • 主机 接口
  • 直接关联的 监控项
  • 直接关联的触发器
  • 直接关联的发现规则与所有原型
  • 直接关联的网络场景
  • 主机宏
  • 主机 清单数据
  • 值映射
  • 已链接 主机图形

导出

要export 主机,请执行以下操作:

  1. 转到 数据采集主机
  2. 选中要导出的主机对应的复选框。
  3. 点击列表下方的导出

根据所选格式,主机将被导出到本地file,默认文件名如下:

  • zabbix_export_hosts.yaml - 采用YAMLexport(导出的默认选项);
  • zabbix_export_hosts.xml - 采用XML导出;
  • zabbix_export_hosts.json - 采用JSON导出。

导入

要 import 主机,请执行以下操作:

  1. 转到 数据采集主机
  2. 在Top右上角点击 导入
  3. 选择import文件。
  4. 在配置表单的右下角点击 导入

如果您勾选 高级选项 复选框,将会显示所有可导入元素的详细列表 - 根据需要勾选或取消勾选每个import规则。

如果您勾选 全部 行中的复选框,该行下方的所有元素都将被勾选/取消勾选。

导入规则:

规则 描述
更新现有 将使用来自import文件的数据更新现有元素。否则,它们将不会被更新。
创建新项 将使用来自import文件的数据创建新元素。否则,它们将不会被创建。
删除缺失项 不在import file中存在的现有元素将被移除。否则,它们将不会被移除。
如果为模板链接勾选删除缺失项,当前不在import file中的模板链接将被解除链接。从解除链接的模板继承的实体(监控项、触发器、图形等)不会被移除(除非也为每个实体选择了删除缺失项选项)。

import的成功或失败消息将在前端显示。

导出格式

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]'

导出的元素

导出的元素在下面的表格中进行说明。

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

主机

元素 类型 描述
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 ENABLED (0, 默认), DISABLED (1)。
ipmi_authtype string IPMI会话认证类型。
可能值:1 DEFAULT (-1, 默认), NONE (0), MD2 (1), MD5 (2), STRAIGHT (4), OEM (5), RMCP_PLUS (6)。
ipmi_privilege string IPMI会话权限级别。
可能值:1 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 用户宏类型。
可能值:1 TEXT (0, 默认), SECRET_TEXT (1), VAULT (2)。
value string 用户宏值。
description string 用户宏描述。
inventory 主机资产清单的根元素。
<inventory_property> string 资产清单属性。所有属性都有对应的元素(type, name, os等;例如参见导出格式)。
inventory_mode string 资产清单模式。
可能值:1 DISABLED (-1), MANUAL (0, 默认), AUTOMATIC (1)。
valuemaps 主机值映射的根元素。

另请参阅: Host object (参考具有匹配名称的相关属性)。

主机 接口

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

另请参阅:Host interface object(参考具有匹配名称的相关属性)。

主机 监控项

元素 类型 描述
name string (必填) 监控项名称。
type string 监控项类型。
可选值: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)、监控项_TYPE_SCRIPT (21)、监控项_TYPE_BROWSER (22)。
snmp_oid string (SNMP_AGENT 监控项必填) SNMP object ID。
key string (必填) 监控项键值。
delay string 监控项的更新间隔。
默认值:1m。对于TRAP 监控项,该值始终为0。
history string 历史数据的存储时间周期(使用时间后缀user macroLLD macro)。
默认值:31d。
trends string 趋势数据的存储时间周期(使用时间后缀user macroLLD macro)。
默认值:365d。
status string 监控项状态。
可选值:1 ENABLED (0,默认值)、DISABLED (1)。
value_type string 接收值类型。
可选值:1 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 query;CALCULATED 监控项的公式;监控项_TYPE_SCRIPT和监控项_TYPE_BROWSER 监控项的脚本)。
ipmi_sensor string IPMI传感器。
支持IPMI 监控项。
authtype string 认证类型。
支持SSH和HTTP_AGENT 监控项。
SSH 监控项可选值:1 PASSWORD (0,默认值)、PUBLIC_KEY (1)。
HTTP_AGENT 监控项可选值:1 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 监控项必填) 公钥file名称。
privatekey string (SSH 监控项必填) 私钥file名称。
description text 监控项描述。
inventory_link string 由监控项填充的主机资产字段。
可选值:1 NONE (0)、alias (4)等(支持的字段见主机资产清单)。
valuemap 监控项值映射的根元素。
name string (必填) 用于监控项的值映射名称。
logtimefmt string 日志条目中的时间格式。
支持LOG值类型的监控项。
preprocessing 监控项值预处理的根元素。
step 主机 监控项值预处理步骤的根元素。
interface_ref string 引用主机接口(格式:if<N>)。
jmx_endpoint string JMX端点。
支持JMX 监控项。
master_item (DEPENDENT 监控项必填) 依赖监控项的主监控项的根元素。
key string (必填) 依赖监控项的主监控项键值。
timeout string 监控项数据轮询请求超时时间。
支持超时列出的监控项类型。
url string (HTTP_AGENT 监控项必填) URL string。
query_fields query参数的根元素。
支持HTTP_AGENT 监控项。
name string (HTTP_AGENT 监控项必填) query参数名称。
value string query参数值。
支持HTTP_AGENT 监控项。
parameters 用户定义参数的根元素。
支持监控项_TYPE_SCRIPT和监控项_TYPE_BROWSER 监控项。
name string (监控项_TYPE_SCRIPT和监控项_TYPE_BROWSER 监控项必填) 用户定义参数名称。
value string 用户定义参数值。
支持监控项_TYPE_SCRIPT和监控项_TYPE_BROWSER 监控项。
posts string HTTP(S)请求体数据。
支持HTTP_AGENT 监控项。
status_codes string 所需HTTP状态码范围,以逗号分隔。
支持HTTP_AGENT 监控项。
follow_redirects string 轮询数据时跟随响应重定向。
支持HTTP_AGENT 监控项。
可选值:1 NO (0)、YES (1,默认值)。
post_type string 提交数据体的类型。
支持HTTP_AGENT 监控项。
可选值:1 RAW (0,默认值)、JSON (2)、XML (3)。
http_proxy string HTTP(S) proxy连接string。
支持HTTP_AGENT 监控项。
headers HTTP(S)请求头的根元素。
支持HTTP_AGENT 监控项。
name string (HTTP_AGENT 监控项必填) 头名称。
value string (HTTP_AGENT 监控项必填) 头值。
retrieve_mode string 应存储响应的哪部分。
支持HTTP_AGENT 监控项。
可选值:1 BODY (0,默认值)、HEADERS (1)、BOTH (2)。
request_method string 请求方法类型。
支持HTTP_AGENT 监控项。
可选值:1 GET (0,默认值)、POST (1)、PUT (2)、HEAD (3)。
output_format string 如何处理响应。
支持HTTP_AGENT 监控项。
可选值:1 RAW (0,默认值)、JSON (1)。
allow_traps string 允许像trapper 监控项一样填充值。
支持HTTP_AGENT 监控项。
可选值:1 NO (0,默认值)、YES (1)。
ssl_cert_file string 公共SSL密钥file路径。
支持HTTP_AGENT 监控项。
ssl_key_file string 私有SSL密钥file路径。
支持HTTP_AGENT 监控项。
ssl_key_password string SSL密钥file密码。
支持HTTP_AGENT 监控项。
verify_peer string 是否验证主机证书的真实性。
支持HTTP_AGENT 监控项。
可选值:1 NO (0,默认值)、YES (1)。
verify_host string 是否验证连接主机名称与主机证书中的名称匹配。
支持HTTP_AGENT 监控项。
可选值:1 NO (0,默认值)、YES (1)。
tags 监控项标签的根元素。
tag string (必填) 标签名称。
value string 标签值。
triggers 主机 监控项触发器的根元素。

另请参阅:Item object(参考具有匹配名称的相关属性)。

主机 监控项 值预处理步骤
元素 类型 描述
type string (必填)监控项值预处理步骤的类型。
可能的值: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 (必填)监控项值预处理步骤参数的根元素。
参数 string 监控项值预处理步骤的单个参数。
error_handler string 预处理步骤失败时使用的动作类型。
可能的值:1 ORIGINAL_ERROR(0,默认)、DISCARD_VALUE(1)、CUSTOM_VALUE(2)、CUSTOM_ERROR(3)。
error_handler_params string 错误处理程序参数。

另请参见:预处理(参考具有匹配名称的相关属性)。

主机 监控项 触发器
元素 类型 描述
uuid string (必填)此触发器的唯一标识符。
expression string (必填)触发器表达式。
recovery_mode string 生成OK事件的基础。
可能的值:1 EXPRESSION(0,默认),RECOVERY_EXPRESSION(1),NONE(2)。
recovery_expression string 触发器恢复表达式。
correlation_mode string 关联模式(无事件关联或按标签进行事件关联)。
可能的值:1 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 ENABLED(0,默认),DISABLED(1)。
priority string 触发器严重程度。
可能的值:1 NOT_CLASSIFIED(0,默认),INFO(1),WARNING(2),AVERAGE(3),HIGH(4),DISASTER(5)。
description text 触发器描述。
type string 事件生成类型(单个问题事件或多个问题事件)。
可能的值:1 SINGLE(0,默认),MULTIPLE(1)。
manual_close string 问题事件的手动关闭。
可能的值:1 NO(0,默认),YES(1)。
dependencies 依赖关系的根元素。
name string (必填)依赖触发器名称。
expression string (必填)依赖触发器表达式。
recovery_expression string 依赖触发器恢复表达式。
tags 触发器标签的根元素。
tag string (必填)标签名称。
value string 标签值。

另请参见:Trigger object(参考具有匹配名称的相关属性)。

主机 低级别自动发现规则

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

元素 类型 描述
type string 监控项 类型。
可能的值: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),监控项_TYPE_SCRIPT(21),监控项_TYPE_BROWSER(22)。
key string (必填)低级别自动发现规则的键值。
filter 主机 低级别自动发现规则过滤器 的根元素。
lifetime string 经过指定时间(以秒为单位,时间后缀user macro)后,不再发现的资源将被删除。
默认值:7d。
lifetime_type string 删除丢失的LLD资源的场景。
可能的值:DELETE_NEVER,DELETE_IMMEDIATELY,DELETE_AFTER。
enabled_lifetime string 经过指定时间(以秒为单位,时间后缀user macro)后,不再发现的资源将被禁用。
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 rule object(请参考具有匹配名称的相关属性)。

主机 低级别自动发现规则过滤器
元素 类型 说明
evaltype string 覆盖过滤条件评估方法。
可能的值:1 AND_OR(0,默认),AND(1),OR(2),FORMULA(3)。
formula string 过滤条件的自定义计算公式。
conditions 过滤条件的根元素。
macro string (必填)要执行检查的低级别发现宏的名称。
value string 要比较的值。
operator string 条件运算符。
可能的值:1 MATCHES_REGEX(8,默认),NOT_MATCHES_REGEX(9)。
formulaid string (必填)用于从自定义表达式中引用条件的任意唯一ID。只能包含大写字母。该ID在修改过滤条件时由用户定义,但在之后请求条件时将重新生成。

另请参阅:lld-规则过滤器(参考具有匹配名称的相关属性)。

主机 低级别自动发现规则覆盖操作
元素 类型 描述
operationobject string 操作所应用的object。
可能的值:1 ITEM_PROTOTYPE (0), TRIGGER_PROTOTYPE (1), GRAPH_PROTOTYPE (2), HOST_PROTOTYPE (3)。
operator string 覆盖条件运算符。
可能的值:1 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 覆盖操作期间为主机原型设置的资产清单模式。

另请参阅:lld-规则覆盖操作(请参考名称匹配的相关属性)。

Web场景 主机

元素 类型 说明
uuid string (必填)此Web场景的唯一标识符。
name string (必填)Web场景名称。
delay string 执行Web场景的频率(使用秒、时间后缀user macro)。
默认值: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 启用(0,默认),禁用(1)。
authentication string 认证方法。
可能值:1 无(0,默认),BASIC(1),NTLM(2)。
http_user string 用于BASIC(HTTP)或NTLM认证的用户名。
http_password string 用于BASIC(HTTP)或NTLM认证的密码。
verify_peer string 验证Web服务器的SSL证书。
可能值:1 否(0,默认),是(1)。
verify_host string 验证Web服务器证书的通用名称字段或主题备用名称字段是否匹配。
可能值:1 否(0,默认),是(1)。
ssl_cert_file string 用于客户端认证的SSL证书file名称(必须为PEM格式)。
ssl_key_file string 用于客户端认证的SSL私钥file名称(必须为PEM格式)。
ssl_key_password string SSL私钥file密码。
steps (必填)主机 Web场景步骤的根元素。
tags Web场景标签的根元素。
tag string (必填)标签名称。
value string 标签值。

另请参阅:Web scenario object(参考具有匹配名称的相关属性)。

主机 网页场景步骤
元素 类型 说明
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 否(0),是(1,默认)。
retrieve_mode string HTTP响应检索模式。
可能的值:1 BODY(0,默认),HEADERS(1),BOTH(2)。
timeout string 步骤执行的超时时间(以秒为单位,时间后缀,或user macro)。
默认值:15秒。
required string 必须出现在响应中的文本(如果为空则忽略)。
status_codes string 逗号分隔的可接受HTTP状态码列表(例如,200-201,210-299;如果为空则忽略)。

另请参阅:场景步骤(参考具有匹配名称的相关属性)。

主机图形

元素 类型 描述
uuid string 图形的唯一标识符。
name string (必填)图形名称。
width integer 图形宽度,单位为像素。
用于预览以及饼图/爆炸图。
可能值:1 20-65535(默认值:900)。
height integer 图形高度,单位为像素。
用于预览以及饼图/爆炸图。
可能值:1 20-65535(默认值:900)。
yaxismin double Y轴最小值。
支持Y轴的固定最小值。
默认值:0。
yaxismax double Y轴最大值。
支持X轴的固定最小值。
默认值:0。
show_work_period string 高亮显示非工作时间。
支持普通图和堆叠图。
可能值:1 否(0),是(1,默认值)。
show_triggers string 将简单触发器值显示为线条。
支持普通图和堆叠图。
可能值:1 否(0),是(1,默认值)。
type string 图形类型。
可能值:1 普通(0,默认值),堆叠(1),饼图(2),爆炸图(3)。
show_legend string 显示图形图例。
可能值:1 否(0),是(1,默认值)。
show_3d string 启用3D样式。
支持普通图和堆叠图。
可能值:1 否(0,默认值),是(1)。
percent_left double 显示左轴的百分位线。
支持普通图。
默认值:0。
percent_right double 显示右轴的百分位线。
支持普通图。
默认值:0。
ymin_type_1 string Y轴最小值。
支持普通图和堆叠图。
可能值:1 自动计算(0,默认值),固定(1),监控项(2)。
ymin_item_1 (如果 ymin_type_1 设置为 ITEM 时必填)单个 监控项 详情的根元素。
主机 string (必填)监控项 主机。
key string (必填)监控项 键。
ymax_type_1 string Y轴最大值。
支持普通图和堆叠图。
可能值:1 自动计算(0,默认值),固定(1),监控项(2)。
ymax_item_1 (如果 ymax_type_1 设置为 ITEM 时必填)单个 监控项 详情的根元素。
主机 string (必填)监控项 主机。
key string (必填)监控项 键。
graph_items (必填)主机 图形 监控项 的根元素。

另请参见:Graph object(参考具有匹配名称的相关属性)。

主机图形监控项
元素 类型 描述
sortorder integer 绘制顺序。数值较小的优先绘制。可用于将线条或区域绘制在另一对象后方(或前方)。
drawtype string 图表监控项的绘制样式。
仅支持普通(NORMAL)图表。
可选值:1 单线(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类型的图表。
calc_fnc string 当某个监控项存在多个值时使用的绘图数据。
可选值:1 最小值(1)、平均值(2,默认)、最大值(4)、全部(7;包含最小值、平均值和最大值;仅支持简单图表)、最后值(9;支持饼图/爆炸图)。
type string 图形监控项类型。
可选值:1 SIMPLE(0,默认值)、GRAPH_SUM(2;该监控项的值代表整个饼图;支持饼图/爆炸式饼图)。
item (必填)单个监控项。
主机 string (必填) 监控项 主机。
string (必填) 监控项 键。

另请参阅:Graph item object(参考具有匹配名称的相关属性)。

主机 值映射

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

另请参阅:Value map object(参考具有匹配名称的相关属性)。

脚注

^ 1 ^ API integer 括号中的值,例如 ENABLED (0),仅为参考。 如需更多信息,请参见表格条目中的链接 API object 页面或每个章节末尾的链接。