Zabbix Documentation 4.2

3.04.04.4 (current)| In development:5.0 (devel)| Unsupported:1.82.02.22.43.23.44.2Guidelines

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 [2018/08/27 08:35]
martins-v adding 'show suppressed problems' option
manual:config:visualisation:maps:map [2019/04/18 06:48] (current)
martins-v formatting fix
Line 51: Line 51:
 |//​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.|
 |//​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. ​ | |//​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. ​ |
-|//Icon highlighting// ​ |If you check this box, map elements 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. ​ | +|//Icon highlighting// ​ |If you check this box, map elements 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.\\ See also: [[:​manual/​web_interface/​frontend_sections/​monitoring/​maps#​viewing_maps|Viewing maps]] ​ | 
-|//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.| +|//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. ​ 
-|//Display problems// ​ |Select how problems are displayed with a map element:\\ **Expand single problem** - if a map element has one single problem, ​the problem ​(trigger) name is displayed\\ **Number of problems** - the total number of problems is displayed\\ **Number of problems and expand most critical one** - problem (trigger) ​name is displayed for the most critical ​one and the total number of problems is displayed. 'Most critical'​ is determined based on:\\ //For trigger map element// ​- trigger ​severity and trigger position in the trigger list;\\ //For other map elements// - trigger ​severity and trigger ID.  |+|//Display problems// ​ |Select how problems are displayed with a map element:\\ **Expand single problem** - name of the most critical ​problem is displayed\\ **Number of problems** - the total number of problems is displayed\\ **Number of problems and expand most critical one** - name of the most critical ​problem ​and the total number of problems is displayed.\\ 'Most critical'​ is determined based on problem severity and, if equal, problem event ID (higher ID or later problem displayed first). (Note that trigger ID instead of problem event ID was evaluated before 4.2.1.)\\ //For trigger map element// ​it is based on problem ​severity and, if equal, ​trigger position in the trigger list. In case of multiple problems of the same trigger, the most recent one will be displayed.  |
 |//Advanced labels// ​ |If you check this box you will be able to define separate label types for separate element types. ​ | |//Advanced labels// ​ |If you check this box you will be able to define separate label types for separate element types. ​ |
 |//Map element label type// ​ |Label type used for map elements:\\ **Label** - map element 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| |//Map element label type// ​ |Label type used for map elements:\\ **Label** - map element 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|
Line 60: Line 60:
 |//Minimum trigger severity// ​ |Problems below the selected minimum severity level will not be displayed in the map.\\ For example, with //Warning// selected, changes with //​Information//​ and //Not classified//​ level triggers will not be reflected in the map.\\ This parameter is supported starting with Zabbix 2.2.  | |//Minimum trigger severity// ​ |Problems below the selected minimum severity level will not be displayed in the map.\\ For example, with //Warning// selected, changes with //​Information//​ and //Not classified//​ level triggers will not be reflected in the map.\\ This parameter is supported starting with Zabbix 2.2.  |
 |//Show suppressed problems// ​ |Mark the checkbox to display problems which would otherwise be suppressed (not shown) because of host maintenance. ​ | |//Show suppressed problems// ​ |Mark the checkbox to display problems which would otherwise be suppressed (not shown) because of host maintenance. ​ |
-|//​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 map viewing mode.\\ [[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 map viewing mode.\\ ​Macros can be used in map URL names and values. For a full list, see [[:manual/appendix/macros/​supported_by_location|supported macros]] and search for 'map URL names and values'​ |
  
 === Sharing === === Sharing ===
Line 89: Line 89:
 ^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 one or more triggers\\ **[[manual:​config:​visualisation:​maps:​host_groups|Host group]]** - icon representing status of all triggers of all hosts belonging to the selected 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 one or more triggers\\ **[[manual:​config:​visualisation:​maps:​host_groups|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.\\ ​[[manual:​config:​macros|Macros]] and multi-line strings can be used in labels. ​ |+|//​Label// ​ |Icon label, any string.\\ Macros and multi-line strings can be used in labels. For a full list of supported macros, see [[:​manual/​appendix/​macros/​supported_by_location|supported macros]] and search for 'map element labels'​.  |
 |//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  | |//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// ​ |Enter the host, if the element type is '​Host'​. This field is auto-complete so starting to type the name of a host will offer a dropdown of matching hosts. Scroll down to select. Click on '​x'​ to remove the selected. ​ | |//​Host// ​ |Enter the host, if the element type is '​Host'​. This field is auto-complete so starting to type the name of a host will offer a dropdown of matching hosts. Scroll down to select. Click on '​x'​ to remove the selected. ​ |
Line 100: Line 100:
 |//​Coordinate X//  |X coordinate of the map element. ​ | |//​Coordinate X//  |X coordinate of the map element. ​ |
 |//​Coordinate Y//  |Y coordinate of the map element. ​ | |//​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 map viewing mode. 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 element ​URLs: {MAP.ID}{HOSTGROUP.ID},​ {HOST.ID}, {TRIGGER.ID}  ​|+|//​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 map viewing mode. 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.\\ Macros can be used in map element ​names and valuesFor a full listsee [[:​manual/​appendix/​macros/​supported_by_location|supported macros]] and search for 'map URL names and values'​  ​|
  
 <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.