5 网络拓扑图

概述

网络拓扑图导出包含： - 所有相关的图片 - 拓扑图结构（所有拓扑图设置，包含的所有元素及其设置，拓扑图链接和拓扑图链接状态指示器）

任何主机组、主机、触发器、其他拓扑图或其他可能与导出拓扑图相关的元素都不会被导出。因此，如果拓扑图引用的至少一个元素缺失，导入将失败。

导出

要导出网络拓扑图，请按照以下步骤操作：

转到监控 → 拓扑图。
选择要导出的网络拓扑图的复选框。
点击列表下方的导出按钮。

根据所选的格式，拓扑图将导出到本地文件，并使用默认名称：

zabbix_export_maps.yaml - YAML 格式导出（默认导出选项）；
zabbix_export_maps.xml - XML 格式导出；
zabbix_export_maps.json - JSON 格式导出。

导入

要导入网络拓扑图，请按照以下步骤操作：

进入监控 → 拓扑图。
点击右上角的导入。
选择要导入的文件。
在导入规则中标记所需的选项。
在配置表单的右下角点击导入。

导入规则：

规则	描述
更新现有的	使用导入文件中的数据更新现有的地图。否则，它们将不会被更新。
创建新的	使用导入文件中的数据创建新的地图。否则，它们将不会被创建。

如果取消选中地图选项并选中图像的相应选项，则只会导入图像。只有 超级管理员 用户可以导入图像。

导入操作的成功或失败消息将显示在前端。

如果替换现有图像，将影响所有使用此图像的拓扑图。

导出格式

以YAML格式导出:

zabbix_export:
         version: '7.0'
         images:
           - name: Zabbix_server_3D_(128)
             imagetype: '1'
             encodedImage: iVBOR...5CYII=
         maps:
           - name: 'Local network'
             width: '680'
             height: '200'
             label_type: '0'
             label_location: '0'
             highlight: '1'
             expandproblem: '1'
             markelements: '1'
             show_unack: '0'
             severity_min: '0'
             show_suppressed: '0'
             grid_size: '50'
             grid_show: '1'
             grid_align: '1'
             label_format: '0'
             label_type_host: '2'
             label_type_hostgroup: '2'
             label_type_trigger: '2'
             label_type_map: '2'
             label_type_image: '2'
             label_string_host: ''
             label_string_hostgroup: ''
             label_string_trigger: ''
             label_string_map: ''
             label_string_image: ''
             expand_macros: '1'
             background: {  }
             iconmap: {  }
             urls: {  }
             selements:
               - elementtype: '0'
                 elements:
                   - host: 'Zabbix server'
                 label: |
                   {HOST.NAME}
                   {HOST.CONN}
                 label_location: '0'
                 x: '111'
                 'y': '61'
                 elementsubtype: '0'
                 areatype: '0'
                 width: '200'
                 height: '200'
                 viewtype: '0'
                 use_iconmap: '0'
                 selementid: '1'
                 icon_off:
                   name: Zabbix_server_3D_(128)
                 icon_on: {  }
                 icon_disabled: {  }
                 icon_maintenance: {  }
                 urls: {  }
                 evaltype: '0'
             shapes:
               - type: '0'
                 x: '0'
                 'y': '0'
                 width: '680'
                 height: '15'
                 text: '{MAP.NAME}'
                 font: '9'
                 font_size: '11'
                 font_color: '000000'
                 text_halign: '0'
                 text_valign: '0'
                 border_type: '0'
                 border_width: '0'
                 border_color: '000000'
                 background_color: ''
                 zindex: '0'
             lines: {  }
             links: {  }

导出的元素

下表解释了导出的各个元素。

元素		类型	描述
images			图像的根元素。
	name	string	唯一的图像名称。
	imagetype	integer	图像类型。可能的值： 1-图像； 2-背景。
	encodedImage	string	Base64编码的图像。
maps			地图的根元素。

拓扑图

元素		类型	描述
name		string	唯一的拓扑图名称。
width		integer	拓扑图宽度，以像素为单位。
height		integer	拓扑图高度，以像素为单位。
label_type		integer	拓扑图元素标签类型。可能的取值： 0 - 标签； 1 - 主机IP地址； 2 - 元素名称； 3 - 仅状态； 4 - 无。
label_location		integer	默认情况下拓扑图元素标签的位置。可能的取值： 0 - 底部； 1 - 左侧； 2 - 右侧； 3 - 顶部。
highlight		integer	启用图标高亮显示以显示活动触发器和主机状态。可能的取值： 0 - 否； 1 - 是。
expandproblem		integer	显示具有单个问题的元素的问题触发器。可能的取值： 0 - 否； 1 - 是。
markelements		integer	突出显示最近更改状态的拓扑图元素。可能的取值： 0 - 否； 1 - 是。
show_unack		integer	问题显示设置。可能的取值： 0 - 所有问题计数； 1 - 未确认的问题计数； 2 - 分别确认和未确认的问题计数。
severity_min		integer	默认情况下在拓扑图上显示的最低触发器严重程度。可能的取值： 0 - 未分类； 1 - 信息； 2 - 警告； 3 - 平均； 4 - 高； 5 - 灾难。
show_suppressed		integer	显示因主机维护而被抑制（不显示）的问题。可能的取值： 0 - 否； 1 - 是。
grid_size		integer	拓扑图网格单元格大小，以像素为单位。如果 `grid_show` 设置为 `0`，则支持此选项。可能的取值：20、40、50、75或100。
grid_show		integer	在拓扑图配置中显示网格。可能的取值： 0 - 是； 1 - 否。
grid_align		integer	在拓扑图配置中自动对齐图标。可能的取值： 0 - 是； 1 - 否。
label_format		integer	使用高级标签配置。可能的取值： 0 - 否； 1 - 是。
label_type_host		integer	将标签显示为主机标签。如果 `label_format` 设置为 `1`，则支持此选项。可能的取值： 0 - 标签； 1 - 主机IP地址； 2 - 元素名称； 3 - 仅状态； 4 - 无； 5 - 自定义标签。
label_type_hostgroup		integer	将标签显示为主机组标签。如果 `label_format` 设置为 `1`，则支持此选项。可能的取值： 0 - 标签； 2 - 元素名称； 3 - 仅状态； 4 - 无； 5 - 自定义标签。
label_type_trigger		integer	将标签显示为触发器标签。如果 `label_format` 设置为 `1`，则支持此选项。可能的取值： 0 - 标签； 2 - 元素名称； 3 - 仅状态； 4 - 无； 5 - 自定义标签。
label_type_map		integer	将标签显示为拓扑图标签。如果 `label_format` 设置为 `1`，则支持此选项。可能的取值： 0 - 标签； 2 - 元素名称； 3 - 仅状态； 4 - 无； 5 - 自定义标签。
label_type_image		integer	将标签显示为图像标签。如果 `label_format` 设置为 `1`，则支持此选项。可能的取值： 0 - 标签； 2 - 元素名称； 4 - 无； 5 - 自定义标签。
label_string_host		string	主机元素的自定义标签。如果 `label_type_host` 设置为 `5`，则支持此选项。
label_string_hostgroup		string	主机组元素的自定义标签。如果 `label_type_hostgroup` 设置为 `5`，则支持此选项。
label_string_trigger		string	触发器元素的自定义标签。如果 `label_type_trigger` 设置为 `5`，则支持此选项。
label_string_map		string	拓扑图元素的自定义标签。如果 `label_type_map` 设置为 `5`，则支持此选项。
label_string_image		string	图像元素的自定义标签。如果 `label_type_image` 设置为 `5`，则支持此选项。
expand_macros		integer	在拓扑图配置标签中展开宏。可能的值： 0 - 否； 1 - 是。
background			背景图片的根元素（如果有的话）。仅在`imagetype`设置为`2`时支持。
	name	string	背景图片名称。
iconmap			图标映射的根元素（如果有的话）。
	name	string	图标映射名称。
urls			拓扑图或每个拓扑图元素使用的URL的根元素。
	name	string	链接名称。
	url	string	链接的URL。
	elementtype	integer	链接所属的拓扑图项类型。可能的值： 0 - 主机； 1 - 拓扑图； 2 - 触发器； 3 - 主机组； 4 - 图像。
selements			拓扑图 selements 的根元素（如果有的话）。
shapes			拓扑图形状的根元素。
	type	integer	形状类型。可能的值： 0 - 矩形； 1 - 椭圆。
	x	integer	形状的X坐标（像素）。
	y	integer	形状的Y坐标（像素）。
	width	integer	形状的宽度。
	height	integer	形状的高度。
	text	string	形状内部的文本。
	font	integer	文本字体样式。可能的值： 0 - Georgia, serif； 1 - "Palatino Linotype", "Book Antiqua", Palatino, serif； 2 - "Times New Roman", Times, serif； 3 - Arial, Helvetica, sans-serif； 4 - "Arial Black", Gadget, sans-serif； 5 - "Comic Sans MS", cursive, sans-serif； 6 - Impact, Charcoal, sans-serif； 7 - "Lucida Sans Unicode", "Lucida Grande", sans-serif； 8 - Tahoma, Geneva, sans-serif； 9 - "Trebuchet MS", Helvetica, sans-serif； 10 - Verdana, Geneva, sans-serif； 11 - "Courier New", Courier, monospace； 12 - "Lucida Console", Monaco, monospace。
	font_size	integer	文本字体大小（像素）。
	font_color	string	文本颜色的十六进制代码表示。
	text_halign	integer	文本的水平对齐方式。可能的值： 0 - 居中； 1 - 左对齐； 2 - 右对齐。
	text_valign	integer	文本的垂直对齐方式。可能的值： 0 - 居中； 1 - 顶部对齐； 2 - 底部对齐。
	border_type	integer	形状边框类型。可能的值： 0 - 无； 1 - 粗线； 2 - 点线； 3 - 虚线。
	border_width	integer	边框宽度（像素）。
	border_color	string	边框颜色的十六进制代码表示。
	background_color	string	背景（填充）颜色的十六进制代码表示。
	zindex	integer	用于排序所有形状和线条的值（z-index）。
lines			拓扑图线条的根元素。
	x1	integer	线条点1的X坐标（像素）。
	y1	integer	线条点1的Y坐标（像素）。
	x2	integer	线条点2的X坐标（像素）。
	y2	integer	线条点2的Y坐标（像素）。
	line_type	integer	线条类型。可能的值： 0 - 无； 1 - 粗线； 2 - 点线； 3 - 虚线。
	line_width	integer	线条宽度（像素）。
	line_color	string	线条颜色的十六进制代码表示。
	zindex	integer	用于排序所有形状和线条的值（z-index）。
lines			拓扑图线条的根元素。
	x1	integer	线条点1的X坐标（像素）。
	y1	integer	线条点1的Y坐标（像素）。
	x2	integer	线条点2的X坐标（像素）。
	y2	integer	线条点2的Y坐标（像素）。
	line_type	integer	线条类型。可能的值： 0 - 无； 1 - 粗线； 2 - 点线； 3 - 虚线。
	line_width	integer	线条宽度（像素）。
	line_color	string	线条颜色的十六进制代码表示。
	zindex	integer	用于排序所有形状和线条的值（z-index）。
links			拓扑图元素之间链接的根元素。
	drawtype	integer	链接样式。可能的值： 0 - 线条； 2 - 粗线； 3 - 点线； 4 - 虚线。
	color	string	链接颜色的十六进制代码表示（6个字符）。
	label	string	链接标签。
	selementid1	id	连接的一个元素的ID。
	selementid2	id	连接的另一个元素的ID。
linktriggers			链接状态指示器的根元素。

另请参阅：拓扑图对象（查看具有相匹配名称的相关属性）。

#####拓扑图元素

元素		类型	描述
elementtype		integer	拓扑图元素类型。可能的取值： 0-主机； 1-拓扑图； 2-触发器； 3-主机组； 4-图像。
elements			Zabbix实体的根元素（主机、主机组、拓扑图等）在拓扑图上的表示。所有实体都有它们各自的元素（`host`等；详见导出格式）。
label		string	图标标签。
label_location		integer	标签位置。可能的取值： -1-使用拓扑图默认； 0-底部； 1-左侧； 2-右侧； 3-顶部。
x		integer	X轴上的位置。
y		integer	Y轴上的位置。
elementsubtype		integer	元素子类型。如果`elementtype`设置为`3`，则支持。可能的取值： 0-单个主机组； 1-所有主机组。
areatype		integer	区域大小。如果`elementtype`设置为`1`，则支持。可能的取值： 0-与整个拓扑图相同； 1-自定义大小。
width		integer	区域的宽度。如果`areatype`设置为`1`，则支持。
height		integer	区域的高度。如果`areatype`设置为`1`，则支持。
viewtype		integer	区域放置算法。如果`elementsubtype`设置为`1`，则支持。可能的取值： 0-在区域中均匀放置。
use_iconmap		integer	是否使用图标映射来显示此元素。仅在拓扑图级别激活图标映射时相关。可能的取值： 0-否； 1-是。
selementid		id	唯一元素记录ID。
icon_off			元素处于'OK'状态时使用的图像的根元素。
	name	string	唯一图像名称。
icon_on			元素处于'Problem'状态时使用的图像的根元素。
	name	string	唯一图像名称。
icon_disabled			元素被禁用时使用的图像的根元素。
	name	string	唯一图像名称。
icon_maintenance			元素处于维护状态时使用的图像的根元素。
	name	string	唯一图像名称。
urls			拓扑图或每个拓扑图元素使用的URL的根元素。
	name	string	链接名称。
	url	string	链接URL。
evaltype		integer	标签的评估类型。
tags			问题标签的根元素（用于主机和主机组元素）。如果给定标签，则仅显示具有这些标签的问题。
	tag	string	标签名称。
	value	string	标签值。
	operator	integer	运算符。

另请参阅：拓扑图元素对象（查看相关属性与匹配名称）。

#####拓扑图链接状态指示器

元素		类型	描述
drawtype		integer	当触发器处于'问题'状态时，链接的样式。可能的取值： 0-直线； 2-粗线； 3-点线； 4-虚线。
color		string	当触发器处于'问题'状态时，链接的颜色（6个十六进制符号）。
trigger			用于指示链接状态的触发器的根元素。
	description	string	触发器名称。
	expression	string	触发器表达式。
	recovery_expression	string	触发器恢复表达式。

另请参阅：拓扑图链接触发器对象（查看相关属性与匹配名称）。

Documentation

5 网络拓扑图

概述

导出

导入

导出格式

导出的元素

拓扑图