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

Any host groups, hosts, triggers, other maps or other elements that may be related to the exported map are not exported. 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

4 Network maps - 图1

Depending on the selected format, maps are exported to a local file with a default name:

  • zabbix_export_maps.yaml - in YAML export (default option for export)

  • zabbix_export_maps.xml - in XML export

  • zabbix_export_maps.json - in JSON export

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

4 Network maps - 图2

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:

RuleDescription
Update existingExisting maps will be updated with data taken from the import file. Otherwise they will not be updated.
Create newThe 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 Super Admin users.

If replacing an existing image, it will affect all maps that are using this image.

Export format

Export to YAML:

  1. ---
  2. zabbix_export:
  3.   version: "5.2"
  4.   date: "2020-08-06T08:20:27Z"
  5.   images:
  6.   - name: Zabbix_server_3D_(128)
  7.     imagetype: "1"
  8.     encodedImage: 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
  9.   maps:
  10.   - name: Local network
  11.     width: "680"
  12.     height: "200"
  13.     label_type: "0"
  14.     label_location: "0"
  15.     highlight: "1"
  16.     expandproblem: "1"
  17.     markelements: "1"
  18.     show_unack: "0"
  19.     severity_min: "0"
  20.     show_suppressed: "0"
  21.     grid_size: "50"
  22.     grid_show: "1"
  23.     grid_align: "1"
  24.     label_format: "0"
  25.     label_type_host: "2"
  26.     label_type_hostgroup: "2"
  27.     label_type_trigger: "2"
  28.     label_type_map: "2"
  29.     label_type_image: "2"
  30.     label_string_host: ""
  31.     label_string_hostgroup: ""
  32.     label_string_trigger: ""
  33.     label_string_map: ""
  34.     label_string_image: ""
  35.     expand_macros: "1"
  36.     background: []
  37.     iconmap: []
  38.     urls: []
  39.     selements:
  40.     - elementtype: "0"
  41.       elements:
  42.       - host: Zabbix server
  43.       label: |-
  44.         {HOST.NAME}
  45.         {HOST.CONN}
  46.       label_location: "0"
  47.       x: "111"
  48.       "y": "61"
  49.       elementsubtype: "0"
  50.       areatype: "0"
  51.       width: "200"
  52.       height: "200"
  53.       viewtype: "0"
  54.       use_iconmap: "0"
  55.       selementid: "1"
  56.       icon_off:
  57.         name: Zabbix_server_3D_(128)
  58.       icon_on: []
  59.       icon_disabled: []
  60.       icon_maintenance: []
  61.       application: ""
  62.       urls: []
  63.     shapes:
  64.     - type: "0"
  65.       x: "0"
  66.       "y": "0"
  67.       width: "680"
  68.       height: "15"
  69.       text: '{MAP.NAME}'
  70.       font: "9"
  71.       font_size: "11"
  72.       font_color: "000000"
  73.       text_halign: "0"
  74.       text_valign: "0"
  75.       border_type: "0"
  76.       border_width: "0"
  77.       border_color: "000000"
  78.       background_color: ""
  79.       zindex: "0"
  80.     lines: []
  81.     links: []
  82. ...

Element tags

Element tag values are explained in the table below.

ElementElement propertyTypeRangeDescription
imagesRoot element for images.
namestringUnique image name.
imagetypeinteger1 - image
2 - background		Image type.
encodedImageBase64 encoded image.
mapsRoot element for maps.
namestringUnique map name.
widthintegerMap width, in pixels.
heightintegerMap height, in pixels.
label_typeinteger0 - label
1 - host IP address
2 - element name
3 - status only
4 - nothing		Map element label type.
label_locationinteger0 - bottom
1 - left
2 - right
3 - top		Map element label location by default.
highlightinteger0 - no
1 - yes		Enable icon highlighting for active triggers and host statuses.
expandprobleminteger0 - no
1 - yes		Display problem trigger for elements with a single problem.
markelementsinteger0 - no
1 - yes		Highlight map elements that have recently changed their status.
show_unackinteger0 - count of all problems
1 - count of unacknowledged problems
2 - count of acknowledged and unacknowledged problems separately		Problem display.
severity_mininteger0 - not classified
1 - information
2 - warning
3 - average
4 - high
5 - disaster		Minimum trigger severity to show on the map by default.
show_suppressedinteger0 - no
1 - yes		Display problems which would otherwise be suppressed (not shown) because of host maintenance.
grid_sizeinteger20, 40, 50, 75 or 100Cell size of a map grid in pixels, if “grid_show=1”
grid_showinteger0 - yes
1 - no		Display a grid in map configuration.
grid_aligninteger0 - yes
1 - no		Automatically align icons in map configuration.
label_formatinteger0 - no
1 - yes		Use advanced label configuration.
label_type_hostinteger0 - 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_hostgroupinteger0 - label
2 - element name
3 - status only
4 - nothing
5 - custom label		Display as host group label, if “label_format=1”
label_type_triggerinteger0 - label
2 - element name
3 - status only
4 - nothing
5 - custom label		Display as trigger label, if “label_format=1”
label_type_mapinteger0 - label
2 - element name
3 - status only
4 - nothing
5 - custom label		Display as map label, if “label_format=1”
label_type_imageinteger0 - label
2 - element name
4 - nothing
5 - custom label		Display as image label, if “label_format=1”
label_string_hoststringCustom label for host elements, if “label_type_host=5”
label_string_hostgroupstringCustom label for host group elements, if “label_type_hostgroup=5”
label_string_triggerstringCustom label for trigger elements, if “label_type_trigger=5”
label_string_mapstringCustom label for map elements, if “label_type_map=5”
label_string_imagestringCustom label for image elements, if “label_type_image=5”
expand_macrosinteger0 - no
1 - yes		Expand macros in labels in map configuration.
backgroundidID of the background image (if any), if “imagetype=2”
iconmapidID of the icon mapping (if any).
urls
namestringLink name.
urlstringLink URL.
elementtypeinteger0 - host
1 - map
2 - trigger
3 - host group
4 - image		Map item type the link belongs to.
selements
elementtypeinteger0 - host
1 - map
2 - trigger
3 - host group
4 - image		Map element type.
labelstringIcon label.
label_locationinteger-1 - use map default
0 - bottom
1 - left
2 - right
3 - top
xintegerLocation on the X axis.
yintegerLocation on the Y axis.
elementsubtypeinteger0 - single host group
1 - all host groups		Element subtype, if “elementtype=3”
areatypeinteger0 - same as whole map
1 - custom size		Area size, if “elementsubtype=1”
widthintegerWidth of area, if “areatype=1”
heightintegerHeight of area, if “areatype=1”
viewtypeinteger0 - place evenly in the areaArea placement algorithm, if “elementsubtype=1”
use_iconmapinteger0 - no
1 - yes		Use icon mapping for this element. Relevant only if iconmapping is activated on map level.
selementididUnique element record ID.
applicationstringApplication name filter. If an application name is given, only problems of triggers that belong to the given application will be displayed on the map.
elementsZabbix entities that are represented on the map (host, host group, map etc).
host
icon_offImage to use when element is in ‘OK’ status.
icon_onImage to use when element is in ‘Problem’ status.
icon_disabledImage to use when element is disabled.
icon_maintenanceImage to use when element is in maintenance.
namestringUnique image name.
linksLinks between map elements.
drawtypeinteger0 - line
2 - bold line
3 - dotted line
4 - dashed line		Link style.
colorstringLink color (6 symbols, hex).
labelstringLink label.
selementid1idID of one element to connect.
selementid2idID of the other element to connect.
linktriggersLink status indicators.
drawtypeinteger0 - line
2 - bold line
3 - dotted line
4 - dashed line		Link style when trigger is in the ‘Problem’ state.
colorstringLink color (6 symbols, hex) when trigger is in the ‘Problem’ state.
triggerTrigger used for indicating link status.
descriptionstringTrigger name.
expressionstringTrigger expression.
recovery_expressionstringTrigger recovery expression.