4 Network maps

    Overview

    • 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

    • zabbix_export_maps.yaml - in YAML export (default option for 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

    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.

    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:

    Element tags

    Element tag values are explained in the table below.

    ElementElement propertyTypeRangeDescription
    imagesRoot element for images.
    nameUnique 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_macros0 - 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).
    urlsUsed by maps or each map element.
    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.
    evaltypeintegerEvaluation type for tags.
    tagsProblem tags (for host and host group elements). If tags are given, only problems with these tags will be displayed on the map.
    tagTag name.
    valueTag value.
    operatorOperator.
    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.
    shapes
    typeinteger0 - rectangle
    1 - ellipse    		Shape type.
    xintegerX coordinates of the shape in pixels.
    yintegerY coordinates of the shape in pixels.
    widthintegerShape width.
    heightintegerShape height.
    border_typeinteger0 - none
    1 - bold line
    2 - dotted line
    3 - dashed line    		Type of the border for the shape.
    border_widthintegerWidth of the border in pixels.
    border_colorBorder color represented in hexadecimal code.
    textstringText inside of shape.
    fontinteger0 - Georgia, serif
    1 - “Palatino Linotype”, “Book Antiqua”, Palatino, serif
    2 - “Times New Roman”, Times, serif
    3 - Arial, Helvetica, sans-serif
    4 - “Arial Black”, Gadget, sans-serif
    5 - “Comic Sans MS”, cursive, sans-serif
    6 - Impact, Charcoal, sans-serif
    7 - “Lucida Sans Unicode”, “Lucida Grande”, sans-serif
    8 - Tahoma, Geneva, sans-serif
    9 - “Trebuchet MS”, Helvetica, sans-serif
    10 - Verdana, Geneva, sans-serif
    11 - “Courier New”, Courier, monospace
    12 - “Lucida Console”, Monaco, monospace    		Text font style.
    font_sizeintegerFont size in pixels.
    font_colorstringFont color represented in hexadecimal code.
    text_haligninteger0 - center
    1 - left
    2 - right    		Horizontal alignment of text.
    text_valigninteger0 - middle
    1 - top
    2 - bottom    		Vertical alignment of text.
    background_colorstringBackground (fill) color represented in hexadecimal code.
    zindexintegerValue used to order all shapes and lines (z-index).
    lines
    x1integerX coordinates of the line point 1 in pixels.
    y1integerY coordinates of the line point 1 in pixels.
    x2integerX coordinates of the line point 2 in pixels.
    y2integerY coordinates of the line point 2 in pixels.
    line_typeinteger0 - none
    1 - bold line
    2 - dotted line
    3 - dashed line    		Line type.
    line_widthintegerLine width in pixels.
    line_colorstringLine color represented in hexadecimal code.
    zindexintegerValue used to order all shapes and lines (z-index).
    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.