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 | 字符串 | (必需)唯一的主机名。 | |
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> )。 |
另请参阅:主机接口对象(参考相应的具有匹配名称的属性)。
主机监控项
元素 | 类型 | 描述 | |
---|---|---|---|
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),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 | 监控项状态。 可能的取值: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查询;CALCULATED监控项的公式;ITEM_TYPE_SCRIPT和ITEM_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类型的监控项必填)公钥文件名。 | |
privatekey | string | (对SSH类型的监控项必填)私钥文件名。 | |
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 | (对于依赖监控项必需)依赖监控项的主监控项的根元素。 | ||
key | string | (必需)依赖监控项的主监控项键。 | |
timeout | string | 监控项数据轮询请求超时。 适用于监控项类型中的超时列表。 | |
url | string | (对于HTTP_AGENT类型必需)URLstring。 | |
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类型的监控项。 可能的值:1NO(0),YES(1,默认). | |
post_type | string | 请求数据主体类型。 适用于HTTP_AGENT类型的监控项。 可能的值:1RAW(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类型的监控项。 可能的值:1BODY(0,默认),HEADERS(1),BOTH(2). | |
request_method | string | 请求方法类型。 适用于HTTP_AGENT类型的监控项。 可能的值:1GET(0,默认),POST(1),PUT(2),HEAD(3). | |
output_format | string | 如何处理响应。 适用于HTTP_AGENT类型的监控项。 可能的值:1RAW(0,默认),JSON(1). | |
allow_traps | string | 允许类似于陷阱项的方式填充值。 适用于HTTP_AGENT类型的监控项。 可能的值:1NO(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类型的监控项。 可能的值:1NO(0,默认),YES(1). | |
verify_host | string | 是否验证连接主机名是否与主机证书中的名称匹配。 适用于HTTP_AGENT类型的监控项。 可能的值:1NO(0,默认),YES(1). | |
tags | 监控项标签的根元素。 | ||
tag | (必需)标签名称。 | ||
value | string | 标签值。 | |
triggers | 主机监控项触发器的根元素(参考hostitemtriggers)。 |
还请参阅:监控项对象(查阅具有匹配名称的相关属性)。
主机监控项值预处理步骤
元素 | 类型 | 描述 | |
---|---|---|---|
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 | (必需)监控项值预处理步骤参数的根元素。 | ||
parameter | string | 监控项值预处理步骤的单个参数。 | |
error_handler | string | 预处理步骤失败时使用的操作类型。 可能的值:1 ORIGINAL_ERROR(0,默认),DISCARD_VALUE(1),CUSTOM_VALUE(2),CUSTOM_ERROR(3). | |
error_handler_params | 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), 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 | 覆盖过滤条件评估方法。 可能的取值: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,但在请求后会生成新的ID。 |
另请参阅: LLD规则过滤器对象(参考相应属性的匹配名称)。
主机低等级发现规则覆盖操作
元素 | 类型 | 描述 | |
---|---|---|---|
operationobject | string | 应用操作的对象。 可能的取值: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 | 用于覆盖条件操作符的正则表达式或字符串。 | |
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事件的基础。 可能的值: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 | 文本 | 触发器描述。 | |
type | string | 事件生成类型(单个问题事件或多个问题事件)。 可能的值:1 SINGLE (0, 默认), MULTIPLE (1). | |
manual_close | string | 手动关闭问题事件。 可能的值:1 NO (0, 默认), YES (1). | |
dependencies | 依赖关系的根元素。 | ||
依赖触发器名称。 | |||
string | (必需)依赖触发器表达式。 | ||
string | 依赖触发器恢复表达式。 | ||
tags | 触发器标签的根元素。 | ||
标签名称。 | |||
string | (必需)标签值。 |
还请参阅:触发器对象(查阅具有匹配名称的相关属性)。
主机图表
元素 | 类型 | 描述 | |
---|---|---|---|
uuid | string | 图表的唯一标识符。 | |
name | string | (必填) 图表名称。 | |
width | integer | 图表宽度,以像素为单位。 用于预览:饼图/分解饼状图。 可能的取值:1 20-65535 (默认值: 900)。 | |
height | integer | 图表高度,以像素为单位。 用于预览:饼图/分解饼状图。 可能的取值:1 20-65535 (默认值: 900)。 | |
yaxismin | double | Y 轴最小值。 支持固定的 Y 轴最小值。 默认值: 0。 | |
yaxismax | double | Y 轴最大值。 支持固定的 Y 轴最大值。 默认值: 0。 | |
show_work_period | string | 高亮显示非工作时间。 支持普通和堆叠图。 可能的取值:1 NO (0), YES (1, 默认)。 | |
show_triggers | string | 显示简单触发器值作为一条线。 支持普通和堆叠图。 可能的取值:1 NO (0), YES (1, 默认)。 | |
type | string | 图表类型。 可能的取值:1 NORMAL (0, 默认), STACKED (1), PIE (2), EXPLODED (3)。 | |
show_legend | string | 显示图例。 可能的取值:1 NO (0), YES (1, 默认)。 | |
show_3d | string | 启用 3D 样式。 支持普通和堆叠图。 可能的取值:1 NO (0, 默认), YES (1)。 | |
percent_left | double | 显示左轴的百分位线。 支持普通图。 默认值: 0。 | |
percent_right | double | 显示右轴的百分位线。 支持普通图。 默认值: 0。 | |
ymin_type_1 | string | Y 轴的最小值。 支持普通和堆叠图。 可能的取值:1 CALCULATED (0, 默认), FIXED (1), ITEM (2)。 | |
ymin_item_1 | (如果 ymin_type_1 设置为 ITEM ,则必填) 单个监控项详细信息的根元素。 | ||
host | string | (必填) 监控项主机。 | |
key | string | (必填) 监控项键。 | |
ymax_type_1 | string | Y 轴的最大值。 支持普通和堆叠图。 可能的取值:1 CALCULATED (0, 默认), FIXED (1), ITEM (2)。 | |
ymax_item_1 | (如果 ymax_type_1 设置为 ITEM ,则必填) 单个监控项详细信息的根元素。 | ||
host | string | (必填) 监控项主机。 | |
key | string | (必填) 监控项键。 | |
graph_items | (必填) 主机图表项的根元素。 |
参见: 图表对象(请参考相应名称的属性)。
主机图表项
元素 | 类型 | 描述 | |
---|---|---|---|
sortorder | integer | 绘制顺序。数值较小的先绘制。可以用于在另一个图形项的后面(或前面)绘制线条或区域。 | |
drawtype | string | 图形项的绘制样式。 支持普通图。 可能的取值: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 轴刻度绘制位置。 支持普通和堆叠图。 可能的取值:1 LEFT (0, 默认), RIGHT (1)。 | |
calc_fnc | string | 如果一个监控项有多个值,用于绘制的数据。 可能的取值:1 MIN (1), AVG (2, 默认), MAX (4), ALL (7; 最小值、平均值和最大值; 仅支持简单图), LAST (9; 仅支持饼图/分解饼图)。 | |
type | string | 图形项类型。 可能的取值:1 SIMPLE (0, 默认), GRAPH_SUM (2; 监控项的值代表整个饼图; 仅支持饼图/分解饼图)。 | |
item | (必填) 单个监控项。 | ||
host | string | (必填) 监控项主机。 | |
key | string | (必填) 监控项键。 |
参见:图形项对象(请参考相应名称的属性)。
主机数值映射
元素 | 类型 | 描述 | |
---|---|---|---|
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 | (必填) 原始值映射到的新值。 |
参见:数值映射对象(请参考相应名称的属性)。
主机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场景的状态。 可能的取值:1 ENABLED (0, 默认), DISABLED (1)。 | |
authentication | string | 认证方法。 可能的取值:1 NONE (0, 默认), BASIC (1), NTLM (2)。 | |
http_user | string | BASIC(HTTP)或NTLM认证使用的用户名。 | |
http_password | string | BASIC(HTTP)或NTLM认证使用的密码。 | |
verify_peer | string | 验证Web服务器的SSL证书。 可能的取值:1 NO (0, 默认), YES (1)。 | |
verify_host | string | 验证Web服务器证书的通用名称字段或主题备用名称字段是否匹配。 可能的取值:1 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重定向。 可能的取值:1 NO (0), YES (1, 默认)。 | |
retrieve_mode | string | HTTP响应检索模式。 可能的取值:1 BODY (0, 默认), HEADERS (1), BOTH (2)。 | |
timeout | string | 步骤执行的超时时间(使用秒、时间后缀或用户宏)。 默认值:15s。 | |
required | string | 响应中必须存在的文本(如果为空则忽略)。 | |
status_codes | string | 接受的HTTP状态码的逗号分隔列表(例如200-201,210-299 ;如果为空则忽略)。 |
另请参阅:Web场景步骤对象(参考相应属性的匹配名称)。
附注
1 API 中的整数值用括号表示,例如,ENABLED (0),仅供参考。 要获取更多信息,请查看表中每个条目的链接 API 对象页面或各节末尾的链接。