Documentation
1 配置网络拓扑图
概述
在Zabbix中配置一张地图，首先需要通过定义其通用参数来create一张地图，然后开始使用元素及其链接来填充实际的地图。
你可以使用一个主机、一个主机组、触发器、图像或其他地图来填充地图。
图标用于表示地图元素。你可以定义将与图标一起显示的信息，并设置最近的问题以特殊方式显示。你可以链接图标并定义在链接上显示的信息。
你可以添加自定义URL，通过点击图标进行访问。因此，你可以将一个主机图标链接到主机属性，或将地图图标链接到另一张地图。
地图中的问题计数仅针对根源问题显示。
地图在监控 → Maps中进行管理，在这里可以配置、管理和查看地图。在监控视图中，你可以点击图标，并利用链接到某些脚本和URL的功能。
网络地图基于矢量图形（SVG）。
公共与私有地图
Zabbix中的所有用户（包括非管理员用户）都可以create网络拓扑图。 拓扑图有所有者——即创建它们的用户。拓扑图可以被设为公开 或私有。
- 公共地图对所有用户可见，尽管用户需要查看它 必须至少对一个地图元素具有读取权限。公共地图可以 在用户/用户组具有读写权限的情况下可以进行编辑 此拓扑图以及对其所有元素的至少读取权限 对应的拓扑图，包括链接中的触发器。
<!-- --> 仅返回OutputFormat格式要求结果 - 私有 地图仅对其所有者以及指定的用户/用户组可见 将地图分组为shared 仅由所有者共享。常规（非超级管理员）用户只能共享 具有所属的用户组和用户。管理员级别的用户可以 查看私人地图，无论是否为所有者或属于该地图的成员 共享用户列表。私有地图只能由地图所有者编辑 并且如果用户/用户组对此具有读写权限 地图以及对所有元素的至少读取权限 对应的拓扑图，包括链接中的触发器。
用户没有读取权限的地图元素将不会显示。 displayed with a grayed-out icon and all textual information on the 元素是隐藏的。但是，即使触发器标签处于隐藏状态，该标签仍然可见。 用户没有触发器的权限。
要向地图中添加元素，用户还必须至少具有对该元素的读取权限。
创建地图
要create一张地图，请执行以下操作：
- 转到 Monitoring → Maps
- 进入所有地图的视图
- 点击 Create map
您还可以在现有地图的配置表单中使用 Clone 按钮来create一张新地图。 此地图将具有现有地图的所有属性，包括通用布局属性以及现有地图的元素。
Map 选项卡包含通用地图属性：
所有必填字段均以红色星号标记。
通用地图属性：
| 参数 | 描述 |
|---|---|
| Owner | 地图所有者的名称。 |
| Name | 唯一的地图名称。 |
| Width | 地图宽度（以像素为单位）。 |
| Height | 地图高度（以像素为单位）。 |
| Background image | 使用背景图片： No image - 无背景图片（白色背景） Image - 选择的图片作为背景图片。不进行缩放。您可以使用地理地图或任何其他图片来增强您的地图。 |
| Automatic icon mapping | 您可以设置使用在 Administration → General → Icon mapping 中配置的自动图标映射。图标映射允许将特定图标与特定主机资产字段进行映射。 |
| Icon highlight | 如果选中此框，地图元素将被高亮显示。 具有活动触发器的元素将获得一个圆形背景，颜色与最高严重级别的触发器相同。此外，如果所有问题均已确认，圆形周围将显示一条粗的绿色边框。 状态为“禁用”或“处于维护中”的元素将get一个正方形背景，分别为灰色和橙色。 另请参见：查看网络拓扑图 |
| Mark elements on trigger status change | 最近的触发器状态变化（新问题或已解决）将通过标记（向内的红色三角形）显示在元素图标三个无标签的边上。标记将显示30分钟。 |
| Display problems | 选择如何在地图元素上显示问题： Expand single problem - 如果只有一个问题，将显示问题名称。否则，显示问题总数。 Number of problems - 显示问题总数 Number of problems and expand most critical one - 显示最关键问题的名称和问题总数。 'Most critical' 是基于问题严重性确定的，如果严重性相同，则根据问题事件ID（ID较高或较晚的问题优先显示）。对于触发器地图元素，是基于问题严重性，如果严重性相同，则根据触发器在触发器列表中的位置。如果存在多个相同触发器的问题，则显示最新的问题。 |
| Advanced labels | 如果选中此框，您将能够为不同类型的元素定义不同的标签类型。 |
| Map element label type | 地图元素使用的标签类型： Label - 地图元素标签 IP address - IP地址 Element name - 元素名称（例如，主机名） Status only - 仅状态（OK 或 PROBLEM） Nothing - 不显示标签 |
| Map element label location | 标签相对于地图元素的位置： Bottom - 地图元素下方 Left - 左侧 Right - 右侧 Top - 地图元素上方 |
| Problem display | 显示问题计数方式： All - 显示完整的问题计数 Separated - 未确认的问题计数将作为总数的一部分显示 Unacknowledged only - 仅显示未确认的问题计数 |
| Minimum trigger severity | 低于所选最低严重级别的问题将不会在地图上显示。 例如，选择 Warning，则 Information 和 Not classified 级别的触发器变化将不会反映在地图上。 |
| Show suppressed problems | 勾选此框以显示那些由于主机维护而被抑制（不显示）的问题。 |
| URLs | 可以为每种元素类型定义URL（最多2048个字符）。还可以定义URL的标签。当用户在地图查看模式下点击元素时，这些将显示为链接。 可以在地图URL名称和值中使用宏。完整列表，请参见supported macros并搜索“map URL names and values”。 |
共享
共享选项卡包含私有地图的地图类型以及共享选项（用户组、用户）：
| 参数 | 描述 |
|---|---|
| Type | 选择地图类型： 私有 - 地图仅对选定的用户组和用户可见 公共 - 地图对所有人可见 |
| List of user group shares | 选择地图可访问的用户组。 您可以允许只读或读写访问权限。 |
| List of user shares | 选择地图可访问的用户。 您可以允许只读或读写访问权限。 |
当您点击添加以保存此地图时，您已经创建了一个包含名称、尺寸和某些偏好的空白地图。现在您需要添加一些元素。为此，请点击地图列表中的编辑以打开可编辑区域。
添加元素
要添加一个元素，请点击 Map element 旁边的 添加。新元素 将出现在地图的 Top 左角。您可以将其拖放到任何位置。
请注意，当“网格”选项设置为“开”时，元素将始终对齐到网格（您可以从下拉菜单中选择不同的网格大小，也可以隐藏/显示网格）。如果您希望将元素放置在任意位置而不对齐，请将该选项设置为“关”。（您也可以稍后通过点击 对齐地图元素，将随机分布的元素对齐到网格。）
现在您已经放置了一些元素，可能需要通过设置名称等操作来区分它们。点击某个元素后，会显示一个表单，您可以设置元素类型、输入名称、选择不同的图标等。
地图元素属性：
| 参数 | 描述 |
|---|---|
| Type | 元素类型： 主机 - 表示所选 主机 的所有触发器状态的图标 Map - 表示地图中所有元素状态的图标 Trigger - 表示一个或多个触发器状态的图标 Host group - 表示所选主机组中所有 主机 的触发器状态的图标 Image - 一个图标，不链接到任何资源 |
| Label | 图标标签，任意 string。 支持宏和多行字符串。 此字段支持表达式 macros，但仅限使用 avg、last、min 和 max 函数，并以时间为参数（例如，{?avg(/host/key,1h)}）。有关支持的宏的完整列表，请参见 supported macros 并搜索“map element labels”。 |
| Label location | 图标标签的位置： Default - 使用地图默认的标签位置 Bottom - 图标下方 Left - 图标左侧 Right - 图标右侧 Top - 图标上方 |
| Host | 如果元素类型为 '主机'，请输入 主机。此字段支持自动补全，开始输入 一个主机 名称时会提供匹配的 主机 下拉列表。向下滚动选择。点击“x”可移除已选内容。 |
| Map | 如果元素类型为“Map”，请选择地图。此字段支持自动补全，开始输入地图名称时会提供匹配地图的下拉列表。向下滚动选择。点击“x”可移除已选内容。 |
| Triggers | 如果元素类型为“Trigger”，请在下方的 New triggers 字段中选择一个或多个触发器，然后点击 添加。 所选触发器的顺序可以更改，但只能在相同严重级别的触发器之间更改。多选触发器也会影响 {主机.*} 宏的解析，无论是在编辑模式还是查看模式。 // 1 编辑模式// 中，第一个显示的 {主机.*} 宏将根据列表中的第一个触发器（基于触发器严重级别）进行解析。 // 2 查看模式// 取决于通用地图属性中的 创建地图 参数。 * 如果选择“展开单个问题”模式，第一个显示的 {主机.*} 宏将根据最新检测到的问题触发器（不考虑严重级别）或列表中的第一个触发器（如果没有检测到问题）进行解析； * 如果选择“显示问题数量并展开最关键问题”模式，第一个显示的 {主机.*} 宏将根据触发器严重级别进行解析。 |
| Host group | 如果元素类型为 '主机组'，请输入 主机 组。此字段支持自动补全，开始输入组名称时会提供匹配组的下拉列表。向下滚动选择。点击“x”可移除已选内容。 |
| Tags | 指定标签以限制小部件中显示的问题数量。可以包含或排除特定标签和标签值。可以设置多个条件。标签名称匹配始终区分大小写。 每个条件有几种可用的操作符： Exists - 包含指定的标签名称 Equals - 包含指定的标签名称和值（区分大小写） Contains - 包含指定的标签名称，且标签值包含输入的 string（子串匹配，不区分大小写） Does not exist - 排除指定的标签名称 Does not equal - 排除指定的标签名称和值（区分大小写） Does not contain - 排除指定的标签名称，且标签值包含输入的 string（子串匹配，不区分大小写） 条件有两种计算类型： And/Or - 所有条件必须满足，相同标签名称的条件将按 Or 分组 Or - 满足任一条件即可 此字段适用于 主机 和 主机组 元素类型。 |
| Automatic icon selection | 在这种情况下，将使用图标映射来确定显示哪个图标。 |
| Icons | 您可以选择在以下情况下显示不同的图标：默认、问题、维护、禁用。 |
| Coordinate X | 地图元素的 X 坐标。 |
| Coordinate Y | 地图元素的 Y 坐标。 |
| URLs | 可以为元素设置特定的 URL（最多 2048 个字符）。也可以为 URL 定义标签。当用户在地图查看模式下点击元素时，这些 URL 将显示为链接。如果元素有自己的 URL，且地图级别为其类型定义了 URL，则它们将在同一菜单中合并显示。 可以在地图元素名称和值中使用宏。有关完整列表，请参见 supported macros 并搜索“map URL names and values”。 |
添加的元素不会自动保存。如果您离开页面，所有更改可能会丢失。
因此，建议点击 Top 右角的 更新 按钮。点击后，无论您在随后的弹出窗口中选择什么，更改都将被保存。
选定的网格选项也将随每个地图一起保存。
选择元素
选择元素时，先选择一个元素，然后按住 Ctrl 键选择其他元素。
您也可以通过在可编辑区域中拖动绘制一个矩形，并选中其中的所有元素来实现多元素选择。
当您选中多个元素后，元素属性表单将切换至批量-update模式，以便您一次性修改所选元素的属性。为此，请使用复选框标记属性并为其输入新的值。此处您可以使用宏（例如，使用 {HOST.NAME} 表示元素标签）。
关联元素
一旦地图上放置了一些元素，就可以开始将它们连接起来。要连接两个元素，必须首先选择它们。在选中元素后，点击“链接”旁边的 添加。
创建链接后，单个元素表单中将新增一个 链接 部分。点击 编辑 可以编辑链接属性。
链接属性：
| 参数 | 描述 |
|---|---|
| Label | 显示在Top上的标签。 此字段支持macros表达式，但仅限使用 avg、last、min 和 max 函数，并以时间为参数（例如：{?avg(/host/key,1h)}）。 |
| Connect to | 链接所连接到的元素。 |
| Type (OK) | 默认链接样式： 直线 - 单线 粗线 - 粗线 点 - 点线 虚线 - 虚线 |
| Color (OK) | 默认链接颜色。 |
| Link indicators | 与该链接关联的触发器列表。如果某个触发器状态为问题（PROBLEM），其样式将应用于该链接。 |
移动与复制粘贴元素
可以选择多个元素，通过点击其中一个选中的元素，按住鼠标按钮并将光标移动到目标位置，从而将它们移动到拓扑图中的其他位置。
可以通过选择元素，然后用鼠标右键点击其中一个选中的元素，并在菜单中选择复制来复制一个或多个元素。
要粘贴元素，请用鼠标右键点击拓扑图的空白区域，并在菜单中选择粘贴。不带外部链接粘贴选项将仅保留所选元素之间的连接关系。
复制-粘贴功能仅在同一个浏览器窗口内有效。当前不支持键盘快捷键。
添加形状
除了地图元素之外，还可以添加一些形状。
形状不是地图元素；它们只是视觉上的表示。例如，矩形形状可以用作背景来对某些
主机 进行分组。可以添加矩形和椭圆形状。
要添加形状，请点击“形状”旁边的 添加。新形状将出现在地图的
Top 左上角。然后可以将其拖放到任意位置。
新添加的形状使用默认颜色。通过点击形状，会显示一个表单，您可以自定义形状的外观、添加文本等。
要选择多个形状，请先选择一个形状，然后按住 Ctrl 键选择其他形状。选中多个形状后，可以批量更新它们的公共属性，类似于对元素的操作。
可以在形状中添加文本。文本中支持表达式
macros，但仅支持使用 avg、last、min 和 max 函数，并将时间作为参数（例如，{?avg(/host/key,1h)}）。
如果只想显示文本，可以通过将形状边框设置为“无”（在 边框 字段中选择“无”）来使形状不可见。例如，请注意上图中显示的
{MAP.NAME} 宏，实际上是一个带有文本的矩形形状，点击该宏可以看到：
{MAP.NAME} 在查看地图时会被解析为配置的地图名称。
如果在文本中使用了超链接，在查看地图时这些链接将变为可点击状态。
形状内的文本始终自动换行。然而，在椭圆形状中，换行方式如同该椭圆是一个矩形。由于未实现单词换行功能，因此长单词（无法适应形状的单词）不会换行，而是被遮蔽（在地图编辑页面上）或被裁剪（其他地图页面上）。
添加行
除了形状之外，还可以添加一些线条。线条可用于在地图中连接元素或形状。
要添加线条，请点击“形状(Shape)”旁边的 添加(Add) 按钮。一个新的形状将出现在地图的Top左上角。选择它，然后在编辑表单中点击 线条(Line) 将形状更改为线条。然后调整线条属性，如线条类型、宽度、颜色等。
图形与线条排序
若要将一个图形置于另一个图形的前面（或相反操作），请单击鼠标右键以调出地图图形菜单。
