4 Network maps
Overview
Network map export contains:
all related images
map structure - all map settings, all contained elements with their settings, map links and map link status indicators
Not exported are host groups, hosts, triggers, other maps or any other elements that may be related to the exported map. Thus, if at least one of the elements the map refers to is missing, importing it will fail.
Network map export/import is supported since Zabbix 1.8.2.
Exporting
To export network maps, do the following:
Go to: Monitoring → Maps
Mark the checkboxes of the network maps to export
Click on Export below the list
Selected maps are exported to a local XML file with default name zabbix_export_maps.xml.
Importing
To import network maps, do the following:
Go to: Monitoring → Maps
Click on Import to the right
Select the import file
Mark the required options in import rules
Click on Import
All mandatory input fields are marked with a red asterisk.
A success or failure message of the import will be displayed in the frontend.
Import rules:
Rule | Description |
---|---|
Update existing | Existing maps will be updated with data taken from the import file. Otherwise they will not be updated. |
Create new | The import will add new maps using data from the import file. Otherwise it will not add them. |
If you uncheck both map options and check the respective options for images, images only will be imported. Image importing is only available to Zabbix Super Admin users.
If replacing an existing image, it will affect all maps that are using this image.
Export format
Exporting a small network map with three elements, their images and some links between them. Note that images are truncated to save space.
<?xml version="1.0" encoding="UTF-8"?>
<zabbix_export>
<version>5.0</version>
<date>2020-04-22T09:22:17Z</date>
<images>
<image>
<name>Server_(64)</name>
<imagetype>1</imagetype>
<encodedImage>iVBOR...SuQmCC</encodedImage>
</image>
<image>
<name>Workstation_(64)</name>
<imagetype>1</imagetype>
<encodedImage>iVBOR...SuQmCC</encodedImage>
</image>
<image>
<name>Zabbix_server_3D_(96)</name>
<imagetype>1</imagetype>
<encodedImage>iVBOR...ggg==</encodedImage>
</image>
</images>
<maps>
<map>
<name>Network</name>
<width>590</width>
<height>400</height>
<label_type>0</label_type>
<label_location>0</label_location>
<highlight>1</highlight>
<expandproblem>0</expandproblem>
<markelements>1</markelements>
<show_unack>0</show_unack>
<severity_min>2</severity_min>
<show_suppressed>0</show_suppressed>
<grid_size>40</grid_size>
<grid_show>1</grid_show>
<grid_align>1</grid_align>
<label_format>0</label_format>
<label_type_host>2</label_type_host>
<label_type_hostgroup>2</label_type_hostgroup>
<label_type_trigger>2</label_type_trigger>
<label_type_map>2</label_type_map>
<label_type_image>2</label_type_image>
<label_string_host/>
<label_string_hostgroup/>
<label_string_trigger/>
<label_string_map/>
<label_string_image/>
<expand_macros>0</expand_macros>
<background/>
<iconmap/>
<urls/>
<selements>
<selement>
<elementtype>0</elementtype>
<label>Host 1</label>
<label_location>-1</label_location>
<x>476</x>
<y>28</y>
<elementsubtype>0</elementsubtype>
<areatype>0</areatype>
<width>200</width>
<height>200</height>
<viewtype>0</viewtype>
<use_iconmap>0</use_iconmap>
<selementid>8</selementid>
<elements>
<element>
<host>Discovered host</host>
</element>
</elements>
<icon_off>
<name>Server_(64)</name>
</icon_off>
<icon_on/>
<icon_disabled/>
<icon_maintenance/>
<application/>
<urls/>
</selement>
<selement>
<elementtype>0</elementtype>
<label>Zabbix server</label>
<label_location>-1</label_location>
<x>252</x>
<y>50</y>
<elementsubtype>0</elementsubtype>
<areatype>0</areatype>
<width>200</width>
<height>200</height>
<viewtype>0</viewtype>
<use_iconmap>0</use_iconmap>
<selementid>6</selementid>
<elements>
<element>
<host>Zabbix server</host>
</element>
</elements>
<icon_off>
<name>Zabbix_server_3D_(96)</name>
</icon_off>
<icon_on/>
<icon_disabled/>
<icon_maintenance/>
<application/>
<urls/>
</selement>
<selement>
<elementtype>0</elementtype>
<label>New host</label>
<label_location>-1</label_location>
<x>308</x>
<y>230</y>
<elementsubtype>0</elementsubtype>
<areatype>0</areatype>
<width>200</width>
<height>200</height>
<viewtype>0</viewtype>
<use_iconmap>0</use_iconmap>
<selementid>7</selementid>
<elements>
<element>
<host>Zabbix host</host>
</element>
</elements>
<icon_off>
<name>Workstation_(64)</name>
</icon_off>
<icon_on/>
<icon_disabled/>
<icon_maintenance/>
<application/>
<urls/>
</selement>
</selements>
<links>
<link>
<drawtype>0</drawtype>
<color>008800</color>
<label/>
<selementid1>6</selementid1>
<selementid2>8</selementid2>
<linktriggers/>
</link>
<link>
<drawtype>2</drawtype>
<color>00CC00</color>
<label>100MBps</label>
<selementid1>7</selementid1>
<selementid2>6</selementid2>
<linktriggers>
<linktrigger>
<drawtype>0</drawtype>
<color>DD0000</color>
<trigger>
<description>Zabbix agent on {HOST.NAME} is unreachable for 5 minutes</description>
<expression>{Zabbix host:agent.ping.nodata(5m)}=1</expression>
<recovery_expression/>
</trigger>
</linktrigger>
</linktriggers>
</link>
</links>
</map>
</maps>
</zabbix_export>
Element tags
Element tag values are explained in the table below.
Element | Element property | Type | Range | Description |
---|---|---|---|---|
images | Root element for images. | |||
image | Individual image. | |||
name | string | Unique image name. | ||
imagetype | integer | 1 - image 2 - background | Image type. | |
encodedImage | Base64 encoded image. | |||
maps | Root element for maps. | |||
map | Individual map. | |||
name | string | Unique map name. | ||
width | integer | Map width, in pixels. | ||
height | integer | Map height, in pixels. | ||
label_type | integer | 0 - label 1 - host IP address 2 - element name 3 - status only 4 - nothing | Map element label type. | |
label_location | integer | 0 - bottom 1 - left 2 - right 3 - top | Map element label location by default. | |
highlight | integer | 0 - no 1 - yes | Enable icon highlighting for active triggers and host statuses. | |
expandproblem | integer | 0 - no 1 - yes | Display problem trigger for elements with a single problem. | |
markelements | integer | 0 - no 1 - yes | Highlight map elements that have recently changed their status. | |
show_unack | integer | 0 - count of all problems 1 - count of unacknowledged problems 2 - count of acknowledged and unacknowledged problems separately | Problem display. | |
severity_min | integer | 0 - not classified 1 - information 2 - warning 3 - average 4 - high 5 - disaster | Minimum trigger severity to show on the map by default. | |
show_suppressed | integer | 0 - no 1 - yes | Display problems which would otherwise be suppressed (not shown) because of host maintenance. | |
grid_size | integer | 20, 40, 50, 75 or 100 | Cell size of a map grid in pixels, if “grid_show=1” | |
grid_show | integer | 0 - yes 1 - no | Display a grid in map configuration. | |
grid_align | integer | 0 - yes 1 - no | Automatically align icons in map configuration. | |
label_format | integer | 0 - no 1 - yes | Use advanced label configuration. | |
label_type_host | integer | 0 - label 1 - host IP address 2 - element name 3 - status only 4 - nothing 5 - custom label | Display as host label, if “label_format=1” | |
label_type_hostgroup | integer | 0 - label 2 - element name 3 - status only 4 - nothing 5 - custom label | Display as host group label, if “label_format=1” | |
label_type_trigger | integer | 0 - label 2 - element name 3 - status only 4 - nothing 5 - custom label | Display as trigger label, if “label_format=1” | |
label_type_map | integer | 0 - label 2 - element name 3 - status only 4 - nothing 5 - custom label | Display as map label, if “label_format=1” | |
label_type_image | integer | 0 - label 2 - element name 4 - nothing 5 - custom label | Display as image label, if “label_format=1” | |
label_string_host | string | Custom label for host elements, if “label_type_host=5” | ||
label_string_hostgroup | string | Custom label for host group elements, if “label_type_hostgroup=5” | ||
label_string_trigger | string | Custom label for trigger elements, if “label_type_trigger=5” | ||
label_string_map | string | Custom label for map elements, if “label_type_map=5” | ||
label_string_image | string | Custom label for image elements, if “label_type_image=5” | ||
expand_macros | integer | 0 - no 1 - yes | Expand macros in labels in map configuration. | |
background | id | ID of the background image (if any), if “imagetype=2” | ||
iconmap | id | ID of the icon mapping (if any). | ||
urls | ||||
url | Individual URL. | |||
name | string | Link name. | ||
url | string | Link URL. | ||
elementtype | integer | 0 - host 1 - map 2 - trigger 3 - host group 4 - image | Map item type the link belongs to. | |
selements | ||||
selement | Individual map element. | |||
elementtype | integer | 0 - host 1 - map 2 - trigger 3 - host group 4 - image | Map element type. | |
label | string | Icon label. | ||
label_location | integer | -1 - use map default 0 - bottom 1 - left 2 - right 3 - top | ||
x | integer | Location on the X axis. | ||
y | integer | Location on the Y axis. | ||
elementsubtype | integer | 0 - single host group 1 - all host groups | Element subtype, if “elementtype=3” | |
areatype | integer | 0 - same as whole map 1 - custom size | Area size, if “elementsubtype=1” | |
width | integer | Width of area, if “areatype=1” | ||
height | integer | Height of area, if “areatype=1” | ||
viewtype | integer | 0 - place evenly in the area | Area placement algorithm, if “elementsubtype=1” | |
use_iconmap | integer | 0 - no 1 - yes | Use icon mapping for this element. Relevant only if iconmapping is activated on map level. | |
selementid | id | Unique element record ID. | ||
application | string | Application name filter. If an application name is given, only problems of triggers that belong to the given application will be displayed on the map. | ||
elements | ||||
element | Individual Zabbix entity that is represented on the map (map, hostgroup, host, etc). | |||
host | ||||
icon_off | Image to use when element is in ‘OK’ status. | |||
icon_on | Image to use when element is in ‘Problem’ status. | |||
icon_disabled | Image to use when element is disabled. | |||
icon_maintenance | Image to use when element is in maintenance. | |||
name | string | Unique image name. | ||
links | ||||
link | Individual link between map elements. | |||
drawtype | integer | 0 - line 2 - bold line 3 - dotted line 4 - dashed line | Link style. | |
color | string | Link color (6 symbols, hex). | ||
label | string | Link label. | ||
selementid1 | id | ID of one element to connect. | ||
selementid2 | id | ID of the other element to connect. | ||
linktriggers | ||||
linktrigger | Individual link status indicator. | |||
drawtype | integer | 0 - line 2 - bold line 3 - dotted line 4 - dashed line | Link style when trigger is in the ‘Problem’ state. | |
color | string | Link color (6 symbols, hex) when trigger is in the ‘Problem’ state. | ||
trigger | Trigger used for indicating link status. | |||
description | string | Trigger name. | ||
expression | string | Trigger expression. | ||
recovery_expression | string | Trigger recovery expression. |