2022 Zabbix中国峰会
2022 Zabbix中国峰会

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 string (必须) 此模板群组的唯一表示符
name string (必须) 模板群组名称
host_groups (必须) 主机群组的根元素,该元素会作为主机属性被使用
uuid string (必须) 此主机群组的唯一表示符
name string (必须) 主机群组名称
templates 模板的根元素

模板

元素 类型 描述
uuid string (必须)该模板的唯一标识符。
template string (必需)唯一的模板名称。
name string 可见的模板名称。
description text 模板描述。
vendor 模板供应商的根元素(如果导出的模板可能包含供应商数据)。
name string (必需)模板供应商名称。
version string (必需)模板版本。
对于开箱即用模板,版本显示如下:Zabbix的主要版本号,分隔符("-"),修订号(随着每个新版本的模板增加,Zabbix的主要版本重置)。例如,6.4-0,6.4-3,7.0-0,7.0-3。
templates 关联模板的根元素。
name string (必需)模板名称。
groups 模板组的根元素。
name string (必需)模板组名称。
items 监控项的根元素。
discovery_rules 模板低级发现规则的根元素。
httptests 模板Web场景的根元素。
tags 模板标签的根元素。
tag string (必需)标签名称。
value string 标签值。
macros 模板用户宏的根元素。
macro string (必需)用户宏名称。
type string 用户宏类型。
可能的值:1TEXT(0,默认),SECRET_TEXT(1),VAULT(2)。
value string 用户宏值。
description string 用户宏描述。
dashboards 模板仪表盘的根元素。
valuemaps 模板值映射的根元素。

模板元素

监控项 类型 描述
uuid string (必填) 该监控项的唯一标识符。
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 监控项状态。
可能的取值:2 ENABLED (0, 默认), DISABLED (1)。
value_type string 接收值类型。
可能的取值:3 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 监控项可能的取值:4 PASSWORD (0, 默认), PUBLIC_KEY (1)。
HTTP_AGENT 监控项可能的取值:5 NONE (0, 默认), BASIC (1), NTLM (2)。
username string (对于 SSH 和 TELNET 监控项必填) 认证用户名。
支持 SIMPLE, ODBC, JMX 和 HTTP_AGENT 监控项。
对于 JMX 监控项,应同时指定 password(参见下文)或两者都留空。
password string (对于 SSH 和 TELNET 监控项必填) 认证密码。
publickey string (对于 SSH 监控项必填) 公钥文件名。
privatekey string (对于 SSH 监控项必填) 私钥文件名。
description text 监控项描述。
inventory_link string 由该监控项填充的主机清单字段。
可能的取值:6 NONE (0), ALIAS (4), 等(参见主机清单支持的字段)。
valuemap 监控项值映射的根元素。
name string (必填) 用于该监控项的值映射名称。
logtimefmt string 日志条目中时间的格式。
支持日志值类型的监控项。
preprocessing 监控项值预处理的根元素。
step 模板监控项值预处理步骤的根元素。
jmx_endpoint string JMX 终端点。
支持 JMX 监控项。
master_item (对于 DEPENDENT 监控项必填) 依赖监控项的主监控项的根元素。
key string (必填) 依赖监控项的主监控项键。
timeout string 监控项数据轮询请求超时时间。
支持超时列表中的监控项类型。
url string (对于 HTTP_AGENT 监控项必填) URL 字符串。
query_fields 查询参数的根元素。
支持 HTTP_AGENT 监控项。
name string (对于 HTTP_AGENT 监控项必填) 查询参数名称。
value string 查询参数值。
支持 HTTP_AGENT 监控项。
parameters 用户定义参数的根元素。
支持 ITEM_TYPE_SCRIPT 和 ITEM_TYPE_BROWSER 监控项。
name string (对于 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 监控项。
可能的取值:7 NO (0), YES (1, 默认)。
post_type string 发送数据主体的类型。
仅支持 HTTP_AGENT 监控项。
可能的取值:8 RAW (0, 默认), JSON (2), XML (3)。
http_proxy string HTTP(S) 代理连接字符串。
仅支持 HTTP_AGENT 监控项。
headers HTTP(S) 请求头的根元素。
仅支持 HTTP_AGENT 监控项。
name string (HTTP_AGENT 监控项必填) 请求头名称。
value string (HTTP_AGENT 监控项必填) 请求头的值。
retrieve_mode string 应存储响应的哪一部分。
仅支持 HTTP_AGENT 监控项。
可能的取值:9 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 监控项。
可能的取值:10 RAW (0, 默认), JSON (1)。
allow_traps string 允许类似于陷阱监控项的方式填充值。
仅支持 HTTP_AGENT 监控项。
可能的取值:11 NO (0, 默认), YES (1)。
ssl_cert_file string 公共 SSL Key 文件路径。
仅支持 HTTP_AGENT 监控项。
ssl_key_file string 私有 SSL Key 文件路径。
仅支持 HTTP_AGENT 监控项。
ssl_key_password string SSL Key 文件的密码。
仅支持 HTTP_AGENT 监控项。
verify_peer string 是否验证主机的证书是否真实有效。
仅支持 HTTP_AGENT 监控项。
可能的取值:12 NO (0, 默认), YES (1)。
verify_host string 是否验证连接的主机名与主机证书中的主机名匹配。
仅支持 HTTP_AGENT 监控项。
可能的取值:13 NO (0, 默认), YES (1)。
tags 监控项标签的根元素。
tag string (必填) 标签名称。
value string 标签值。
triggers 模板监控项触发器的根元素。

请参阅:监控项对象(参考相应的具有匹配名称的属性)。

模板项值预处理步骤
元素 类型 描述
type string (必填) 监控项值预处理步骤类型。
可能的取值:14 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 在预处理步骤失败时使用的动作类型。
可能的取值:15 ORIGINAL_ERROR (0, 默认), DISCARD_VALUE (1), CUSTOM_VALUE (2), CUSTOM_ERROR (3)。
error_handler_params string 错误处理器参数。

请参阅:Item预处理对象(参考具有相匹配名称的相关属性)。

模板 低级发现规则

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

元素 类型 描述
type 字符串 项类型。
可能的取值:16 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 字符串 覆盖过滤条件评估方法。
可能的取值:17 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 字符串 应用操作的对象。
可能的取值:18 ITEM_PROTOTYPE(0),TRIGGER_PROTOTYPE(1),GRAPH_PROTOTYPE(2),HOST_PROTOTYPE(3)。
operator 字符串 覆盖条件的运算符。
可能的取值:19 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 string (必填) 此触发器的唯一标识符。
expression string (必填) 触发器表达式。
recovery_mode string 生成恢复事件的基础。
可能的取值:20 EXPRESSION (0, 默认), RECOVERY_EXPRESSION (1), NONE (2)。
recovery_expression string 触发器恢复表达式。
correlation_mode string 关联模式(无事件关联或按标签进行事件关联)。
可能的取值:21 DISABLED (0, 默认), TAG_VALUE (1)。
correlation_tag string 用于事件关联的标签名称。
name string (必填) 触发器名称。
event_name string 事件名称。
opdata string 操作数据。
url_name string 与触发器关联的URL名称。
url string 与触发器关联的URL。
status string 触发器状态。
可能的取值:22 ENABLED (0, 默认), DISABLED (1)。
priority string 触发器严重等级。
可能的取值:23 NOT_CLASSIFIED (0, 默认), INFO (1), WARNING (2), AVERAGE (3), HIGH (4), DISASTER (5)。
description text 触发器描述。
type string 事件生成类型(单个问题事件或多个问题事件)。
可能的取值:24 SINGLE (0, 默认), MULTIPLE (1)。
manual_close string 手动关闭问题事件。
可能的取值:25 NO (0, 默认), YES (1)。
dependencies 依赖项的根元素。
name string (必填) 依赖触发器名称。
expression string (必填) 依赖触发器表达式。
recovery_expression string 依赖触发器恢复表达式。
tags 触发器标签的根元素。
tag string (必填) 标签名称。
value string 标签值。

请参阅:触发器对象(查看具有相匹配名称的相关属性)。

模板网页场景

元素 类型 描述
uuid 字符串 (必需)此网页场景的唯一标识符。
name 字符串 (必需)网页场景名称。
delay 字符串 执行网页场景的频率,使用秒数、时间后缀用户宏
默认值: 1m。
attempts 整数 执行网页场景步骤的尝试次数。
可能的取值:26 1-10(默认值: 1)。
agent 字符串 客户端代理。Zabbix将模拟所选的浏览器。
当网站针对不同浏览器返回不同内容时,这很有用。
默认值: Zabbix。
http_proxy 字符串 执行网页场景时使用的代理,格式如: http://[username[:password]@]proxy.example.com[:port]
variables 网页场景步骤中可能使用的变量的根元素。
name 字符串 (必需)变量名称。
value 文本 (必需)变量值。
headers 执行请求时发送的HTTP头的根元素。
头部应使用与HTTP协议中出现的相同语法。
name 字符串 (必需)头部名称。
value 文本 (必需)头部值。
status 字符串 网页场景的状态。
可能的取值:27 ENABLED (0, 默认), DISABLED (1)。
authentication 字符串 认证方法。
可能的取值:28 NONE (0, 默认), BASIC (1), NTLM (2)。
http_user 字符串 用于BASIC(HTTP)或NTLM认证的用户名。
http_password 字符串 用于BASIC(HTTP)或NTLM认证的密码。
verify_peer 字符串 验证Web服务器的SSL证书。
可能的取值:29 NO (0, 默认), YES (1)。
verify_host 字符串 验证Web服务器证书的Common Name字段或Subject Alternate Name字段是否匹配。
可能的取值:30 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 HTTP POST变量的根元素(原始POST数据字符串或HTTP字段(表单字段数据)数组)。
name 字符串 (必需)POST字段名称。
value 字符串 (必需)POST字段值。
variables 此步骤后应用的步骤级别变量(宏)的根元素。
如果变量值以'regex:'前缀开头,则根据后面跟随的正则表达式模式从此步骤返回的数据中提取其值。
name 字符串 (必需)变量名称。
value 文本 (必需)变量值。
headers 执行请求时发送的HTTP头的根元素。
name 字符串 (必需)头部名称。
value 文本 (必需)头部值。
follow_redirects 字符串 跟随HTTP重定向。
可能的取值:31 NO (0), YES (1, 默认)。
retrieve_mode 字符串 HTTP响应检索模式。
可能的取值:32 BODY (0, 默认), HEADERS (1), BOTH (2)。
timeout 字符串 步骤执行的超时时间(使用秒数、时间后缀用户宏)。
默认值: 15s。
required 字符串 响应中必须存在的文本(如果为空则忽略)。
status_codes 字符串 接受的HTTP状态码的逗号分隔列表(例如,200-201,210-299;如果为空则忽略)。

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

模板仪表盘

元素 类型 描述
uuid 字符串 (必需)此仪表盘的唯一标识符。
name 字符串 (必需)模板仪表盘名称。
display period 整数 仪表盘页面的显示周期。
auto_start 字符串 幻灯片自动开始。
可能的取值:33 NO (0), YES (1, 默认)。
pages 模板仪表盘页面的根元素。
name 字符串 页面名称。
display period 整数 页面的显示周期。
sortorder 整数 页面的排序顺序。
widgets 模板仪表盘组件的根元素。

另请参阅: 模板仪表盘对象(参考相关的具有匹配名称的属性)。

模板仪表板组件
元素 类型 描述
type 字符串 (必需)组件类型。
name 字符串 组件名称。
x 整数 从模板仪表板左侧开始的水平位置。
可能的取值:34 0-71。
y 整数 从模板仪表板顶部开始的垂直位置。
可能的取值:35 0-63。
width 整数 组件宽度。
可能的取值:36 1-72。
height 整数 组件高度。
可能的取值:37 1-64。
hide_header 字符串 隐藏组件标题。
可能的取值:38 NO (0, 默认), YES (1)。
fields 模板仪表板组件字段的根元素。
type 字符串 (必需)组件字段类型。
可能的取值:39 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 字符串 映射匹配类型。
可能的取值:40 EQUAL (0, 默认), GREATER_OR_EQUAL (2), LESS_OR_EQUAL (3), IN_RANGE (4), REGEXP (5), DEFAULT (6)。
value 字符串 原始值。
newvalue 字符串 (必需)原始值映射到的新值。

另请参阅: 值映射对象(参考相关的具有匹配名称的属性)。

附注

1 API中的整数值用方括号标注,例如,ENABLED (0),仅供参考。 有关更多信息,请查看表格条目中的链接API对象页面或每个部分末尾的相关页面。


  1. 1(#footnotes)↩︎

  2. 1(#footnotes)↩︎

  3. 1(#footnotes)↩︎

  4. 1(#footnotes)↩︎

  5. 1(#footnotes)↩︎

  6. 1(#footnotes)↩︎

  7. 1(#footnotes)↩︎

  8. 1(#footnotes)↩︎

  9. 1(#footnotes)↩︎

  10. 1(#footnotes)↩︎

  11. 1(#footnotes)↩︎

  12. 1(#footnotes)↩︎

  13. 1(#footnotes)↩︎

  14. 1(#footnotes)↩︎

  15. 1(#footnotes)↩︎

  16. 1↩︎

  17. 1↩︎

  18. 1↩︎

  19. 1↩︎

  20. 1↩︎

  21. 1↩︎

  22. 1↩︎

  23. 1↩︎

  24. 1↩︎

  25. 1↩︎

  26. 1↩︎

  27. 1↩︎

  28. 1↩︎

  29. 1↩︎

  30. 1↩︎

  31. 1↩︎

  32. 1↩︎

  33. 1↩︎

  34. 1↩︎

  35. 1↩︎

  36. 1↩︎

  37. 1↩︎

  38. 1↩︎

  39. 1↩︎

  40. 1↩︎