[comment]: # (tags: map, maps)

[comment]: # ({0e24f32a-7b37d2bb})
# 4 Maps

[comment]: # ({/0e24f32a-7b37d2bb})

[comment]: # ({20a11f83-20a11f83})
#### Overview

In the *Monitoring → Maps* section you can configure, manage and view
[network maps](/manual/config/visualization/maps).

When you open this section, you will either see the last map you
accessed or a listing of all maps you have access to.

All maps can be either public or private. Public maps are available to
all users, while private maps are accessible only to their owner and the
users the map is shared with.

[comment]: # ({/20a11f83-20a11f83})

[comment]: # ({b388b134-c1cb6946})
#### Map listing

![](../../../../../assets/en/manual/web_interface/map_list.png){width="600"}

Displayed data:

|Column|Description|
|--|--------|
|*Name*|Name of the map. Click on the name to [view](/manual/web_interface/frontend_sections/monitoring/maps#viewing-maps) the map.|
|*Width*|Map width is displayed.|
|*Height*|Map height is displayed.|
|*Actions*|Two actions are available:<br>**Properties** - set general map [properties](/manual/config/visualization/maps/map#creating-a-map)<br>**Edit** - access the grid for adding [map elements](/manual/config/visualization/maps/map#adding-elements)|

To [configure](/manual/config/visualization/maps/map#creating-a-map) a
new map, click on the *Create map* button in the top right-hand corner.
To import a map from a YAML, XML, or JSON file, click on the *Import*
button in the top right-hand corner. The user who imports the map will
be set as its owner.

Two buttons below the list offer some mass-editing options:

-   *Export* - export the maps to a YAML, XML, or JSON file
-   *Delete* - delete the maps

To use these options, mark the checkboxes before the respective maps,
then click on the required button.

[comment]: # ({/b388b134-c1cb6946})

[comment]: # ({1d312fad-1d312fad})
##### Using filter

You can use the filter to display only the maps you are interested in.
For better search performance, data is searched with macros unresolved.

[comment]: # ({/1d312fad-1d312fad})

[comment]: # ({a9b8dc1b-a9b8dc1b})
#### Viewing maps

To view a map, click on its name in the list of all maps.

![](../../../../../assets/en/manual/web_interface/maps.png){width="600"}

You can use the drop-down in the map title bar to select the lowest
severity level of the problem triggers to display. The severity marked
as *default* is the level set in the map configuration. If the map
contains a sub-map, navigating to the sub-map will retain the
higher-level map severity (except if it is *Not classified*, in this
case, it will not be passed to the sub-map).

[comment]: # ({/a9b8dc1b-a9b8dc1b})

[comment]: # ({1987ba24-f6436c14})
##### Icon highlighting

If a map element is in problem status, it is highlighted with a round
circle. The fill color of the circle corresponds to the severity color
of the problem. Only problems on or above the selected severity level
will be displayed with the element. If all problems are acknowledged, a
thick green border around the circle is displayed.

Additionally:

-   a host in [maintenance](/manual/maintenance) is highlighted with an
    orange, filled square. Note that maintenance highlighting has
    priority over the problem severity highlighting, if the map element is 
    host.
-   a disabled (not-monitored) host is highlighted with a gray, filled
    square.

Highlighting is displayed if the *Icon highlighting* check-box is marked
in map
[configuration](/manual/config/visualization/maps/map#creating-a-map).

[comment]: # ({/1987ba24-f6436c14})

[comment]: # ({5371fcf9-89ad8a4d})
##### Recent change markers

Inward pointing red triangles around an element indicate a recent
trigger status change - one that's happened within the last 30 minutes.
These triangles are shown if the *Mark elements on trigger status
change* check-box is marked in map
[configuration](/manual/config/visualization/maps/map#creating-a-map).

[comment]: # ({/5371fcf9-89ad8a4d})

[comment]: # ({0a65a833-0e0ddb36})
##### Links

Clicking on a map element opens a menu with some available links.
Clicking on the host name brings up the [host menu](/manual/web_interface/menu/host_menu).

[comment]: # ({/0a65a833-0e0ddb36})

[comment]: # ({2c2e8517-8bceddc5})
##### Buttons

Buttons to the right offer the following options:

|   |   |
|--|--------|
|![](../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/edit_map.png)|Go to editing of the map content.|
|![](../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/add_to_fav1.png)|Add map to the favorites widget in [Dashboards](/manual/web_interface/frontend_sections/dashboards).|
|![](../../../../../assets/en/manual/web_interface/button_add_fav2.png)|The map is in the favorites widget in [Dashboards](/manual/web_interface/frontend_sections/dashboards). Click to remove map from the favorites widget.|

View mode buttons being common for all sections are described on the
[Monitoring](/manual/web_interface/frontend_sections/monitoring#view-mode-buttons)
page.

[comment]: # ({/2c2e8517-8bceddc5})

[comment]: # ({15da840f-15da840f})
##### Readable summary in maps

A hidden "aria-label" property is available allowing map information to
be read with a screen reader. Both general map description and
individual element description is available, in the following format:

-   for map description:
    `<Map name>, <* of * items in problem state>, <* problems in total>.`
-   for describing one element with one problem:
    `<Element type>, Status <Element status>, <Element name>, <Problem description>.`
-   for describing one element with multiple problems:
    `<Element type>, Status <Element status>, <Element name>, <* problems>.`
-   for describing one element without problems:
    `<Element type>, Status <Element status>, <Element name>.`

For example, this description is available:

    'Local network, 1 of 6 elements in problem state, 1 problem in total. Host, Status problem, My host, Free disk space is less than 20% on volume \/. Host group, Status ok, Virtual servers. Host, Status ok, Server 1. Host, Status ok, Server 2. Host, Status ok, Server 3. Host, Status ok, Server 4. '

for the following map:

![](../../../../../assets/en/manual/web_interface/map_aria_label.png){width="600"}

[comment]: # ({/15da840f-15da840f})

[comment]: # ({c4642e16-c4642e16})
##### Referencing a network map

Network maps can be referenced by both `sysmapid` and `mapname` GET
parameters. For example,

    http://zabbix/zabbix/zabbix.php?action=map.view&mapname=Local%20network

will open the map with that name (Local network).

If both `sysmapid` (map ID) and `mapname` (map name) are specified,
`mapname` has higher priority.

[comment]: # ({/c4642e16-c4642e16})
