5 网络拓扑图

概述

网络拓扑图 export 包含：

  • 所有相关的图像
  • 拓扑图结构（所有拓扑图设置、所有包含的元素及其设置、拓扑图链接以及链接状态指示器）

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

导出

要导出网络地图，请执行以下操作：

  1. 转到 Monitoring → Maps。
  2. 勾选要导出的网络地图复选框。
  3. 单击列表下方的 Export 以默认 YAML 格式导出，或单击箭头选择其他导出格式。

根据所选格式，地图将导出到本地文件，默认文件名如下：

  • zabbix_export_maps.yaml - YAML 导出；
  • zabbix_export_maps.xml - XML 导出；
  • zabbix_export_maps.json - JSON 导出。

导入

要import网络拓扑图，请执行以下步骤：

  1. 转到 Monitoring → Maps。
  2. 在Top右上角点击 Import。
  3. 选择要import的文件。
  4. 在import规则中勾选所需的选项。
  5. 在配置表单的右下角点击 Import。

导入规则：

规则 描述
更新现有 将使用import文件中的数据更新现有的拓扑图。否则，不会更新它们。
创建新图 将使用import文件中的数据创建新的拓扑图。否则，不会创建它们。

如果您取消勾选两个拓扑图选项并勾选图像的相应选项，则只会导入图像。 图像导入仅适用于 Super admin 用户。

import操作的成功或失败信息将在前端显示。

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

导出格式

导出为 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 - Top。
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 地图元素的根元素。
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 - Top；
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）的值。
links 地图元素之间链接的根元素。
drawtype integer 链接样式。
可能的值：
0 - 线条；
2 - 粗线；
3 - 点线；
4 - 虚线。
color string 链接颜色（6符号，十六进制）。
label string 链接标签。
selementid1 id 要连接的一个元素的ID。
selementid2 id 要连接的另一个元素的ID。
linktriggers 链接状态指示器的根元素。

另请参见：Map object（参考具有匹配名称的相关属性）。

地图元素
Element Type Description
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 触发器恢复表达式。

另请参阅：地图链接触发器（参考名称匹配的相关属性）。