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

Creating a map

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
Problem display Display:
All - all problems will be displayed
Separated - unacknowledged problems will be displayed as separated against the total problem count
Unacknowledged only - only unacknowledged problems will be displayed
Links One or more URLs with their labels can be set for each element type. These will be displayed as links when a user clicks on the element in the monitoring section.

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.

Note that with the Grid option “On”, elements will always align to the grid (you can pick various grid sizes from the dropdown, also hide/show the grid). If you want to put elements anywhere without alignment, turn the option to “Off”. (Random elements can later again be aligned to the grid with the Align icons button.)

Now that you have some elements in place, you may want to 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.
Links One or more URLs with their labels can be set for the element. These will be displayed as links when a user clicks on the element in the monitoring section. If the element has its own URLs and there are map level URLs for its type defined, they will be combined in the same menu.
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.

Selected grid options are also saved with each map.

Selecting elements

To select elements, select one and then hold down Ctrl (or Shift) to select the others.

You can also select multiple elements by dragging a rectangle in the editable area and selecting all elements in it (starting with Zabbix 2.0).

Once you select more than one element, the element property form shifts to the mass-update mode so you can change attributes of selected elements in one go. To do so, mark the attribute using the checkbox and enter a new value for it. You may use macros here (such as, say, {HOSTNAME} for the element label).

Linking elements

Once you have put some elements on the map, it is time to start linking them. To link two elements you must first select them. With the elements selected, click on the “+” next to Link.

A form is displayed where you can probably see Link1 in the Connectors block. 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.