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

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>3.4</version>
           <date>2016-10-05T08:16:20Z</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>
                   <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.
	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.

Documentation