Zabbix Documentation 2.0

3.04.04.2 (current)In development:4.4 (devel)Unsupported:1.82.02.22.43.23.4

User Tools

Site Tools


Sidebar

manual:config:visualisation:maps:map

This is an old revision of the document!


The content of this page is yet to be completely updated for 2.0.

1 Configuring a network map

General map attributes

To create a map, do the following:

  • Go to Configuration → Maps
  • Click on Create Map
  • Edit general map attributes

General map attributes:

ParameterDescription
Name Unique map name.
Width Map width in pixels.
Height Map height in pixels.
Background image Use background image:
No image - no background image (white background)
Image - selected image to be used as a background image. No scaling is performed.
Icon highlighting Map elements will receive highlighting. If element has an active trigger, round background will be used, having same colour as the highest severity trigger. If element status is “disabled” or “in maintenance”, square background will be used.
Mark elements on trigger status change Elements that have a trigger status recently changed will be highlighted with markers.
Expand single problem If a map element (host, host group or another map) has a single problem, this option controls whether problem (trigger) name is printed, or problem count. If marked, problem name is used.
Icon label type Label type used for all map icons:
Label - icon label only
IP address - IP address only
Element name - element name (for example, host name)
Status only - status only (OK or PROBLEM)
Nothing - no icon labels are displayed
Icon label location Display icon label on:
Bottom - bottom (under the icon)
Left - left side
Right - right side
Top - top of the icon

When you save this, you have created an empty map with a name, dimensions and certain preferences. Now you need to add some elements. For that, click on the map name in the list to open the editable area.

Adding elements

To add an element, click on the “+” next to Icon. The new element will appear at the top left corner of the map. Drag and drop it wherever you like.

Now that you have one element in the place, you may want to add some more and start differentiating them by giving names etc. By clicking on the element, a form is displayed and you can set the element type, give a name, choose a different icon etc.

Map element attributes:

ParameterDescription
Type Type of the element:
Host - icon representing status of all triggers of the selected host
Map - icon representing status of all elements of a map
Trigger - icon representing status of a single trigger
Host group - icon representing status of all triggers of all hosts belonging to a group
Image - an icon, not linked to any resource
Label Icon label, any string.
Macros and multi-line string can be used in labels.
Label location Label location:
Default - Map's default label location
Bottom - bottom (under the icon)
Left - left side
Right - right side
Top - top of the icon
Host Status of triggers for the selected host will be used.
Map Status of all elements for the selected map will be used.
Trigger Status of the selected trigger will be used.
Host group Status of all triggers for the selected host group will be used.
Icon (default) Icon to be used.
Use advanced icons
Coordinate X X coordinate for the map element.
Coordinate Y Y coordinate for the map element.
URL If set, the URL will be used when a user clicks on the screen element.
Added elements are not automatically saved. If you navigate away from the page, all changes may be lost.

Therefore it is a good idea to click on the Save button in the top right corner. Once clicked, the changes are saved regardless of what you choose in the following popup.

Once you have put some elements of your network on the map, it is time to start linking them.

Linking elements

To link two elements in the map:

  • Select them both (first select one and then hold down Shift (or Ctrl) to select the other)
  • Click on the “+” next to Link

A form is displayed where you can probably see Link1. Click on it and edit its attributes.

Map link attributes:

ParameterDescription
Label Label that will be rendered on top of the link. You can use macros here.
Element 1 First element that link connects.
Element 2 Second element that link connects.
Link status indicators List of triggers linked to the link. In case if a trigger has status PROBLEM, its style is applied to the link.
Type (OK) Default link style:
Line - single line
Bold line - bold line
Dot - dots
Dashed line - dashed line
Colour (OK) Default link colour.