3 主机

概述

主机 是 exported 具有多种关联 objects 和 object 关系的对象.

主机 export 包含:

  • 关联的 主机 组
  • 主机 数据
  • 模板链接
  • 主机组 链接
  • 主机 接口
  • 直接关联的 监控项
  • 直接关联的触发器
  • 直接关联的图形
  • 直接关联的发现规则及其所有原型
  • 直接关联的Web场景
  • 主机宏
  • 主机 资产数据
  • 值映射

导出

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

  • 前往:配置主机
  • 勾选 主机 的复选框以 export
  • 在列表下方点击Export

根据所选格式,主机会被导出到本地file 使用默认名称:

  • zabbix_export_hosts.yaml - YAML格式的export(默认选项用于 export
  • zabbix_export_hosts.xml - XML格式 export
  • zabbix_export_hosts.json - JSON格式 export

导入

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

  • 前往:Configuration主机
  • 点击右侧的Import
  • 选择importfile
  • 在import规则中标记所需选项
  • 点击Import

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

导入规则:

规则 描述
更新现有 现有元素将使用importfile中的数据更新。否则将不会更新。
创建新 import将使用importfile中的数据添加新元素。否则不会添加。
删除缺失 import将移除importfile中不存在的现有元素。否则不会移除。
如果为模板链接标记了删除缺失,则importfile中不存在的现有模板链接将被取消链接。自Zabbix 6.0.13起,从取消链接的模板继承的实体(监控项、触发器、图形等)不会被移除(除非还为每个实体选择了删除缺失选项)。

导出格式

YAML导出格式:

zabbix_export:
         version: '6.0'
         date: '2023-05-03T11:24:04Z'
         groups:
           - uuid: dc579cd7a1a34222933f24f52a68bcd8
             name: 'Linux servers'
         hosts:
           - host: Example_host
             name: Example_host
             templates:
               - name: 'Zabbix server health'
             groups:
               - name: 'Linux servers'
             items:
               - name: Test_item1
                 type: ZABBIX_ACTIVE
                 key: kernel.maxproc
             inventory_mode: DISABLED

元素标签

元素标签值在下表中进行说明。

主机标签
元素 元素属性 必填 类型 范围1 描述
groups x 主机组的根元素。
name x string 主机组名称。
hosts - 主机的根元素。
host x string 唯一主机名。
name - string 可见主机名。
description - text 主机描述。
status - string 0 - ENABLED (default)
1 - DISABLED
主机状态。
ipmi_authtype - string -1 - DEFAULT (default)
0 - NONE
1 - MD2
2 - MD5
4 - STRAIGHT
5 - OEM
6 - RMCP_PLUS
IPMI会话认证类型。
ipmi_privilege - string 1 - CALLBACK
2 - USER (default)
3 - OPERATOR
4 - ADMIN
5 - OEM
IPMI会话权限级别。
ipmi_username - string IPMI检查的用户名。
ipmi_password - string IPMI检查的密码。
proxy - Proxy。
name x string 监控主机的proxy名称(如有)。
templates - 关联模板的根元素。
name x string 模板名称。
interfaces - 主机接口的根元素。
default - string 0 - NO
1 - YES (default)
是否为主主机接口。
一个一个主机上每种类型只能有一个主接口。
type - string 1 - ZABBIX (default)
2 - SNMP
3 - IPMI
4 - JMX
接口类型。
useip - string 0 - NO
1 - YES (default)
是否使用IP连接主机(否则使用DNS)。
ip - string IP地址,可以是IPv4或IPv6。

通过IP连接时必填。
dns - string DNS名称。

通过DNS连接时必填。
port - string 端口号。支持用户宏。
interface_ref x string Format: if<N> 接口引用名称,用于监控项。
details - 接口详情的根元素。
version - string 1 - SNMPV1
2 - SNMP_V2C (default)
3 - SNMP_V3
使用此SNMPversion。
community - string SNMP团体名。

SNMPv1和SNMPv2监控项必填。
contextname - string SNMPv3上下文名称。

仅用于SNMPv3监控项。
securityname - string SNMPv3安全名称。

仅用于SNMPv3监控项。
securitylevel - string 0 - NOAUTHNOPRIV (default)
1 - AUTHNOPRIV
2 - AUTHPRIV
SNMPv3安全级别。

仅用于SNMPv3监控项。
authprotocol - string 0 - MD5 (default)
1 - SHA1
2 - SHA224
3 - SHA256
4 - SHA384
5 - SHA512
SNMPv3认证协议。

仅用于SNMPv3监控项。
authpassphrase - string SNMPv3认证密码。

仅用于SNMPv3监控项。
privprotocol - string 0 - DES (default)
1 - AES128
2 - AES192
3 - AES256
4 - AES192C
5 - AES256C
SNMPv3隐私协议。

仅用于SNMPv3监控项。
privpassphrase - string SNMPv3隐私密码。

仅用于SNMPv3监控项。
bulk - string 0 - NO
1 - YES (default)
对SNMP使用批量请求。
items - 监控项的根元素。
For item element tag values, see host 主机-监控项标签 tags.
tags - 主机标签的根元素。
tag x string 标签名称。
value - string 标签值。
macros - 宏的根元素。
macro x 用户宏名称。
type - string 0 - TEXT (default)
1 - SECRET_TEXT
2 - VAULT
宏的类型。
value - string 用户宏值。
description - string 用户宏描述。
inventory - 主机资产清单的根元素。
<inventory_property> - 单个资产清单属性。

所有可用资产清单属性列在相应标签下,例如<type>、<name>、<os>(见上例)。
inventory_mode - string -1 - DISABLED
0 - MANUAL (default)
1 - AUTOMATIC
资产清单模式。
valuemaps - 主机值映射的根元素。
name x string 值映射名称。
mapping - 映射的根元素。
value x string 映射的值。
newvalue x string 映射的新值。
主机 监控项标签
元素 元素属性 必需 类型 范围1 描述
items - 监控项的根元素。
name x string 监控项名称。
type - string 0 - ZABBIX_PASSIVE (default)
2 - TRAP
3 - SIMPLE
5 - INTERNAL
7 - ZABBIX_ACTIVE
10 - EXTERNAL
11 - ODBC
12 - IPMI
13 - SSH
14 - TELNET
15 - CALCULATED
16 - JMX
17 - SNMP_TRAP
18 - DEPENDENT
19 - HTTP_AGENT
20 - SNMP_AGENT
21 - ITEM_TYPE_SCRIPT
监控项类型。
snmp_oid - string SNMP object ID。

SNMP 监控项必需。
key x string 监控项键值。
delay - string Default: 1m 监控项的更新间隔。

注意:对于trapper 监控项,delay将始终为'0'。

接受秒数或带后缀的时间单位(30s, 1m, 2h, 1d)。
可选地可以指定一个或多个custom intervals作为灵活间隔或调度。
多个间隔用分号分隔。
可以使用用户宏。单个宏必须填满整个字段。不支持字段中的多个宏或宏与文本混合。
灵活间隔可以写成两个宏,用斜杠分隔(例如{$FLEX_INTERVAL}/{$FLEX_PERIOD})。
history - string Default: 90d 历史数据应存储的时间段。使用时间后缀、用户宏或LLD宏的时间段。
trends - string Default: 365d 趋势数据应存储的时间段。使用时间后缀、用户宏或LLD宏的时间段。
status - string 0 - ENABLED (default)
1 - DISABLED
监控项状态。
value_type - string 0 - FLOAT
1 - CHAR
2 - LOG
3 - UNSIGNED (default)
4 - TEXT
接收值类型。
allowed_hosts - string 允许为监控项发送数据的主机的IP地址列表(逗号分隔)。

用于trapper和HTTP agent 监控项。
units - string 返回值的单位(bps, B等)。
params - text 根据监控项类型的附加参数:
- 脚本、SSH和Telnet 监控项的执行脚本;
- 数据库监控监控项的SQL query;
- 计算监控项的公式。
ipmi_sensor - string IPMI传感器。

仅用于IPMI 监控项。
authtype - string Authentication type for SSH agent items:
0 - PASSWORD (default)
1 - PUBLIC_KEY

Authentication type for HTTP agent items:
0 - NONE (default)
1 - BASIC
2 - NTLM
认证类型。

仅用于SSH和HTTP agent 监控项。
username - string 认证用户名。
用于简单检查、SSH、Telnet、数据库监控、JMX和HTTP agent 监控项。

SSH和Telnet 监控项必需。
当用于JMX agent时,密码也应与用户名一起指定,或者两个属性都应留空。
password - string 认证密码。
用于简单检查、SSH、Telnet、数据库监控、JMX和HTTP agent 监控项。

当用于JMX agent时,用户名也应与密码一起指定,或者两个属性都应留空。
publickey - string 公钥file的名称。

SSH agent 监控项必需。
privatekey - string 私钥file的名称。

SSH agent 监控项必需。
description - text 监控项描述。
inventory_link - string 0 - NONE

Capitalized host inventory field name. For example:
4 - ALIAS
6 - OS_FULL
14 - HARDWARE
etc.
主机库存字段,由监控项填充。

参考主机资产清单获取支持的主机库存字段及其ID列表。
logtimefmt - string 日志条目中的时间格式。
仅用于日志监控项。
interface_ref - string Format: if<N> 引用主机接口。
jmx_endpoint - string JMX端点。

仅用于JMX agent 监控项。
url - string URL string。

仅HTTP agent 监控项必需。
allow_traps - string 0 - NO (default)
1 - YES
允许像trapper 监控项一样填充值。

仅用于HTTP agent 监控项。
follow_redirects - string 0 - NO
1 - YES (default)
在轮询数据时跟随HTTP响应重定向。

仅用于HTTP agent 监控项。
headers - HTTP(S)请求头的根元素,其中头名称用作键,头值用作值。
仅用于HTTP agent 监控项。
name x string 头名称。
value x string 头值。
http_proxy - string HTTP(S) proxy连接string。

仅用于HTTP agent 监控项。
output_format - string 0 - RAW (default)
1 - JSON
如何处理响应。

仅用于HTTP agent 监控项。
post_type - string 0 - RAW (default)
2 - JSON
3 - XML
发布数据正文的类型。

仅用于HTTP agent 监控项。
posts - string HTTP(S)请求正文数据。

仅用于HTTP agent 监控项。
query_fields - query参数的根元素。

仅用于HTTP agent 监控项。
name x string 参数名称。
value - string 参数值。
request_method - string 0 - GET (default)
1 - POST
2 - PUT
3 - HEAD
请求方法。

仅用于HTTP agent 监控项。
retrieve_mode - string 0 - BODY (default)
1 - HEADERS
2 - BOTH
应存储响应的哪部分。

仅用于HTTP agent 监控项。
ssl_cert_file - string 公共SSL密钥file路径。

仅用于HTTP agent 监控项。
ssl_key_file - string 私有SSL密钥file路径。

仅用于HTTP agent 监控项。
ssl_key_password - string SSL密钥file的密码。

仅用于HTTP agent 监控项。
status_codes - string 所需HTTP状态代码的范围,用逗号分隔。支持用户宏。
示例:200,200-{$M},{$M},200-400

仅用于HTTP agent 监控项。
timeout - string 监控项数据轮询请求超时。支持用户宏。

用于HTTP agent和脚本监控项。
verify_host - string 0 - NO (default)
1 - YES
是否验证连接的主机名称与主机证书中的名称匹配。

仅用于HTTP agent 监控项。
verify_peer - string 0 - NO (default)
1 - YES
是否验证主机证书的真实性。

仅用于HTTP agent 监控项。
parameters - 用户定义参数的根元素。

仅用于脚本监控项。
name x string 参数名称。

仅用于脚本监控项。
value - string 参数值。

仅用于脚本监控项。
value map - 值映射。
name x string 用于监控项的值映射名称。
preprocessing - 监控项值预处理的根元素。
step - 单个监控项值预处理步骤。
type x string 1 - MULTIPLIER
2 - RTRIM
3 - LTRIM
4 - TRIM
5 - REGEX
6 - BOOL_TO_DECIMAL
7 - OCTAL_TO_DECIMAL
8 - HEX_TO_DECIMAL
9 - SIMPLE_CHANGE (calculated as (received value-previous value))
10 - CHANGE_PER_SECOND (calculated as (received value-previous value)/(time now-time of last check))
11 - XMLPATH
12 - JSONPATH
13 - IN_RANGE
14 - MATCHES_REGEX
15 - NOT_MATCHES_REGEX
16 - CHECK_JSON_ERROR
17 - CHECK_XML_ERROR
18 - CHECK_REGEX_ERROR
19 - DISCARD_UNCHANGED
20 - DISCARD_UNCHANGED_HEARTBEAT
21 - JAVASCRIPT
22 - PROMETHEUS_PATTERN
23 - PROMETHEUS_TO_JSON
24 - CSV_TO_JSON
25 - STR_REPLACE
26 - CHECK_NOT_SUPPORTED
27 - XML_TO_JSON
监控项值预处理步骤的类型。
parameters - 监控项值预处理步骤参数的根元素。
parameter x string 监控项值预处理步骤的单个参数。
error_handler - string 0 - ORIGINAL_ERROR (default)
1 - DISCARD_VALUE
2 - CUSTOM_VALUE
3 - CUSTOM_ERROR
预处理步骤失败时使用的操作类型。
error_handler_params - string 与'error_handler'一起使用的错误处理程序参数。
master_item - 单个监控项主监控项。

依赖监控项必需。
key x string 依赖监控项主监控项键值。

允许递归最多3个依赖监控项,最大依赖监控项数量为29999。
triggers - 简单触发器的根元素。
For trigger element tag values, see host 主机触发器标签.
tags - 监控项标签的根元素。
tag x string 标签名称。
value - string 标签值。
主机低级别发现规则标签
元素 元素属性 必填 类型 范围1 描述
discovery_rules - 低级发现规则的根元素。
For most of the element tag values, see element tag values for a regular item. Only the tags that are specific to low-level discovery rules, are described below.
type - string 0 - ZABBIX_PASSIVE (default)
2 - TRAP
3 - SIMPLE
5 - INTERNAL
7 - ZABBIX_ACTIVE
10 - EXTERNAL
11 - ODBC
12 - IPMI
13 - SSH
14 - TELNET
16 - JMX
18 - DEPENDENT
19 - HTTP_AGENT
20 - SNMP_AGENT
监控项 类型。
lifetime - string Default: 30d 不再发现的 监控项 将被删除的时间周期。秒数、带后缀的时间单位或用户宏。
filter 单个过滤器。
evaltype - string 0 - AND_OR (default)
1 - AND
2 - OR
3 - FORMULA
用于检查低级发现规则过滤条件的逻辑。
formula - string 过滤条件的自定义计算公式。
conditions - 过滤条件的根元素。
macro x string 低级发现宏名称。
value - string 过滤值:正则表达式或全局正则表达式。
operator - string 8 - MATCHES_REGEX (default)
9 - NOT_MATCHES_REGEX
条件运算符。
formulaid x character 用于从自定义表达式中引用条件的任意唯一ID。只能包含大写字母。修改过滤条件时必须由用户定义ID,但在后续请求时会重新生成。
lld_macro_paths - LLD宏路径的根元素。
lld_macro x string 低级发现宏名称。
path x string 选择器,用于分配给相应宏的值。
preprocessing - LLD规则值预处理。
step - 单个LLD规则值预处理步骤。
For most of the element tag values, see element tag values for a host item value preprocessing. Only the tags that are specific to low-level discovery value preprocessing, are described below.
type x string 5 - REGEX
11 - XMLPATH
12 - JSONPATH
15 - NOT_MATCHES_REGEX
16 - CHECK_JSON_ERROR
17 - CHECK_XML_ERROR
20 - DISCARD_UNCHANGED_HEARTBEAT
21 - JAVASCRIPT
23 - PROMETHEUS_TO_JSON
24 - CSV_TO_JSON
25 - STR_REPLACE
27 - XML_TO_JSON
监控项 值预处理步骤的类型。
trigger_prototypes - 触发器原型的根元素。
For trigger prototype element tag values, see regular 主机触发器标签 tags.
graph_prototypes - 图形原型的根元素。
For graph prototype element tag values, see regular 主机图形标签 tags.
host_prototypes - 主机 原型的根元素。
For host prototype element tag values, see regular 主机标签 tags.
item_prototypes - 监控项原型 的根元素。
For item prototype element tag values, see regular 主机-监控项标签 tags.
master_item - 单个 监控项 原型主 监控项/监控项 原型数据。
key x string 依赖 监控项 原型主 监控项/监控项 原型键值。

依赖 监控项 的必填项。
主机触发器标签
元素 元素属性 必填 类型 范围1 描述
triggers - 触发器根元素。
expression x string 触发器表达式。
recovery_mode - string 0 - EXPRESSION (default)
1 - RECOVERY_EXPRESSION
2 - NONE
生成OK事件的基础。
recovery_expression - string 触发器恢复表达式。
correlation_mode - string 0 - DISABLED (default)
1 - TAG_VALUE
关联模式(无事件关联或通过标签进行事件关联)。
correlation_tag - string 用于事件关联的标签名称。
name x string 触发器名称。
event_name - string 事件名称。
opdata - string 操作数据。
url - string 与触发器关联的URL。
status - string 0 - ENABLED (default)
1 - DISABLED
触发器状态。
priority - string 0 - NOT_CLASSIFIED (default)
1 - INFO
2 - WARNING
3 - AVERAGE
4 - HIGH
5 - DISASTER
触发器严重性。
description - text 触发器描述。
type - string 0 - SINGLE (default)
1 - MULTIPLE
事件生成类型(单个问题事件或多个问题事件)。
manual_close - string 0 - NO (default)
1 - YES
手动关闭问题事件。
dependencies - 依赖项根元素。
name x string 依赖触发器名称。
expression x string 依赖触发器表达式。
recovery_expression - string 依赖触发器恢复表达式。
tags - 事件标签根元素。
tag x string 标签名称。
value - string 标签值。
主机图形标签
元素 元素属性 必填 类型 范围1 描述
graphs - 图表根元素。
name x string 图表名称。
width - integer 20-65535 (default: 900) 图表宽度,单位为像素。用于预览及饼图/爆炸图。
height - integer 20-65535 (default: 200) 图表高度,单位为像素。用于预览及饼图/爆炸图。
yaxismin - double Default: 0 Y轴最小值。

当'ymin_type_1'为FIXED时使用。
yaxismax - double Default: 0 Y轴最大值。

当'ymax_type_1'为FIXED时使用。
show_work_period - string 0 - NO
1 - YES (default)
高亮非工作时间。

用于普通图和堆叠图。
show_triggers - string 0 - NO
1 - YES (default)
将简单触发器值显示为线条。

用于普通图和堆叠图。
type - string 0 - NORMAL (default)
1 - STACKED
2 - PIE
3 - EXPLODED
图表类型。
show_legend - string 0 - NO
1 - YES (default)
显示图例。
show_3d - string 0 - NO (default)
1 - YES
启用3D样式。

用于饼图和爆炸饼图。
percent_left - double Default:0 显示左轴百分位线。

仅用于普通图。
percent_right - double Default:0 显示右轴百分位线。

仅用于普通图。
ymin_type_1 - string 0 - CALCULATED (default)
1 - FIXED
2 - ITEM
Y轴最小值。

用于普通图和堆叠图。
ymax_type_1 - string 0 - CALCULATED (default)
1 - FIXED
2 - ITEM
Y轴最大值。

用于普通图和堆叠图。
ymin_item_1 - 单个监控项详情。

当'ymin_type_1'为监控项时必填。
host x string 监控项 主机。
key x string 监控项键。
ymax_item_1 - 单个监控项详情。

当'ymax_type_1'为监控项时必填。
host x string 监控项 主机。
key x string 监控项键。
graph_items x 图表监控项根元素。
sortorder - integer 绘制顺序。数值小的优先绘制。可用于将线条或区域绘制在另一元素后方(或前方)。
drawtype - string 0 - SINGLE_LINE (default)
1 - FILLED_REGION
2 - BOLD_LINE
3 - DOTTED_LINE
4 - DASHED_LINE
5 - GRADIENT_LINE
图表监控项绘制样式。

仅用于普通图。
color - string 元素颜色(6位十六进制)。
yaxisside - string 0 - LEFT (default)
1 - RIGHT
图表监控项Y轴绘制位置。

用于普通图和堆叠图。
calc_fnc - string 1 - MIN
2 - AVG (default)
4 - MAX
7 - ALL (minimum, average and maximum; used only by simple graphs)
9 - LAST (used only by pie and exploded pie graphs)
当监控项存在多个值时绘制何种数据。
type - string 0 - SIMPLE (default)
2 - GRAPH_SUM (value of the item represents the whole pie; used only by pie and exploded pie graphs)
图表监控项类型。
item x 单个监控项。
host x string 监控项 主机。
key x string 监控项键。
主机 Web 场景标签
元素 元素属性 必填 类型 范围1 描述
httptests - 网络场景的根元素。
name x string 网络场景名称.
delay - string Default: 1m 执行Web场景的频率. 支持秒数/带后缀的时间单位/用户宏.
attempts - integer 1-10 (default: 1) 执行Web场景步骤的尝试次数。
agent - string Default: Zabbix 客户端 agent. Zabbix将模拟所选浏览器。当网站针对不同浏览器返回不同内容时,此功能非常有用。
http_proxy - string 指定要使用的HTTP proxy,格式为:http://[username[:password]@]proxy.example.com[:port]
variables - 用于场景步骤中可能使用的场景级变量(宏)的根元素。
name x text 变量名称.
value x text 变量值.
headers - 执行请求时将发送的HTTP头部信息的根元素。头部应按照HTTP协议中出现的相同语法列出。
name x text 表头名称.
value x text 表头值.
status - string 0 - ENABLED (default)
1 - DISABLED
Web场景状态.
authentication - string 0 - NONE (default)
1 - BASIC
2 - NTLM
认证方法
http_user - string 用于基本认证、HTTP或NTLM认证的用户名。
http_password - string 用于基本认证、HTTP认证或NTLM认证的密码。
verify_peer - string 0 - NO (default)
1 - YES
是否验证主机证书的真实性。
verify_host - string 0 - NO (default)
1 - YES
是否验证连接中主机名称与主机证书中的名称匹配.
ssl_cert_file - string 用于客户端认证的SSL证书file名称(必须为PEM格式)。
ssl_key_file - string 用于客户端认证的SSL私钥file名称(必须为PEM格式)。
ssl_key_password - string SSL私钥 file 密码.
steps x Web场景步骤的根元素。
name x string Web场景步骤名称.
url x string 监控URL.
query_fields - query字段的根元素 - 一个HTTP字段的array,在执行请求时将被添加到URL中。
name x string query 字段名称.
value - string query 字段值.
posts - 以string(原始POST数据)或HTTP字段array(表单字段数据)形式传递的HTTP POST变量。
name x string 表单字段名称.
value x string 发布字段值.
variables - 应在此步骤后应用的步骤级变量(宏)的根元素。

如果变量值带有'regex:'前缀,则根据'regex:'前缀后的正则表达式模式,从该步骤返回的数据中提取其值
name x string 变量名称.
value x string 变量值.
headers - 执行请求时将发送的HTTP头部信息的根元素。头部信息应使用与HTTP协议中相同的语法列出。
name x string 表头名称.
value x string 表头值.
follow_redirects - string 0 - NO
1 - YES (default)
跟随HTTP重定向。
retrieve_mode - string 0 - BODY (default)
1 - HEADERS
2 - BOTH
HTTP响应检索模式.
timeout - string Default: 15s 步骤执行超时时间。单位为秒,可带后缀的时间单位或用户宏。
required - string 响应中必须包含的文本。如果为空则忽略。
status_codes - string 以逗号分隔的HTTP状态码允许列表. 若为空则忽略. 例如: 200-201,210-299
tags - Web场景标签的根元素。
tag x string 标签名称.
value - string 标签值.
脚注

1 对于string值,仅会导出string本身(例如"ZABBIX_ACTIVE"),而不包含本表中使用的编号。本表中范围值(对应API值)的编号仅用于排序目的。