4 主机
概述
导出(exported) 的主机具有许多相关对象和对象关系。
主机导出的内容包含:
- 链接的主机组
- 主机数据
- 模板链接
- 主机组链接
- 主机接口
- 直接链接的应用集
- 直接链接的监控项
- 直接链接的触发器
- 直接链接的具有所有原型的发现规则
- 直接链接的web场景
- 主机宏
- 主机资产清单数据
- 值映射
导出
要导出主机,请执行以下操作:
- 前往: Configuration → Hosts
- 标记要导出的主机的复选框
- 单击列表下方的导出

根据选定的格式,主机将导出到具有默认名称的本地文件:
- zabbix_export_hosts.yaml - 导出YAML格式 (默认导出)
- zabbix_export_hosts.xml - 导出XML格式
- zabbix_export_hosts.json - 导出JSON格式
导入
要导入主机,请执行以下操作:
- 前往 数据采集 → 主机。
- 单击右上角的 导入。
- 选择导入文件。
- 单击配置表单右下角的 导入。

如果勾选 高级选项 复选框,将显示所有可导入元素的详细列表 - 根据需要勾选或取消勾选各项导入规则。
如果单击 全部 行中的复选框,其下方所有元素都将被勾选/取消勾选。
导入规则:
| 规则 | 说明 |
|---|---|
| 更新现有项 | 现有元素将使用导入文件中的数据进行更新。否则,它们将不会被更新。 |
| 创建新的 | 将使用导入文件中的数据创建新元素。否则,它们将不会被创建。 |
| 删除缺失项 | 导入文件中不存在的现有元素将被移除。否则,它们将不会被移除。 如果为 模板关联 勾选了 删除缺失项,则当前在导入文件中不存在的模板关联将被取消关联。从已取消关联的模板继承的实体(监控项、触发器、图形等)不会被移除(除非也为每个实体选择了 删除缺失项 选项)。 |
前端中将显示导入成功或失败的消息。
导出格式
导出主机时,Zabbix 会生成结构化的 YAML、JSON 或 XML 格式。 导出内容包括主机元素,例如主机元数据、监控项、宏、触发器等。
每个元素都有特定用途,并且可能包含嵌套元素。
以下各节将说明导出格式中的每个元素。 示例使用了一个链接了 MySQL by Zabbix agent 2 模板的主机。 为演示各元素的用途,在创建主机后会取消链接该模板。 取消链接会将所有元素保留在配置中(不同于取消链接并清除,后者会将其移除)。
省略号 (...) 表示为简洁起见而省略的元素。
当某个元素会在后续章节中进行更详细说明时,会使用注释 (见下表)。
主机元数据
zabbix_export:
version: '8.0'
host_groups:
- uuid: 748ad4d098d447d492bb935c907f652f
name: Databases
hosts: (见下表)
graphs: (见下表)
| 元素 | Type | 描述 | |
|---|---|---|---|
| version | string | (必填)Zabbix 版本。 | |
| host_groups | (必填)主机组的根元素。 | ||
| uuid | string | (必填)此主机组的唯一标识符。 | |
| name | string | (必填)主机组名称。 | |
| hosts | 主机 的根元素。 | ||
| graphs | 主机图形 的根元素。 | ||
主机
zabbix_export:
(...)
hosts:
- host: 'MySQL server'
name: 'MySQL server'
groups:
- name: Databases
interfaces: (见下表)
items: (见下表)
discovery_rules: (见下表)
tags:
- tag: location
value: Riga
macros:
(...)
- macro: '{$MYSQL.DSN}'
value: 192.0.2.0
(...)
- macro: '{$MYSQL.PASSWORD}'
type: SECRET_TEXT
description: 'MySQL user password.'
(...)
valuemaps: (见下表)
(...)
| 元素 | Type | 描述 | |
|---|---|---|---|
| host | string | (必填)唯一主机名称。 | |
| name | string | 可见主机名称。 | |
| description | text | 主机描述。 | |
| monitored_by | string | 主机的监控方式。 可能的值:1 SERVER (0,默认)、PROXY (1) 或 PROXY_GROUP (2)。 |
|
| 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 等;例如,参见 Export format)。 |
|
| inventory_mode | string | 资产记录模式。 可能的值:1 DISABLED (-1)、MANUAL (0,默认)、AUTOMATIC (1)。 |
|
| valuemaps | 主机值映射的根元素。 | ||
另请参见:Host object(请参考名称匹配的相关属性)。
主机接口
zabbix_export:
(...)
hosts:
- host: 'MySQL server'
(...)
interfaces:
- ip: 192.0.2.0
interface_ref: if1
(...)
| Element | Type | Description | |
|---|---|---|---|
| default | string | 此接口是否为主主机接口。请注意,一台主机上每种类型只能有一个主接口。 可能的值:1 NO (0), YES (1,默认)。 |
|
| type | string | 接口类型。 可能的值:1 ZABBIX (1,默认), SNMP (2), IPMI (3), JMX (4)。 |
|
| useip | string | 连接到主机时是否使用 IP 作为接口(否则将使用 DNS)。 可能的值:1 NO (0), YES (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 community。 | |
| 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 NO (0), YES (1,默认)。 |
|
| interface_ref | string | 在监控项中使用的接口引用名称(格式:if<N>)。 |
|
另请参见:主机接口对象(请参考名称匹配的相关属性)。
主机监控项
zabbix_export:
(...)
hosts:
- host: 'MySQL server'
(...)
items:
(...)
- name: 'Binlog cache disk use'
type: DEPENDENT
key: mysql.binlog_cache_disk_use
value_type: FLOAT
description: '由于事务大于 `binlog_cache_size`,无法放入常规二进制日志缓存,因此使用临时磁盘缓存的事务数量。'
preprocessing: (见下表)
master_item:
key: 'mysql.get_status_variables["{$MYSQL.DSN}","{$MYSQL.USER}","{$MYSQL.PASSWORD}"]'
tags:
- tag: component
value: cache
(...)
- name: 'Buffer pool utilization'
type: CALCULATED
key: mysql.buffer_pool_utilization
value_type: FLOAT
units: '%'
params: |
( last(//mysql.innodb_buffer_pool_pages_total) -
last(//mysql.innodb_buffer_pool_pages_free) ) /
( last(//mysql.innodb_buffer_pool_pages_total) +
( last(//mysql.innodb_buffer_pool_pages_total) = 0 ) ) * 100 *
( last(//mysql.innodb_buffer_pool_pages_total) > 0 )
description: '缓冲池中已使用页数与总页数的比率。'
tags:
- tag: component
value: memory
triggers: (见下表)
(...)
- name: Uptime
type: DEPENDENT
key: mysql.uptime
units: uptime
description: '服务器已运行的秒数。'
preprocessing: (见下表)
master_item:
key: 'mysql.get_status_variables["{$MYSQL.DSN}","{$MYSQL.USER}","{$MYSQL.PASSWORD}"]'
tags:
- tag: component
value: application
triggers: (见下表)
(...)
| Element | Type | Description | |
|---|---|---|---|
| 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)、ITEM_TYPE_NESTED (23)。 |
|
| snmp_oid | string | (SNMP_AGENT 监控项必填)SNMP 对象 ID。 | |
| key | string | (必填)监控项键值。 | |
| delay | string | 监控项更新间隔。 默认值:1m。对于 TRAP 监控项,该值始终为 0。 |
|
| history | string | 历史数据的存储时长(使用 time suffix、user macro 或 LLD macro)。 默认值:31d。 |
|
| trends | string | 趋势数据的存储时长(使用 time suffix、user macro 或 LLD 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)、JSON (6)。 |
|
| 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)、Kerberos (3) 或 Digest (4)。 |
|
| 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) 等(支持的字段请参见 Host inventory)。 |
|
| 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 | 监控项数据轮询请求超时。 支持 Timeouts 列表中的监控项类型。 |
|
| 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 监控项。 可能的值:1 NO (0)、YES (1,默认)。 |
|
| post_type | string | 提交数据正文的类型。 支持 HTTP_AGENT 监控项。 可能的值:1 RAW (0,默认)、JSON (2)、XML (3)。 |
|
| http_proxy | string | HTTP(S) proxy 连接字符串。 支持 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 密钥文件路径。 支持 HTTP_AGENT 监控项。 |
|
| ssl_key_file | string | 私有 SSL 密钥文件路径。 支持 HTTP_AGENT 监控项。 |
|
| ssl_key_password | string | SSL 密钥文件的密码。 支持 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(请参考名称匹配的相关属性)。
主机监控项值预处理步骤
zabbix_export:
(...)
hosts:
- host: 'MySQL server'
(...)
items:
(...)
- name: 'Binlog cache disk use'
(...)
preprocessing:
- type: JSONPATH
parameters:
- $.Binlog_cache_disk_use
- type: DISCARD_UNCHANGED_HEARTBEAT
parameters:
- 6h
(...)
| Element | Type | Description | |
|---|---|---|---|
| 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 | 错误处理器参数。 | |
另请参见:监控项预处理对象(请参考名称匹配的相关属性)。
主机监控项触发器
zabbix_export:
(...)
hosts:
- host: 'MySQL server'
(...)
items:
(...)
- name: Uptime
(...)
triggers:
- expression: 'nodata(/MySQL server/mysql.uptime,30m)=1'
name: 'MySQL: Failed to fetch info data'
event_name: 'MySQL: Failed to fetch info data (or no data for 30m)'
priority: INFO
description: 'Zabbix has not received any data for items for the last 30 minutes.'
dependencies:
- name: 'MySQL: Service is down'
expression: 'last(/MySQL server/mysql.ping["{$MYSQL.DSN}","{$MYSQL.USER}","{$MYSQL.PASSWORD}"])=0'
tags:
- tag: scope
value: availability
- expression: 'last(/MySQL server/mysql.uptime)<10m'
name: 'MySQL: Service has been restarted'
event_name: 'MySQL: Service has been restarted (uptime < 10m)'
priority: INFO
description: 'MySQL uptime is less than 10 minutes.'
tags:
- tag: scope
value: notice
(...)
| 元素 | Type | 描述 | |
|---|---|---|---|
| uuid | string | (必填)此触发器的唯一标识符。 | |
| expression | string | (必填)触发器表达式。 | |
| recovery_mode | string | 生成 OK 事件的依据。 可能的值:1 EXPRESSION (0, default), RECOVERY_EXPRESSION (1), NONE (2)。 |
|
| recovery_expression | string | 触发器恢复表达式。 | |
| correlation_mode | string | 关联模式(不进行事件关联,或按标签进行事件关联)。 可能的值:1 DISABLED (0, default), 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, default), DISABLED (1)。 |
|
| priority | string | 触发器严重性。 可能的值:1 NOT_CLASSIFIED (0, default), INFO (1), WARNING (2), AVERAGE (3), HIGH (4), DISASTER (5)。 |
|
| description | text | 触发器描述。 | |
| type | string | 事件生成类型(单个问题事件或多个问题事件)。 可能的值:1 SINGLE (0, default), MULTIPLE (1)。 |
|
| manual_close | string | 手动关闭问题事件。 可能的值:1 NO (0, default), YES (1)。 |
|
| dependencies | 依赖关系的根元素。 | ||
| name | string | (必填)依赖触发器名称。 | |
| expression | string | (必填)依赖触发器表达式。 | |
| recovery_expression | string | 依赖触发器恢复表达式。 | |
| tags | 触发器标签的根元素。 | ||
| tag | string | (必填)标签名称。 | |
| value | string | 标签值。 | |
另请参见:Trigger object(请参考名称匹配的相关属性)。
主机低级发现规则
zabbix_export:
(...)
hosts:
- host: 'MySQL server'
(...)
discovery_rules:
- name: 'Database discovery'
key: 'mysql.db.discovery["{$MYSQL.DSN}","{$MYSQL.USER}","{$MYSQL.PASSWORD}"]'
delay: 1h
filter: (see table below)
description: 'Scanning databases in DBMS.'
interface_ref: if1
item_prototypes:
- name: 'Size of database {#DATABASE}'
key: 'mysql.db.size["{$MYSQL.DSN}","{$MYSQL.USER}","{$MYSQL.PASSWORD}","{#DATABASE}"]'
delay: 5m
units: B
description: 'Database size.'
preprocessing:
- type: DISCARD_UNCHANGED_HEARTBEAT
parameters:
- 1h
interface_ref: if1
tags:
- tag: component
value: storage
- tag: database
value: '{#DATABASE}'
lld_macro_paths:
- lld_macro: '{#DATABASE}'
path: $.Database
preprocessing:
- type: DISCARD_UNCHANGED_HEARTBEAT
parameters:
- 1d
(...)
大多数主机低级发现规则元素与主机监控项相同。 下表描述了与主机监控项不同的那些元素。
| Element | Type | Description | |
|---|---|---|---|
| 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 | 主机原型的根元素,其内容与主机相同。 | ||
| parent_discovery_rule | 低级发现规则原型的父低级发现规则(或规则原型)的根元素。此属性表示它是一个 LLD 规则原型,是所引用规则/规则原型的直接子级。 | ||
| key | string | (必填)父低级发现规则(或规则原型)键值。 | |
| master_item | string | (DEPENDENT 规则必填)依赖规则的主监控项的根元素。 | |
| lld_macro_paths | 低级发现规则宏路径的根元素。 | ||
| lld_macro | string | (必填)低级发现规则宏名称。 | |
| path | string | (必填)值的选择器,该值将被赋给相应的宏。 | |
| preprocessing | 低级发现规则值预处理的根元素。 | ||
| step | 低级发现规则值预处理步骤元素的根元素,其内容与主机监控项值预处理步骤相同,但可用值更少。另请参见:LLD rule preprocessing object。 | ||
| overrides | 低级发现规则覆盖规则的根元素。 | ||
| name | string | (必填)唯一的覆盖名称。 | |
| step | string | (必填)覆盖规则的唯一顺序号。 | |
| stop | string | 如果匹配,则停止处理后续覆盖规则。 | |
| filter | 低级发现规则覆盖规则过滤器元素的根元素,其内容与主机低级发现规则过滤器相同。 | ||
| operations | 主机低级发现规则覆盖操作的根元素。 | ||
另请参见:LLD rule object(请参考具有相同名称的相关属性)。
主机低级别发现规则过滤器
zabbix_export:
(...)
hosts:
- host: 'MySQL server'
(...)
discovery_rules:
- name: 'Database discovery'
(...)
filter:
evaltype: AND
conditions:
- macro: '{#DATABASE}'
value: '{$MYSQL.DBNAME.MATCHES}'
- macro: '{#DATABASE}'
value: '{$MYSQL.DBNAME.NOT_MATCHES}'
operator: NOT_MATCHES_REGEX
(...)
| 元素 | 类型 | 描述 | |
|---|---|---|---|
| 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 rule filter object(请参考具有相同名称的相关属性)。
主机低级别发现规则覆盖操作
| 元素 | 类型 | 描述 | |
|---|---|---|---|
| operationobject | string | 应用该操作的对象。 可能的值:1 ITEM_PROTOTYPE (0)、TRIGGER_PROTOTYPE (1)、GRAPH_PROTOTYPE (2)、HOST_PROTOTYPE (3)、DISCOVERY_PROTOTYPE (4)。 |
|
| 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 规则覆盖操作对象(请参考具有相同名称的相关属性)。
主机 Web 场景
| Element | Type | Description | |
|---|---|---|---|
| uuid | string | (必填)此 Web 场景的唯一标识符。 | |
| name | string | (必填)Web 场景名称。 | |
| delay | string | 执行 Web 场景的频率(使用秒、时间后缀或用户宏)。 默认值: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 ENABLED (0, default), DISABLED (1)。 |
|
| authentication | string | 认证方法。 可能的值:1 NONE (0, default), BASIC (1), NTLM (2), Kerberos (3) 或 Digest (4)。 |
|
| http_user | string | 用于 BASIC (HTTP)、NTLM、Kerberos 或 Digest 认证的用户名。 | |
| http_password | string | 用于 BASIC (HTTP)、NTLM、Kerberos 或 Digest 认证的密码。 | |
| verify_peer | string | 验证 Web 服务器的 SSL 证书。 可能的值:1 NO (0, default), YES (1)。 |
|
| verify_host | string | 验证 Web 服务器证书的 Common Name 字段或 Subject Alternate Name 字段是否匹配。 可能的值:1 NO (0, default), 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 scenario object(请参阅名称匹配的相关属性)。
主机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场景步骤对象(参考相应属性的匹配名称)。
主机图形
zabbix_export:
(...)
graphs:
- name: 'MySQL: Bandwidth'
graph_items: (见下表)
(...)
| Element | Type | Description | |
|---|---|---|---|
| uuid | string | 图形的唯一标识符。 | |
| name | string | (必填)图形名称。 | |
| width | integer | 图形宽度,单位为像素。 用于预览以及饼图/分离饼图。 可能的值:1 20-65535(默认:900)。 |
|
| height | integer | 图形高度,单位为像素。 用于预览以及饼图/分离饼图。 可能的值:1 20-65535(默认:900)。 |
|
| yaxismin | double | Y 轴最小值。 支持 Y 轴最小值为 FIXED 的情况。 默认值:0。 |
|
| yaxismax | double | Y 轴最大值。 支持 X 轴最小值为 FIXED 的情况。 默认值:0。 |
|
| show_work_period | string | 高亮显示非工作时间。 支持 NORMAL 和 STACKED 图形。 可能的值:1 NO (0),YES (1,默认)。 |
|
| show_triggers | string | 以线条形式显示简单触发器值。 支持 NORMAL 和 STACKED 图形。 可能的值: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 样式。 支持 NORMAL 和 STACKED 图形。 可能的值:1 NO (0,默认),YES (1)。 |
|
| percent_left | double | 显示左轴的百分位线。 支持 NORMAL 图形。 默认值:0。 |
|
| percent_right | double | 显示右轴的百分位线。 支持 NORMAL 图形。 默认值:0。 |
|
| ymin_type_1 | string | Y 轴最小值。 支持 NORMAL 和 STACKED 图形。 可能的值:1 CALCULATED (0,默认),FIXED (1),ITEM (2)。 |
|
| ymin_item_1 | (当 ymin_type_1 设置为 ITEM 时必填)各个监控项详细信息的根元素。 |
||
| host | string | (必填)监控项主机。 | |
| key | string | (必填)监控项键值。 | |
| ymax_type_1 | string | Y 轴最大值。 支持 NORMAL 和 STACKED 图形。 可能的值:1 CALCULATED (0,默认),FIXED (1),ITEM (2)。 |
|
| ymax_item_1 | (当 ymax_type_1 设置为 ITEM 时必填)各个监控项详细信息的根元素。 |
||
| host | string | (必填)监控项主机。 | |
| key | string | (必填)监控项键值。 | |
| graph_items | (必填)主机图形监控项的根元素。 | ||
另请参见:Graph object(请参考名称匹配的相关属性)。
主机图形监控项
zabbix_export:
(...)
graphs:
- name: 'MySQL: Bandwidth'
graph_items:
- drawtype: GRADIENT_LINE
color: 199C0D
item:
host: 'MySQL server'
key: mysql.bytes_received.rate
- sortorder: '1'
drawtype: GRADIENT_LINE
color: F63100
item:
host: 'MySQL server'
key: mysql.bytes_sent.rate
(...)
| 元素 | < | 类型 | 描述 | |
|---|---|---|---|---|
| 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 图形。 |
可能的值: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 | (必填)监控项键值。 | |
另请参见:Graph item object(请参考名称匹配的相关属性)。
主机值映射
zabbix_export:
(...)
hosts:
- host: 'MySQL server'
(...)
valuemaps:
- name: 示例值映射
mappings:
- value: '1'
newvalue: 示例值
(...)
| 元素 | 类型 | 描述 | |
|---|---|---|---|
| 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 | (必填)原始值将被映射为的值。 | |
另请参见:值映射对象(请参考名称匹配的相关属性)。
附注
1 API 中的整数值用括号表示,例如,ENABLED (0),仅供参考。 要获取更多信息,请查看表中每个条目的链接 API 对象页面或各节末尾的链接。