3 模板
概览
模板 导出 带有许多相关对象和对象关系。
模板导出包含:
- 被链接的主机群组
- 模板数据
- 链接到其他模板
- 链接到其它主机群组
- 直接链接监控项
- 直接链接触发器
- 直接链接图形
- 直接链接仪表盘
- 直接链接自动发现规则及其所有原型(监控项原型、触发器原型、图形原型等等)
- 直接链接web监控场景
- 值映射
导出时
导出模板的步骤如下:
- 前往: 配置 → 模板
- 标记要导出的模板的复选框
- 点击列表下方的Export
根据所选择的格式,模板被导出到一个默认名称的本地文件:
- zabbix_export_templates.yaml - 在 YAML 中导出 (导出的默认选项)
- zabbix_export_templates.xml - 在 XML 中导出
- zabbix_export_templates.json - 在 JSON 中导出
导入时
导入模板的步骤如下:
- 前往: 配置 → 模板
- 点击右边的Import
- 选择导入文件
- 在导入规则中标记所需的选项
- 点击 导入
所有强制输入字段都用红色星号标记。
导入规则:
规则 | 描述 |
---|---|
更新现有的 | 现有元素将使用从导入文件中获取的数据进行更新。 否则,它们将不会被更新。 |
创建新的 | 新元素将会被创建,通过使用导入文件的数据。 否则,新元素将不会被创建。 |
删除错误 | 导入将删除导入文件中不存在的现有元素。 否则,它将不会删除它们。 如果将 删除错误标记为模板链接,则导入文件中不存在的现有模板链接将从模板中移除,同时移除从可能未链接的模板中继承的所有实体(监控项, 触发器, 等等)。 |
在下一个屏幕上,您将能够查看导入的模板的内容。 如果这是一个新模板,所有的元素将以绿色列出。 如果更新一个现有的模板,新的模板元素会以绿色高亮显示; 删除的模板元素用红色高亮显示; 未更改的元素以灰色背景列出。
可以使用左边的菜单浏览更改列表。 部分被更新突出显示了对现有模板元素所做的所有更改。 章节被添加列出了新的模板元素。 每个部分中的元素按元素类型分组; 向下按灰色箭头以展开或折叠元素组。
查看模板更改,然后点击导入执行模板导入。 前端将显示导入成功或失败的消息。
导出格式
使用YAML格式导出的文件内容:
zabbix_export:
version: '7.0'
template_groups:
- uuid: a571c0d144b14fd4a87a9d9b2aa9fcd6
name: Templates/Applications
host_groups:
- uuid: a571c0d144b14fd4a87a9d9b2aa9fcd6
name: Applications
templates:
- uuid: 56079badd056419383cc26e6a4fcc7e0
template: VMware
name: VMware
description: |
You can discuss this template or leave feedback on our forum https://www.zabbix.com/forum/zabbix-suggestions-and-feedback/
Template tooling version used: 0.41
groups:
- name: Templates/Applications
items:
- uuid: 5ce209f4d94f460488a74a92a52d92b1
name: 'VMware: Event log'
type: SIMPLE
key: 'vmware.eventlog[{$VMWARE.URL},skip]'
history: 7d
trends: '0'
value_type: LOG
username: '{$VMWARE.USERNAME}'
password: '{$VMWARE.PASSWORD}'
description: 'Collect VMware event log.'
tags:
- tag: component
value: log
- uuid: ee2edadb8ce943ef81d25dbbba8667a4
name: 'VMware: Full name'
type: SIMPLE
key: 'vmware.fullname[{$VMWARE.URL}]'
delay: 1h
history: 7d
trends: '0'
value_type: CHAR
username: '{$VMWARE.USERNAME}'
password: '{$VMWARE.PASSWORD}'
description: 'VMware service full name.'
preprocessing:
- type: DISCARD_UNCHANGED_HEARTBEAT
parameters:
- 1d
tags:
- tag: component
value: system
- uuid: a0ec9145f2234fbea79a28c57ebdb44d
name: 'VMware: Version'
type: SIMPLE
key: 'vmware.version[{$VMWARE.URL}]'
delay: 1h
history: 7d
trends: '0'
value_type: CHAR
username: '{$VMWARE.USERNAME}'
password: '{$VMWARE.PASSWORD}'
description: 'VMware service version.'
preprocessing:
- type: DISCARD_UNCHANGED_HEARTBEAT
parameters:
- 1d
tags:
- tag: component
value: system
discovery_rules:
- uuid: 16ffc933cce74cf28a6edf306aa99782
name: 'Discover VMware clusters'
type: SIMPLE
key: 'vmware.cluster.discovery[{$VMWARE.URL}]'
delay: 1h
username: '{$VMWARE.USERNAME}'
password: '{$VMWARE.PASSWORD}'
description: 'Discovery of clusters'
item_prototypes:
- uuid: 46111f91dd564a459dbc1d396e2e6c76
name: 'VMware: Status of "{#CLUSTER.NAME}" cluster'
type: SIMPLE
key: 'vmware.cluster.status[{$VMWARE.URL},{#CLUSTER.NAME}]'
history: 7d
username: '{$VMWARE.USERNAME}'
password: '{$VMWARE.PASSWORD}'
description: 'VMware cluster status.'
valuemap:
name: 'VMware status'
tags:
- tag: cluster
value: '{#CLUSTER.NAME}'
- tag: component
value: cluster
- uuid: 8fb6a45cbe074b0cb6df53758e2c6623
name: 'Discover VMware datastores'
type: SIMPLE
key: 'vmware.datastore.discovery[{$VMWARE.URL}]'
delay: 1h
username: '{$VMWARE.USERNAME}'
password: '{$VMWARE.PASSWORD}'
item_prototypes:
- uuid: 4b61838ba4c34e709b25081ae5b059b5
name: 'VMware: Average read latency of the datastore {#DATASTORE}'
type: SIMPLE
key: 'vmware.datastore.read[{$VMWARE.URL},{#DATASTORE},latency]'
history: 7d
username: '{$VMWARE.USERNAME}'
password: '{$VMWARE.PASSWORD}'
description: 'Amount of time for a read operation from the datastore (milliseconds).'
tags:
- tag: component
value: datastore
- tag: datastore
value: '{#DATASTORE}'
- uuid: 5355c401dc244bc588ccd18767577c93
name: 'VMware: Free space on datastore {#DATASTORE} (percentage)'
type: SIMPLE
key: 'vmware.datastore.size[{$VMWARE.URL},{#DATASTORE},pfree]'
delay: 5m
history: 7d
value_type: FLOAT
units: '%'
username: '{$VMWARE.USERNAME}'
password: '{$VMWARE.PASSWORD}'
description: 'VMware datastore space in percentage from total.'
tags:
- tag: component
value: datastore
- tag: datastore
value: '{#DATASTORE}'
- uuid: 84f13c4fde2d4a17baaf0c8c1eb4f2c0
name: 'VMware: Total size of datastore {#DATASTORE}'
type: SIMPLE
key: 'vmware.datastore.size[{$VMWARE.URL},{#DATASTORE}]'
delay: 5m
history: 7d
units: B
username: '{$VMWARE.USERNAME}'
password: '{$VMWARE.PASSWORD}'
description: 'VMware datastore space in bytes.'
tags:
- tag: component
value: datastore
- tag: datastore
value: '{#DATASTORE}'
- uuid: 540cd0fbc56c4b8ea19f2ff5839ce00d
name: 'VMware: Average write latency of the datastore {#DATASTORE}'
type: SIMPLE
key: 'vmware.datastore.write[{$VMWARE.URL},{#DATASTORE},latency]'
history: 7d
username: '{$VMWARE.USERNAME}'
password: '{$VMWARE.PASSWORD}'
description: 'Amount of time for a write operation to the datastore (milliseconds).'
tags:
- tag: component
value: datastore
- tag: datastore
value: '{#DATASTORE}'
- uuid: a5bc075e89f248e7b411d8f960897a08
name: 'Discover VMware hypervisors'
type: SIMPLE
key: 'vmware.hv.discovery[{$VMWARE.URL}]'
delay: 1h
username: '{$VMWARE.USERNAME}'
password: '{$VMWARE.PASSWORD}'
description: 'Discovery of hypervisors.'
host_prototypes:
- uuid: 051a1469d4d045cbbf818fcc843a352e
host: '{#HV.UUID}'
name: '{#HV.NAME}'
group_links:
- group:
name: Applications
group_prototypes:
- name: '{#CLUSTER.NAME}'
- name: '{#DATACENTER.NAME}'
templates:
- name: 'VMware Hypervisor'
macros:
- macro: '{$VMWARE.HV.UUID}'
value: '{#HV.UUID}'
description: 'UUID of hypervisor.'
custom_interfaces: 'YES'
interfaces:
- ip: '{#HV.IP}'
- uuid: 9fd559f4e88c4677a1b874634dd686f5
name: 'Discover VMware VMs'
type: SIMPLE
key: 'vmware.vm.discovery[{$VMWARE.URL}]'
delay: 1h
username: '{$VMWARE.USERNAME}'
password: '{$VMWARE.PASSWORD}'
description: 'Discovery of guest virtual machines.'
host_prototypes:
- uuid: 23b9ae9d6f33414880db1cb107115810
host: '{#VM.UUID}'
name: '{#VM.NAME}'
group_links:
- group:
name: Applications
group_prototypes:
- name: '{#CLUSTER.NAME} (vm)'
- name: '{#DATACENTER.NAME}/{#VM.FOLDER} (vm)'
- name: '{#HV.NAME}'
templates:
- name: 'VMware Guest'
macros:
- macro: '{$VMWARE.VM.UUID}'
value: '{#VM.UUID}'
description: 'UUID of guest virtual machine.'
custom_interfaces: 'YES'
interfaces:
- ip: '{#VM.IP}'
tags:
- tag: class
value: software
- tag: target
value: vmware
macros:
- macro: '{$VMWARE.PASSWORD}'
description: 'VMware service {$USERNAME} user password'
- macro: '{$VMWARE.URL}'
description: 'VMware service (vCenter or ESX hypervisor) SDK URL (https://servername/sdk)'
- macro: '{$VMWARE.USERNAME}'
description: 'VMware service user name'
valuemaps:
- uuid: 3c59c22905054d42ac4ee8b72fe5f270
name: 'VMware status'
mappings:
- value: '0'
newvalue: gray
- value: '1'
newvalue: green
- value: '2'
newvalue: yellow
- value: '3'
newvalue: red
导出元素
导出的元素在下面的表格中进行了解释。
元素 | 类型 | 描述 | |
---|---|---|---|
template_groups | (必须) 模板组的根元素 | ||
uuid | 字符串 | (必须) 此模板组的唯一表示符 | |
name | 字符串 | (必须) 模板组名称 | |
host_groups | (必须) 主机群组的根元素,该元素会作为主机属性被使用 | ||
uuid | 字符串 | (必须) 此主机群组的唯一表示符 | |
name | 字符串 | (必须) 主机群组名称 | |
templates | 模板的根元素 |
模板
元素 | 类型 | 描述 | |
---|---|---|---|
uuid | 字符串 | (必须)该模板的唯一标识符。 | |
template | 字符串 | (必需)唯一的模板名称。 | |
name | 字符串 | 可见的模板名称。 | |
description | 文本 | 模板描述。 | |
vendor | 模板供应商的根元素(如果导出的模板可能包含供应商数据)。 | ||
name | 字符串 | (必需)模板供应商名称。 | |
version | 字符串 | (必需)模板版本。 对于开箱即用模板,版本显示如下:Zabbix的主要版本号,分隔符(“-“),修订号(随着每个新版本的模板增加,Zabbix的主要版本重置)。例如,6.4-0,6.4-3,7.0-0,7.0-3。 | |
templates | 关联模板的根元素。 | ||
name | 字符串 | (必需)模板名称。 | |
groups | 模板组的根元素。 | ||
name | 字符串 | (必需)模板组名称。 | |
items | 监控项的根元素。 | ||
discovery_rules | 模板低级别自动发现规则的根元素。 | ||
httptests | 模板Web场景的根元素。 | ||
tags | 模板标签的根元素。 | ||
tag | 字符串 | (必需)标签名称。 | |
value | 字符串 | 标签值。 | |
macros | 模板用户宏的根元素。 | ||
macro | 字符串 | (必需)用户宏名称。 | |
type | 字符串 | 用户宏类型。 可能的值:1 TEXT(0,默认),SECRET_TEXT(1),VAULT(2)。 | |
value | 字符串 | 用户宏值。 | |
description | 字符串 | 用户宏描述。 | |
dashboards | 模板仪表盘的根元素。 | ||
valuemaps | 模板值映射的根元素。 |
模板监控项
监控项 | 类型 | 描述 | |
---|---|---|---|
uuid | 字符串 | (必填)该监控项的唯一标识符。 | |
name | 字符串 | (必填)监控项名称。 | |
type | 字符串 | 监控项类型。 可能的取值: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 | 字符串 | (对于SNMP_AGENT监控项必填)SNMP对象ID。 | |
key | 字符串 | (必填)监控项键值。 | |
delay | 字符串 | 监控项的更新间隔。 默认:1m。对于TRAP监控项,该值始终为0。 | |
history | 字符串 | 历史数据存储时间段(使用时间后缀,用户宏或LLD宏)。 默认:31d。 | |
trends | 字符串 | 趋势数据存储时间段(使用时间后缀,用户宏或LLD宏)。 默认:365d。 | |
status | 字符串 | 监控项状态。 可能的取值:1 ENABLED(0,默认),DISABLED(1)。 | |
value_type | 字符串 | 接收值类型。 可能的取值:1 FLOAT(0),CHAR(1),LOG(2),UNSIGNED(3,默认),TEXT(4),BINARY(5)。 | |
allowed_hosts | 字符串 | 允许发送数据的主机的逗号分隔IP地址列表。 支持TRAP和HTTP_AGENT监控项。 | |
units | 字符串 | 接收值单位(bps,B等)。 | |
params | text | 根据监控项的类型附加的参数(对于SSH和TELNET监控项为执行脚本;对于ODBC监控项为SQL查询;对于CALCULATED监控项为公式;对于ITEM_TYPE_SCRIPT和ITEM_TYPE_BROWSER监控项为脚本)。 | |
ipmi_sensor | 字符串 | IPMI传感器。 支持IPMI监控项。 | |
authtype | 字符串 | 认证类型。 支持SSH和HTTP_AGENT监控项。 SSH监控项可能的取值:1 PASSWORD(0,默认),PUBLIC_KEY(1)。 HTTP_AGENT监控项可能的取值:1 NONE(0,默认),BASIC(1),NTLM(2)。 | |
username | 字符串 | (对于SSH和TELNET监控项必填)认证用户名。 支持SIMPLE,ODBC,JMX和HTTP_AGENT监控项。 对于JMX监控项,应同时指定 password (参见下文)或两者都留空。 | |
password | 字符串 | (对于SSH和TELNET监控项必填)认证密码。 | |
publickey | 字符串 | (对于SSH监控项必填)公钥文件名。 | |
privatekey | 字符串 | (对于SSH监控项必填)私钥文件名。 | |
description | 文本 | 监控项描述。 | |
inventory_link | 字符串 | 由该监控项填充的主机清单字段。 可能的取值:1 NONE(0),ALIAS(4),等(参见主机清单支持的字段)。 | |
valuemap | 监控项值映射的根元素。 | ||
name | 字符串 | (必填)用于该监控项的值映射名称。 | |
logtimefmt | 字符串 | 日志条目中时间的格式。 支持日志值类型的监控项。 | |
preprocessing | 监控项值预处理的根元素。 | ||
step | 模板监控项值预处理步骤的根元素。 | ||
jmx_endpoint | 字符串 | JMX终端点。 支持JMX监控项。 | |
master_item | (对于DEPENDENT监控项必填)依赖监控项的主监控项的根元素。 | ||
key | 字符串 | (必填)依赖监控项的主监控项键。 | |
timeout | 字符串 | 监控项数据轮询请求超时时间。 支持超时列表中的监控项类型。 | |
url | 字符串 | (对于HTTP_AGENT监控项必填)URL字符串。 | |
query_fields | 查询参数的根元素。 支持HTTP_AGENT监控项。 | ||
name | 字符串 | (对于HTTP_AGENT监控项必填)查询参数名称。 | |
value | 字符串 | 查询参数值。 支持HTTP_AGENT监控项。 | |
parameters | 用户定义参数的根元素。 支持ITEM_TYPE_SCRIPT和ITEM_TYPE_BROWSER监控项。 | ||
name | 字符串 | (对于ITEM_TYPE_SCRIPT和ITEM_TYPE_BROWSER监控项必填)用户定义参数名称。 | |
value | 字符串 | 用户定义参数值。 支持ITEM_TYPE_SCRIPT和ITEM_TYPE_BROWSER监控项。 | |
posts | 字符串 | HTTP(S)请求主体数据。 支持HTTP_AGENT监控项。 | |
status_codes | 字符串 | 所需的HTTP状态码范围,用逗号分隔。 仅支持HTTP_AGENT监控项。 | |
follow_redirects | 字符串 | 在获取数据时是否跟随重定向。 仅支持HTTP_AGENT监控项。 可能的取值:1 NO(0),YES(1,默认)。 | |
post_type | 字符串 | 发送数据主体的类型。 仅支持HTTP_AGENT监控项。 可能的取值:1 RAW(0,默认),JSON(2),XML(3)。 | |
http_proxy | 字符串 | HTTP(S)代理连接字符串。 仅支持HTTP_AGENT监控项。 | |
headers | HTTP(S)请求头的根元素。 仅支持HTTP_AGENT监控项。 | ||
name | 字符串 | (HTTP_AGENT监控项必填)请求头名称。 | |
value | 字符串 | (HTTP_AGENT监控项必填)请求头的值。 | |
retrieve_mode | 字符串 | 应存储响应的哪一部分。 仅支持HTTP_AGENT监控项。 可能的取值:1 BODY(0,默认),HEADERS(1),BOTH(2)。 | |
request_method | 字符串 | 请求方法类型。 仅支持HTTP_AGENT监控项。 可能的取值:1 GET(0,默认),POST(1),PUT(2),HEAD(3)。 | |
output_format | 字符串 | 如何处理响应。 仅支持HTTP_AGENT监控项。 可能的取值:1 RAW(0,默认),JSON(1)。 | |
allow_traps | 字符串 | 允许类似于陷阱监控项的方式填充值。 仅支持HTTP_AGENT监控项。 可能的取值:1 NO(0,默认),YES(1)。 | |
ssl_cert_file | 字符串 | 公共SSLKey文件路径。 仅支持HTTP_AGENT监控项。 | |
ssl_key_file | 字符串 | 私有SSLKey文件路径。 仅支持HTTP_AGENT监控项。 | |
ssl_key_password | 字符串 | SSLKey文件的密码。 仅支持HTTP_AGENT监控项。 | |
verify_peer | 字符串 | 是否验证主机的证书是否真实有效。 仅支持HTTP_AGENT监控项。 可能的取值:1 NO(0,默认),YES(1)。 | |
verify_host | 字符串 | 是否验证连接的主机名与主机证书中的主机名匹配。 仅支持HTTP_AGENT监控项。 可能的取值:1 NO(0,默认),YES(1)。 | |
tags | 监控项标签的根元素。 | ||
tag | 字符串 | (必填)标签名称。 | |
value | 字符串 | 标签值。 | |
triggers | 模板监控项触发器的根元素。 |
请参阅:监控项对象(参考相应的具有匹配名称的属性)。
模板监控项值预处理步骤
元素 | 类型 | 描述 | |
---|---|---|---|
type | 字符串 | (必填) 监控项值预处理步骤类型。 可能的取值: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 | 字符串 | 项值预处理步骤的单个参数。 | |
error_handler | 字符串 | 在预处理步骤失败时使用的动作类型。 可能的取值:1 ORIGINAL_ERROR (0, 默认), DISCARD_VALUE (1), CUSTOM_VALUE (2), CUSTOM_ERROR (3). | |
error_handler_params | 字符串 | 错误处理器参数。 |
请参阅:监控项预处理对象(参考具有相匹配名称的相关属性)。
模板 低级别自动发现规则
大多数低级别自动发现规则模板元素与模板监控项相同。下表描述了与模板监控项不同的那些元素。
元素 | 类型 | 描述 | |
---|---|---|---|
type | 字符串 | 项类型。 可能的取值: 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 | 字符串 | (必需) 低级别自动发现规则的关键字。 | |
filter | 模板低级别自动发现规则过滤器的根元素。 | ||
lifetime | 字符串 | 未再发现的资源将被删除的时间段(使用秒、时间后缀或用户宏)。 默认: 7d。 | |
lifetime_type | 字符串 | 删除不可用的LLD资源的场景。 可能的取值: DELETE_NEVER, DELETE_IMMEDIATELY, DELETE_AFTER。 | |
enabled_lifetime | 字符串 | 启用的LLD资源将被禁用的时间段(使用秒、时间后缀或用户宏)。 | |
enabled_lifetime_type | 字符串 | 禁用不可用的LLD资源的场景。 可能的取值: DISABLE_NEVER, DISABLE_IMMEDIATELY, DISABLE_AFTER。 | |
item_prototypes | 模板项原型元素的根元素,与模板项相同。 | ||
trigger_prototypes | 模板触发器原型元素的根元素,与模板项触发器相同。 | ||
graph_prototypes | 模板图形原型元素的根元素,与主机图形相同。 | ||
host_prototypes | 模板主机原型元素的根元素,与主机相同。 | ||
master_item | 字符串 | (DEPENDENT规则必需) 依赖规则的主项的根元素。 | |
lld_macro_paths | 低级别自动发现规则宏路径的根元素。 | ||
lld_macro | (必需) 低级别自动发现规则宏名称。 | ||
path | 字符串 | (必需) 分配给相应宏的值的选择器。 | |
preprocessing | 低级别自动发现规则值预处理的根元素。 | ||
step | 低级别自动发现规则值预处理步骤元素的根元素,与模板项值预处理步骤相同,但可用值较少。参见: LLD规则预处理对象。 | ||
overrides | 低级别自动发现规则覆盖规则的根元素。 | ||
name | 字符串 | (必需) 唯一的覆盖名称。 | |
step | 字符串 | (必需) 覆盖的唯一顺序号。 | |
stop | 字符串 | 如果匹配,则停止处理下一个覆盖。 | |
filter | 模板低级别自动发现规则覆盖规则过滤器元素的根元素,与模板低级别自动发现规则过滤器相同。 | ||
operations | 模板低级别自动发现规则覆盖操作的根元素。 |
另请参阅: LLD规则对象(参考相关的具有匹配名称的属性)。
模板 低级别自动发现规则过滤器
元素 | 类型 | 描述 | |
---|---|---|---|
evaltype | 字符串 | 覆盖过滤条件评估方法。 可能的取值:1 AND_OR (默认值为0), AND (1), OR (2), FORMULA (3)。 | |
formula | 字符串 | 过滤条件的自定义计算公式。 | |
conditions | 过滤条件的根元素。 | ||
macro | 字符串 | (必需) 执行检查的低级别自动发现宏的名称。 | |
value | 字符串 | 与之比较的值。 | |
operator | 字符串 | 条件运算符。 可能的取值:1 MATCHES_REGEX (8, 默认), NOT_MATCHES_REGEX (9)。 | |
formulaid | 字符串 | (必需) 用于从自定义表达式引用条件的任意唯一ID。只能包含大写字母。用户在修改过滤条件时必须定义ID,但在请求后会生成新的ID。 |
另请参阅: LLD规则过滤器对象(参考相关的具有匹配名称的属性)。
模板低级别自动发现规则覆盖操作
元素 | 类型 | 描述 | |
---|---|---|---|
operationobject | 字符串 | 应用操作的对象。 可能的取值:1 ITEM_PROTOTYPE(0),TRIGGER_PROTOTYPE(1),GRAPH_PROTOTYPE(2),HOST_PROTOTYPE(3)。 | |
operator | 字符串 | 覆盖条件的运算符。 可能的取值:1 EQUAL(1),NOT_EQUAL(2),LIKE(3),NOT_LIKE(4),REGEXP(5),NOT_REGEXP(6)。 | |
value | 字符串 | 用于覆盖条件运算符的正则表达式或字符串。 | |
status | 字符串 | 覆盖操作后对象的状态。 | |
discover | 字符串 | 对象是否作为发现的结果添加。 | |
delay | 字符串 | 覆盖操作后为监控项原型设置的更新间隔。 | |
history | 字符串 | 覆盖操作后为监控项原型设置的历史记录存储期限。 | |
trends | 字符串 | 覆盖操作后为监控项原型设置的趋势存储期限。 | |
severity | 字符串 | 覆盖操作后设置的触发器原型严重性。 | |
tags | 覆盖操作后为对象设置标签的根元素。 | ||
tag | 字符串 | (必需)标签名称。 | |
value | 字符串 | 标签值。 | |
templates | 覆盖操作后与主机原型关联的模板的根元素。 | ||
name | 字符串 | (必需)模板名称。 | |
inventory_mode | 字符串 | 覆盖操作后设置的主机原型资产模式。 |
另请参阅:LLD规则覆盖操作对象(参考相关的具有匹配名称的属性)。
模板 监控项 触发器
元素 | 类型 | 描述 | |
---|---|---|---|
uuid | 字符串 | (必填) 此触发器的唯一标识符。 | |
expression | 字符串 | (必填) 触发器表达式。 | |
recovery_mode | 字符串 | 生成恢复事件的基础。 可能的取值:1 EXPRESSION (0, 默认), RECOVERY_EXPRESSION (1), NONE (2)。 | |
recovery_expression | 字符串 | 触发器恢复表达式。 | |
correlation_mode | 字符串 | 关联模式(无事件关联或按标签进行事件关联)。 可能的取值:1 DISABLED (0, 默认), TAG_VALUE (1)。 | |
correlation_tag | 字符串 | 用于事件关联的标签名称。 | |
name | 字符串 | (必填) 触发器名称。 | |
event_name | 字符串 | 事件名称。 | |
opdata | 字符串 | 操作数据。 | |
url_name | 字符串 | 与触发器关联的URL名称。 | |
url | 字符串 | 与触发器关联的URL。 | |
status | 字符串 | 触发器状态。 可能的取值:1 ENABLED (0, 默认), DISABLED (1)。 | |
priority | 字符串 | 触发器严重等级。 可能的取值:1 NOT_CLASSIFIED (0, 默认), INFO (1), WARNING (2), AVERAGE (3), HIGH (4), DISASTER (5)。 | |
description | text | 触发器描述。 | |
type | 字符串 | 事件生成类型(单个问题事件或多个问题事件)。 可能的取值:1 SINGLE (0, 默认), MULTIPLE (1)。 | |
manual_close | 字符串 | 手动关闭问题事件。 可能的取值:1 NO (0, 默认), YES (1)。 | |
dependencies | 依赖项的根元素。 | ||
name | 字符串 | (必填) 依赖触发器名称。 | |
expression | 字符串 | (必填) 依赖触发器表达式。 | |
recovery_expression | 字符串 | 依赖触发器恢复表达式。 | |
tags | 触发器标签的根元素。 | ||
tag | 字符串 | (必填) 标签名称。 | |
value | 字符串 | 标签值。 |
请参阅:触发器对象(查看具有相匹配名称的相关属性)。
模板网页场景
元素 | 类型 | 描述 | |
---|---|---|---|
uuid | 字符串 | (必需)此网页场景的唯一标识符。 | |
name | 字符串 | (必需)网页场景名称。 | |
delay | 字符串 | 执行网页场景的频率,使用秒数、时间后缀或用户宏。 默认值:1m。 | |
attempts | 整数 | 执行网页场景步骤的尝试次数。 可能的取值:1 1-10(默认值:1)。 | |
agent | 字符串 | 客户端代理。Zabbix将模拟所选的浏览器。 当网站针对不同浏览器返回不同内容时,这很有用。 默认值:Zabbix。 | |
http_proxy | 字符串 | 执行网页场景时使用的代理,格式如:http://[username[:password]@]proxy.example.com[:port] 。 | |
variables | 网页场景步骤中可能使用的变量的根元素。 | ||
name | 字符串 | (必需)变量名称。 | |
value | 文本 | (必需)变量值。 | |
headers | 执行请求时发送的HTTP头的根元素。 头部应使用与HTTP协议中出现的相同语法。 | ||
name | 字符串 | (必需)头部名称。 | |
value | 文本 | (必需)头部值。 | |
status | 字符串 | 网页场景的状态。 可能的取值:1 ENABLED(0,默认),DISABLED(1)。 | |
authentication | 字符串 | 认证方法。 可能的取值:1 NONE(0,默认),BASIC(1),NTLM(2)。 | |
http_user | 字符串 | 用于BASIC(HTTP)或NTLM认证的用户名。 | |
http_password | 字符串 | 用于BASIC(HTTP)或NTLM认证的密码。 | |
verify_peer | 字符串 | 验证Web服务器的SSL证书。 可能的取值:1 NO(0,默认),YES(1)。 | |
verify_host | 字符串 | 验证Web服务器证书的CommonName字段或SubjectAlternateName字段是否匹配。 可能的取值:1 NO(0,默认),YES(1)。 | |
ssl_cert_file | 字符串 | 用于客户端认证的SSL证书文件名(必须为PEM格式)。 | |
ssl_key_file | 字符串 | 用于客户端认证的SSL私钥文件名(必须为PEM格式)。 | |
ssl_key_password | 字符串 | SSL私钥文件密码。 | |
steps | 模板网页场景步骤的根元素(必需)。 | ||
tags | 网页场景标签的根元素。 | ||
tag | 字符串 | (必需)标签名称。 | |
value | 字符串 | 标签值。 |
另请参阅:网页场景对象(参考相关的具有匹配名称的属性)。
模板网页场景步骤
元素 | 类型 | 描述 | |
---|---|---|---|
name | 字符串 | (必需)网页场景步骤名称。 | |
url | 字符串 | (必需)监控的URL。 | |
query_fields | 查询参数的根元素(执行请求时添加到URL的HTTP字段数组)。 | ||
name | 字符串 | (必需)查询参数名称。 | |
value | 字符串 | 查询参数值。 | |
posts | HTTPPOST变量的根元素(原始POST数据字符串或HTTP字段(表单字段数据)数组)。 | ||
name | 字符串 | (必需)POST字段名称。 | |
value | 字符串 | (必需)POST字段值。 | |
variables | 此步骤后应用的步骤级别变量(宏)的根元素。 如果变量值以’regex:’前缀开头,则根据后面跟随的正则表达式模式从此步骤返回的数据中提取其值。 | ||
name | 字符串 | (必需)变量名称。 | |
value | 文本 | (必需)变量值。 | |
headers | 执行请求时发送的HTTP头的根元素。 | ||
name | 字符串 | (必需)头部名称。 | |
value | 文本 | (必需)头部值。 | |
follow_redirects | 字符串 | 跟随HTTP重定向。 可能的取值:1 NO(0),YES(1,默认)。 | |
retrieve_mode | 字符串 | HTTP响应检索模式。 可能的取值:1 BODY(0,默认),HEADERS(1),BOTH(2)。 | |
timeout | 字符串 | 步骤执行的超时时间(使用秒数、时间后缀或用户宏)。 默认值:15s。 | |
required | 字符串 | 响应中必须存在的文本(如果为空则忽略)。 | |
status_codes | 字符串 | 接受的HTTP状态码的逗号分隔列表(例如,200-201,210-299 ;如果为空则忽略)。 |
另请参阅:网页场景步骤对象(参考相关的具有匹配名称的属性)。
模板仪表盘
元素 | 类型 | 描述 | |
---|---|---|---|
uuid | 字符串 | (必需)此仪表盘的唯一标识符。 | |
name | 字符串 | (必需)模板仪表盘名称。 | |
displayperiod | 整数 | 仪表盘页面的显示周期。 | |
auto_start | 字符串 | 幻灯片自动开始。 可能的取值:1 NO(0),YES(1,默认)。 | |
pages | 模板仪表盘页面的根元素。 | ||
name | 字符串 | 页面名称。 | |
displayperiod | 整数 | 页面的显示周期。 | |
sortorder | 整数 | 页面的排序顺序。 | |
widgets | 模板仪表盘组件的根元素。 |
另请参阅:模板仪表盘对象(参考相关的具有匹配名称的属性)。
模板仪表盘组件
元素 | 类型 | 描述 | |
---|---|---|---|
type | 字符串 | (必需)组件类型。 | |
name | 字符串 | 组件名称。 | |
x | 整数 | 从模板仪表板左侧开始的水平位置。 可能的取值:1 0-71。 | |
y | 整数 | 从模板仪表板顶部开始的垂直位置。 可能的取值:1 0-63。 | |
width | 整数 | 组件宽度。 可能的取值:1 1-72。 | |
height | 整数 | 组件高度。 可能的取值:1 1-64。 | |
hide_header | 字符串 | 隐藏组件标题。 可能的取值:1 NO(0,默认),YES(1)。 | |
fields | 模板仪表板组件字段的根元素。 | ||
type | 字符串 | (必需)组件字段类型。 可能的取值:1 INTEGER(0),STRING(1),ITEM(4),ITEM_PROTOTYPE(5),GRAPH(6),GRAPH_PROTOTYPE(7),MAP(8),SERVICE(9),SLA(10),USER(11),ACTION(12),MEDIA_TYPE(13)。 | |
name | 字符串 | (必需)组件字段名称。 | |
value | mixed | (必需)组件字段值,根据字段类型不同而异。 |
另请参阅:模板仪表盘组件对象(参考相关的具有匹配名称的属性)。
模板值映射
元素 | 类型 | 描述 | |
---|---|---|---|
uuid | 字符串 | (必需)此值映射的唯一标识符。 | |
name | 字符串 | (必需)值映射的名称。 | |
mapping | 映射的根元素。 | ||
type | 字符串 | 映射匹配类型。 可能的取值:1 EQUAL(0,默认), GREATER_OR_EQUAL(2), LESS_OR_EQUAL(3),IN_RANGE(4),REGEXP(5),DEFAULT(6)。 | |
value | 字符串 | 原始值。 | |
newvalue | 字符串 | (必需)原始值映射到的新值。 |
另请参阅:值映射对象(参考相关的具有匹配名称的属性)。
附注
1 API中的整数值用方括号标注,例如,ENABLED (0),仅供参考。 有关更多信息,请查看表格条目中的链接API对象页面或每个部分末尾的相关页面。