5 网络拓扑图

概述

网络拓扑图导出包含：

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

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

导出

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

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

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

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

导入

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

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

导入规则：

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

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

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

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

导出格式

以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 触发器恢复表达式。

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