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: '8.0'
  images:
    - name: Zabbix_server_3D_(128)
      imagetype: '1'
      encodedImage: iVBOR...5CYII=
  maps:
    - name: '本地网络'
      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 < 链接状态指示器的根元素。

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

地图 selement
元素 类型 描述
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 触发器恢复表达式。

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