Zabbix Documentation 2.0

2.23.04.04.2 (current)In development:4.4 (devel)Unsupported:1.82.02.43.23.4

User Tools

Site Tools


manual:config:visualisation:maps:map

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
manual:config:visualisation:maps:map [2011/10/27 13:04]
martins-v adding info
manual:config:visualisation:maps:map [2016/11/02 14:18] (current)
martins-v specifying which macro is supported for link label
Line 1: Line 1:
-<note tip>The content of this page is yet to be completely updated for 2.0.</​note>​ 
- 
 ==== - #1 Configuring a network map ==== ==== - #1 Configuring a network map ====
  
Line 11: Line 9:
 Icons are used to represent map elements. You can define the information that will be displayed with the icons and set that recent problems are displayed in a special way. You can link the icons and define information to be displayed on the links. Icons are used to represent map elements. You can define the information that will be displayed with the icons and set that recent problems are displayed in a special way. You can link the icons and define information to be displayed on the links.
  
-Maps that are ready can be viewed in //​Monitoring -> Maps//. In the monitoring view you can click on the icons and take advantage of the links to some scripts and URLs.+Maps that are ready can be viewed in //​Monitoring// -> //​[[manual:​web_interface:​frontend_sections:​monitoring:​maps|Maps]]//. In the monitoring view you can click on the icons and take advantage of the links to some scripts and URLs.
  
 You can add custom URLs to be accessible by clicking on the icons. Thus you may link a host icon to host properties or a map icon to another map. You can add custom URLs to be accessible by clicking on the icons. Thus you may link a host icon to host properties or a map icon to another map.
Line 19: Line 17:
 To create a map, do the following: To create a map, do the following:
   * Go to //​Configuration -> Maps//   * Go to //​Configuration -> Maps//
-  * Click on //​Create ​Map//+  * Click on //​Create ​map//
   * Edit general map attributes   * Edit general map attributes
  
-{{:1.8:manual:web_interface:1.8.5_frontend_mapform1.png|}}+{{manual:config:visualisation:1.9.9_map_config.png?550|}}
  
 General map attributes: General map attributes:
Line 31: Line 29:
 |//​Height// ​ |Map height 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. You may use a geographical map or any other image to enhance your map.| |//​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. You may use a geographical map or any other image to enhance your map.|
-|//Icon highlighting// ​ |If you check this box, icons will receive highlighting. ​If the element has an active trigger, it will receive a round background, ​having ​the same colour as the highest severity trigger. ​If element status is "​disabled"​ or "in maintenance"​square background ​will be used. | +|//​Automatic icon mapping// ​ |You can set to use an automatic icon mapping, configured in //​Administration -> General -> Icon mapping//. Icon mapping allows to map certain icons against certain host inventory fields. ​ | 
-|//Mark elements on trigger status change// ​ |A recent change of trigger status (recent problem) will be highlighted with markers on the three sides of the element icon that are free of the label. |+|//Icon highlighting// ​ |If you check this box, icons will receive highlighting.\\ Elements with an active trigger will receive a round background, ​in the same colour as the highest severity trigger. ​Moreover, a thick green line will be displayed around the circle, if all problems are acknowledged.\\ Elements with "​disabled"​ or "in maintenance" ​status will get a square background, gray and orange respectively 
 +|//Mark elements on trigger status change// ​ |A recent change of trigger status (recent problem ​or resolution) will be highlighted with markers ​(inward-pointing red triangles) ​on the three sides of the element icon that are free of the label. Markers are displayed for 30 minutes.|
 |//Expand single problem// ​ | If a map element (host, host group or another map) has one single problem, this option controls whether the problem (trigger) name is displayed, or problem count. If marked, problem name is used. | |//Expand single problem// ​ | If a map element (host, host group or another map) has one single problem, this option controls whether the problem (trigger) name is displayed, or problem count. If marked, problem name is used. |
 +|//Advanced labels// ​ |If you check this box you will be able to define separate label types for separate element types.|
 |//Icon label type// ​ |Label type used for icons:\\ **Label** - icon label\\ **IP address** - IP address\\ **Element name** - element name (for example, host name)\\ **Status only** - status only (OK or PROBLEM)\\ **Nothing** - no labels are displayed| |//Icon label type// ​ |Label type used for icons:\\ **Label** - icon label\\ **IP address** - IP address\\ **Element name** - element name (for example, host name)\\ **Status only** - status only (OK or PROBLEM)\\ **Nothing** - no labels are displayed|
 |//Icon label location// ​ |Label location in relation to the icon:\\ **Bottom** - beneath the icon\\ **Left** - to the left\\ **Right** - to the right\\ **Top** - above the icon| |//Icon label location// ​ |Label location in relation to the icon:\\ **Bottom** - beneath the icon\\ **Left** - to the left\\ **Right** - to the right\\ **Top** - above the icon|
 |//Problem display// ​ |Display problem count as:\\ **All** - full problem count will be displayed\\ **Separated** - unacknowledged problem count will be displayed separated as a number of the total problem count\\ **Unacknowledged only** - only the unacknowledged problem count will be displayed| |//Problem display// ​ |Display problem count as:\\ **All** - full problem count will be displayed\\ **Separated** - unacknowledged problem count will be displayed separated as a number of the total problem count\\ **Unacknowledged only** - only the unacknowledged problem count will be displayed|
-|//Links//  |URLs for each element type can be defined (with a label). These will be displayed as links when a user clicks on the element in the monitoring section.\\ [[2.0/manual/config/macros|Macros]] that can be used in map URLs: {MAP.ID}, {HOSTGROUP.ID},​ {HOST.ID}, {TRIGGER.ID}|+|//URLs//  |URLs for each element type can be defined (with a label). These will be displayed as links when a user clicks on the element in the monitoring section.\\ [[manual:config:macros|Macros]] that can be used in map URLs: {MAP.ID}, {HOSTGROUP.ID},​ {HOST.ID}, {TRIGGER.ID}|
  
 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. 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.
Line 49: Line 49:
 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. 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.
  
-{{:1.8:manual:web_interface:1.8.5_frontend_mapform2.png?600|}}+{{manual:config:visualisation:1.9.9_map_element.png?600|}}
  
 Map element attributes: Map element attributes:
  
 ^Parameter^Description^ ^Parameter^Description^
-|//​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 group\\ **Image** - an icon, not linked to any resource| +|//​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 the selected ​group\\ **Image** - an icon, not linked to any resource ​ 
-|//​Label// ​ |Icon label, any string.\\ [[2.0/manual/config/macros|Macros]] and multi-line strings can be used in labels.| +|//​Label// ​ |Icon label, any string.\\ [[manual:config:macros|Macros]] and multi-line strings 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| +|//Label location// ​ |Label location ​in relation to the icon:\\ **Default** - map's default label location\\ **Bottom** - beneath ​the icon\\ **Left** - to the left\\ **Right** - to the right\\ **Top** - above the icon  
-|//​Host// ​ |Status of triggers for the selected ​host will be used.| +|//​Host// ​ |Select ​the host, if the element type is '​Host'​ 
-|//​Map// ​ |Status of all elements for the selected ​map will be used.| +|//​Map// ​ |Select ​the map, if the element type is '​Map'​ 
-|//​Trigger// ​ |Status of the selected ​trigger ​will be used.| +|//​Trigger// ​ |Select ​the trigger, if the element type is '​Trigger'​ 
-|//Host group// ​ |Status of all triggers for the selected ​host group will be used.| +|//Host group// ​ |Select ​the host group, if the element type is 'Host group' 
-|//Icon (default)// ​ |Icon to be used.| +|//Icon (default)// ​ |Icon to be used.  
-|//Use advanced icons//  | | +|//Automatic icon selection//  |In this case an icon mapping will be used to determine which icon to display. ​ | 
-|//​Coordinate X//  |X coordinate ​for the map element.| +|//​Icons// ​ |You can choose to display different icons for the element in these cases: default, problem, maintenance,​ disabled.  ​
-|//​Coordinate Y//  |Y coordinate ​for the map element.| +|//​Coordinate X//  |X coordinate ​of the map element. ​ 
-|//Links//  |Element-specific URLs 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.\\ [[2.0/manual/config/macros|Macros]] that can be used in map URLs: {MAP.ID}, {HOSTGROUP.ID},​ {HOST.ID}, {TRIGGER.ID}|+|//​Coordinate Y//  |Y coordinate ​of the map element. ​ 
 +|//URLs//  |Element-specific URLs 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.\\ [[manual:config:macros|Macros]] that can be used in map URLs: {MAP.ID}, {HOSTGROUP.ID},​ {HOST.ID}, {TRIGGER.ID} ​ |
  
 <note important>​Added elements are not automatically saved. If you navigate away from the page, all changes may be lost. <note important>​Added elements are not automatically saved. If you navigate away from the page, all changes may be lost.
Line 77: Line 78:
 To select elements, select one and then hold down //Ctrl// (or //Shift//) to select the others. 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).+You can also select multiple elements by dragging a rectangle in the editable area and selecting all elements in it (option available since 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). 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).
 +
 +{{manual:​config:​visualisation:​1.9.9_map_update.png?​600|}}
  
 === Linking elements === === Linking elements ===
Line 85: Line 88:
 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. 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.
  
-form is displayed where you can probably see //Link1// in the Connectors block. Click on it and edit its attributes.+With a link created, the single element ​form now contains an additional ​//Edit element links// section. Click on //Edit// before the link to edit its attributes.
  
-{{:1.8:manual:web_interface:1.8.5_frontend_mapform3.png?600|}}+{{manual:config:visualisation:1.9.9_map_links.png?600|}}
  
-Map link attributes:+Link attributes:
  
 ^Parameter^Description^ ^Parameter^Description^
-|//​Label// ​ |Label that will be rendered on top of the link. You can use [[2.0/manual/config/macros|macros]] here.+|//​Label// ​ |Label that will be rendered on top of the link.\\ The [[:manual/appendix/macros/​supported_by_location|{host:​key.func(param)}]] macro is supported in this field, but only with ''​avg'',​ ''​last'',​ ''​min''​ and ''​max''​ trigger functions, with seconds as parameter.  | 
-|//Element 1//  |First element that link connects.+|//Connect to//  |The element that the link connects to.  |
-|//Element 2//  |Second ​element that link connects.| +
-|//​[[2.0/​manual/​config/​visualisation/​maps/​links|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  | |//Type (OK)// ​ |Default link style:\\ **Line** - single line\\ **Bold line** - bold line\\ **Dot** - dots\\ **Dashed line** - dashed line  |
 |//Colour (OK)// ​ |Default link colour. ​ | |//Colour (OK)// ​ |Default link colour. ​ |
 +|//​[[links|Link indicators]]// ​ |List of triggers linked to the link. In case a trigger has status PROBLEM, its style is applied to the link.  |
 +