1 配置网络拓扑图

概述

在 Zabbix 中配置地图时，首先需要通过定义其常规参数来创建地图，然后再开始用元素及其链接填充实际地图。

您可以使用以下元素填充地图：主机、主机组、触发器、图像或另一张地图。

图标用于表示地图元素。您可以定义图标上显示的信息，并设置以特殊方式显示最近的问题。您还可以链接这些图标，并定义在链接上显示的信息。

您可以添加自定义 URL，以便通过点击图标进行访问。因此，您可以将主机图标链接到主机属性，或将地图图标链接到另一张地图。

地图中的问题计数仅显示根因问题。

地图在 Monitoring > Maps 中进行管理，您可以在其中对其进行配置、管理和查看。在监控视图中，您可以点击图标，并利用指向某些脚本和 URL 的链接。

网络地图基于矢量图形（SVG）。

公共和私有拓扑图

Zabbix 中的所有用户（包括非管理员用户）都可以创建网络拓扑图。 拓扑图有一个所有者——即创建它们的用户。拓扑图可以设为公共 或私有。

  • 公共 拓扑图对所有用户可见，但要查看它们，用户 必须对至少一个拓扑图元素具有读权限。公共拓扑图可以 被编辑，前提是某个用户/用户组对此拓扑图具有读写权限， 并且对相应拓扑图的所有元素（包括链接中的触发器） 至少具有读权限。
<!-- -->
  • 私有 拓扑图仅对其所有者以及所有者与之共享 的用户/用户组可见。普通（非超级管理员）用户只能与其所属的组 以及属于这些组的用户共享。管理员级别用户无论是否为所有者或是否属于 共享用户列表，都可以查看私有拓扑图。私有拓扑图可以由其所有者编辑； 如果某个用户/用户组对此拓扑图具有读写权限，并且对相应拓扑图的所有元素 （包括链接中的触发器）至少具有读权限，也可以进行编辑。

用户没有读权限的拓扑图元素会以灰显图标显示，并且该元素上的所有文本信息都会被隐藏。 但是，即使用户对触发器没有权限，触发器标签仍然可见。

要向拓扑图添加元素，用户还必须对该元素至少具有读权限。

创建地图

要创建地图，请执行以下操作：

  1. 前往 Monitoring > Maps。
  2. 进入显示所有地图的视图。
  3. 单击 Create map。

您也可以在现有地图的配置表单中使用 Clone 按钮来创建新地图。
此地图将具有现有地图的所有属性，包括常规布局属性以及现有地图中的元素。

Map 标签页包含地图的常规属性：

所有必填输入字段都用红色星号标记。

地图常规属性：

Parameter Description
Owner 地图所有者名称。
Name 唯一的地图名称。
Width 地图宽度，以像素为单位。
Height 地图高度，以像素为单位。
Background image 使用背景图像：
No image - 不使用背景图像（白色背景）
Image - 使用所选图像作为背景图像。您可以使用地理地图或任何其他图像来增强您的地图。
Background scale 使用背景缩放：
None - 不缩放；
Proportionally - 覆盖整个地图背景，但保持图像比例（默认）。
Automatic icon mapping 您可以设置使用自动图标映射，该映射在 Administration > General > Icon mapping 中配置。图标映射允许根据特定的主机清单字段映射特定图标。
Icon highlight 如果选中此复选框，地图元素将被高亮显示。
具有活动触发器的元素将获得圆形背景，颜色与最高严重性触发器相同。此外，如果所有问题都已确认，圆圈周围将显示一条粗绿色线。
处于“disabled”或“in maintenance”状态的元素将分别获得灰色和橙色的方形背景。
另请参见：查看地图
Mark elements on trigger status change 最近的触发器状态变化（最近出现的问题或恢复）将通过标记高亮显示：在元素图标未被标签占用的三侧显示向内指向的红色三角形。标记显示 30 分钟。
Display problems 选择如何在地图元素上显示问题：
Expand single problem - 如果只有一个问题，则显示问题名称。否则，显示问题总数。
Number of problems - 显示问题总数
Number of problems and expand most critical one - 显示最严重问题的名称以及问题总数。
“最严重”根据问题严重性确定；如果严重性相同，则根据问题事件 ID 确定（ID 更高或更晚的问题优先显示）。对于 trigger map element，则根据问题严重性确定；如果相同，则根据触发器在触发器列表中的位置确定。如果同一触发器有多个问题，则显示最近的一个。
Advanced labels 如果选中此复选框，您将能够为不同的元素类型定义不同的标签类型。
Host group label type 用于地图元素的标签类型：
Label - 地图元素标签
IP address - IP 地址
Element name - 元素名称（例如，主机名称）
Status only - 仅状态（OK 或 PROBLEM）
Nothing - 不显示标签
Host label type
Trigger label type
Map label type
Image label type
Map element label location 标签相对于地图元素的位置：
Bottom - 在地图元素下方
Left - 在左侧
Right - 在右侧
Top - 在地图元素上方
Show map element labels 选择如何显示地图元素标签：
Always - 始终显示（默认）；
Auto hide - 如果未悬停或未选中，则隐藏标签。
Show link labels 选择如何显示链接标签：
Always - 始终显示（默认）；
Auto hide - 如果未悬停或未选中，则隐藏标签。
Problem display 将问题计数显示为：
All - 显示完整的问题计数
Separated - 将未确认问题数作为总问题数中的单独数字显示
Unacknowledged only - 仅显示未确认问题数
Minimum severity 低于所选最低严重性级别的问题将不会显示在地图上。
例如，选择 Warning 时，Information 和 Not classified 级别触发器的变化将不会反映在地图中。
Show suppressed problems 选中此复选框可显示由于主机维护而原本会被抑制（不显示）的问题。
URLs 可在此为每种元素类型定义 URL，其中：
Name - URL 的标签；
URL - URL（最多 2048 个字符）；
Element - 元素类型（例如，Host、Host group 等）。
当用户在地图查看模式下单击元素时，这些 URL 将显示为链接。
可在地图 URL 名称和值中使用宏。完整列表请参见支持的宏，并搜索“map URL names and values”。

分享

分享选项卡包含拓扑图类型以及私有拓扑图的分享选项（用户组，用户）：

参数 说明
类型 选择拓扑图类型：
私有 - 地图仅对选定的用户组和用户可见
公共 - 地图对所有人可见
用户组共享列表 选择拓扑图可访问的用户组。
您可以允许只读或读写访问。
用户共享列表 选择可以访问拓扑图的用户。
您可以允许只读或读写访问。

当您单击 添加 保存此拓扑图时，您已创建了一个具有名称、尺寸和某些偏好的空拓扑图。现在您需要添加一些元素。为此，请单击地图列表中的 编辑 以打开可编辑区域。

添加元素

要添加元素，请点击 Map element 旁边的 Add。新元素 将出现在地图的左上角。将其拖放到 你想要的位置即可。

请注意，当 Grid 选项设为“On”时，元素将始终与 网格对齐（你可以从下拉菜单中选择不同的网格大小，也可以隐藏/显示 网格）。如果你希望元素可以放置在任意位置而不对齐，请将 该选项设为“Off”。（你也可以稍后通过点击 Align map elements， 将任意元素对齐到网格。）

现在你已经放置了一些元素，可能希望通过设置名称等方式 来区分它们。点击某个元素后，会显示一个 表单，你可以设置元素类型、指定名称、选择 不同的图标等。

地图元素属性：

参数 描述
Type 元素类型：
Host - 表示所选主机全部触发器状态的图标
Map - 表示某个地图中所有元素状态的图标
Trigger - 表示一个或多个触发器状态的图标
Host group - 表示所选组中所有主机的全部触发器状态的图标
Image - 一个图标，不链接到任何资源
Label 图标标签，可为任意字符串。
可使用宏和多行字符串。
此字段支持表达式宏，但仅支持带时间参数的 avg、last、min 和 max 函数（例如 {?avg(/host/key,1h)}）。
有关支持的宏完整列表，请参见 supported macros，并搜索“map element labels”。
Label location 标签相对于图标的位置：
Default - 使用地图的默认标签位置；
Bottom - 位于图标下方；
Left - 位于左侧；
Right - 位于右侧；
Top - 位于上方。
Show label 选择元素标签的显示方式：
Default - 使用地图配置中的 Show map element labels 设置（默认）；
Always - 始终显示（默认）；
Auto hide - 未悬停或未选中时隐藏标签。
Host 选择一个主机；或者输入主机名称。此字段支持自动补全，因此开始输入主机名称时，将显示匹配主机的下拉列表。向下滚动以选择其中一个。点击移除 (x) 图标可移除所选内容。
此字段仅适用于 Host 类型的元素。
Map 选择一个地图；或者输入地图名称。此字段支持自动补全，因此开始输入地图名称时，将显示匹配地图的下拉列表。向下滚动以选择其中一个。点击移除 (x) 图标可移除所选内容。
此字段仅适用于 Map 类型的元素。
Triggers 在下方的 New triggers 字段中选择一个或多个触发器，然后点击 Add。或者，开始输入触发器名称，并从匹配触发器的下拉列表中选择一个。点击移除 (x) 图标可移除所选内容。
此字段仅适用于 Trigger 类型的元素。
已选触发器的顺序可以更改，但只能在相同严重性级别的触发器之间调整。多个触发器的选择还会影响编辑模式和查看模式下 {HOST.*} 宏的解析。
在编辑模式下，首先显示的 {HOST.*} 宏将根据列表中的第一个触发器进行解析（基于触发器严重性）。
查看模式取决于常规地图属性中的 Display problems 参数：
- 如果选择 Expand single problem 模式，则首先显示的 {HOST.*} 宏将根据最近检测到的问题触发器进行解析（不考虑严重性），如果未检测到问题，则根据列表中的第一个触发器解析。
- 如果选择 Number of problems and expand most critical one 模式，则首先显示的 {HOST.*} 宏将根据触发器严重性进行解析。
Host group 选择一个主机组；或者输入主机组名称。此字段支持自动补全，因此开始输入主机组名称时，将显示匹配主机组的下拉列表。向下滚动以选择其中一个。点击移除 (x) 图标可移除所选内容。
此字段仅适用于 Host group 类型的元素。
Problem tags 指定标签以限制小部件中显示的问题数量。可以包含或排除特定标签及标签值。可设置多个条件。标签名称匹配始终区分大小写。
每个条件可使用以下运算符：
Exists - 包含指定的标签名称
Equals - 包含指定的标签名称和值（区分大小写）
Contains - 包含指定的标签名称，且标签值包含输入的字符串（子串匹配，不区分大小写）
Does not exist - 排除指定的标签名称
Does not equal - 排除指定的标签名称和值（区分大小写）
Does not contain - 排除指定的标签名称，且标签值包含输入的字符串（子串匹配，不区分大小写）
条件有两种计算类型：
And/Or - 必须满足所有条件，具有相同标签名称的条件将按 Or 条件分组
Or - 只需满足一个条件即可
此字段仅适用于 Host 和 Host group 类型的元素。
Automatic icon selection 勾选此复选框后，将使用图标映射来确定显示哪个图标。
Icons 你可以为元素在以下情况下显示不同的图标：Default、Problem、Maintenance 和 Disabled。
此字段仅适用于 Host 类型的元素。
Coordinates 地图元素的 X 和 Y 坐标。
URLs 可在此为元素设置特定 URL，其中：
Name - URL 的标签；
URL - URL（最多 2048 个字符）。
当用户在地图查看模式下点击该元素时，这些 URL 将显示为链接。如果该元素定义了自己的 URL，且其类型在地图级别也定义了 URL，则它们会合并显示在同一个菜单中。
可在地图元素名称和值中使用宏。完整列表请参见 supported macros，并搜索“map URL names and values”。

已添加的元素不会自动保存。如果你 离开此页面，所有更改都可能丢失。

因此，建议点击右上角的 Update 按钮。点击后，无论你在随后弹出的窗口中 选择什么，更改都会被保存。

所选的网格选项也会随每个地图一起保存。

选择元素

要选择多个元素，请选择一个，然后按住 Ctrl 选择其他元素。

您也可以通过在可编辑区域拖动一个矩形并选择其中的所有元素来选择多个元素。

一旦选择了多个元素，元素属性形式就会发生变化到批量更新模式，以便您可以一次性更改选定的属性元素。为此，请使用复选框标记属性，然后为其输入一个新值。您可以在此处使用宏（例如，下图标签中使用的host.name宏）。

链接元素

在地图上放置了一些元素后，就可以开始将它们链接起来了。要链接两个元素，必须先选中它们。选中元素后，点击“链接”旁边的 Add。

创建链接后，单个元素表单中会新增一个 Links 部分。点击 Edit 可编辑链接属性。

链接属性：

参数 说明
Label 将显示在链接上方的标签。
此字段支持表达式 macros，但仅支持带时间参数的 avg、last、min 和 max 函数（例如 {?avg(/host/key,1h)}）。
Show label 选择链接标签的显示方式：
Default - 使用地图配置中的 Show map element labels 设置（默认）；
Always - 始终显示；
Auto hide - 当未悬停或未选中时隐藏标签。
Connect to 该链接所连接到的元素。
Type (OK) 默认链接样式。可选择样式：Line、Bold line、Dot 或 Dashed line。
Color (OK) 默认链接颜色。点击颜色样本可选择其他颜色。
Indicator type 选择链接指示器类型：
Static link - 无指示器；
Trigger - 允许基于触发器的链接指示器；
Item value - 允许基于监控项值的链接指示器。
Item 选择监控项。该监控项的值将影响链接样式。
当 Indicator type 选择 Item value 时，此字段可用。
Indicators 链接指示器列表。
当 Indicator type 设置为 Trigger 或 Item value 时，此字段可用。
如果设置为 Trigger，则可将触发器指定为链接指示器。当触发器处于 Problem 状态时，其样式（所选颜色和线条类型）将应用到该链接。
如果设置为 Item value，并且已在 Item 字段中选择监控项，则可将监控项值指定为链接指示器。当监控项值达到指定阈值（对于数值型监控项）或匹配指定模式（对于文本型监控项）时，其样式（所选颜色和线条类型）将应用到该链接。

移动和复制粘贴元素

几个选定的元素可以移动到地图中的另一个位置通过单击选定元素之一，按住鼠标按钮，然后将光标移动到所需位置。

一个或多个元素可以通过选择元素来复制，然后用鼠标右键单击选定的元素并从菜单中选择复制。

要粘贴元素，请使用鼠标右键单击拓扑图区域并从菜单中选择粘贴。选择 不带外部链接粘贴选项将仅保留选定元素之间的链接来粘贴元素。

复制粘贴在同一浏览器窗口中工作。不支持键盘快捷键。

元素排序

要将一个元素移到另一个元素前面（或反之），请使用鼠标右键单击该元素，然后选择 Bring forward/Bring to front 或 Send backward/Send to back。

添加形状

除了地图元素外，还可以添加一些形状。 形状不是地图元素；它们只是视觉表现形式。例如，可以使用矩形形状作为背景来对一些主机进行分组。可以添加矩形和椭圆形状。

要添加形状，请点击 Shape 旁边的 Add。新形状将出现在地图的左上角。将其拖放到你希望的位置即可。

新添加的形状会使用默认颜色。点击该形状后，将显示一个表单，你可以自定义形状的外观、添加文本等。

要选择多个形状，请先选择一个，然后按住 Ctrl 再选择其他形状。选择多个形状后，可以像处理元素一样批量更新其共有属性。

可以在形状中添加文本。文本中支持表达式宏，但仅支持带有时间参数的 avg、last、min 和 max 函数（例如 {?avg(/host/key,1h)}）。

如果只想显示文本，可以通过移除形状边框使形状不可见（在 Border 字段中选择“None”）。例如，请注意上方截图中可见的 {MAP.NAME} 宏，实际上是一个带有文本的矩形形状，点击该宏时即可看到：

查看地图时，{MAP.NAME} 会解析为已配置的地图名称。

如果在文本中使用了超链接，则在查看地图时这些链接将可点击。

在形状内，文本始终启用自动换行。不过，在椭圆内，文本换行的方式会像该椭圆是一个矩形一样。 未实现按单词换行，因此较长的单词（即无法适应形状的单词）不会被换行，而是被遮挡（在地图编辑页面）或被裁剪（在其他包含地图的页面）。

添加线条

除了形状之外，还可以添加一些线条。线条可用于在地图中连接元素或形状。

要添加线条，请点击 Shape 旁边的 Add。地图左上角会出现一个新形状。选中它，然后在编辑表单中点击 Line，将该形状更改为线条。接着可调整线条属性，例如线条类型、宽度、颜色等。

map\_line.png

排列形状和线条的顺序

要将一个形状置于另一个形状之前（或反之），请用鼠标右键单击该形状，以调出地图形状菜单。