Documentation
Table of Contents
1 Конфигурисање мрежне мапе
Преглед
Конфигурисање мапе у Zabbix-у захтева да прво креирате мапу дефинисањем њених општих параметара, а затим почнете да попуњавате стварну мапу елементима и њиховим везама.
Можете попунити мапу елементима који су хост, група хостова, окидач, слика или нека друга мапа.
Иконе се користе за представљање елемената мапе. Можете дефинисати информације које ће се приказивати помоћу икона и подесити да се недавни проблеми приказују на посебан начин. Можете повезати иконе и дефинисати информације које ће се приказивати на везама.
Можете додати прилагођене URL-ове којима ће бити доступно кликом на иконе. Тако можете повезати икону хоста са својствима хоста или икону мапе са другом мапом.
Број проблема на мапама се приказује само за узрок проблема.
Мапе се управљају у Праћење → Мапе, где се могу конфигурисати, управљати и прегледати. У приказу за праћење, можете кликнути на иконе и искористити везе до неких скрипти и URL-ова.
Мрежне мапе су засноване на векторској графици (SVG).
Јавне и приватне мапе
Сви корисници у Zabbix-у (укључујући и кориснике који нису администратори) могу да креирају мрежне мапе. Мапе имају власника - корисника који их је креирао. Мапе могу бити јавне или приватне.
- Јавне мапе су видљиве свим корисницима, мада да би их видео, корисник мора имати приступ за читање барем једног елемента мапе. Јавне мапе могу се уређивати у случају да корисник/корисничка група има дозволе за читање и писање за ову мапу и барем дозволе за читање свих елемената одговарајуће мапе, укључујући окидаче у линковима.
- Приватне мапе су видљиве само њиховом власнику и корисницима/корисничким групама са којима је мапа дељена од стране власника. Редовни корисници (корисници који нису супер администратори) могу да деле само са групама и корисницима чији су чланови. Корисници са администраторским нивоом могу да виде приватне мапе без обзира да ли су власник или припадају листи дељених корисника. Приватне мапе може да уређује власник мапе и у случају да корисник/корисничка група има дозволе за читање и писање за ову мапу и бар дозволе за читање свих елемената одговарајуће мапе, укључујући окидаче у линковима.
Елементи мапе за које корисник нема дозволу за читање приказују се сивом иконом, а све текстуалне информације о елементу су скривене. Међутим, ознака окидача је видљива чак и ако корисник нема дозволу за окидач.
Да би додао елемент на мапу, корисник мора имати и бар дозволу за читање елемента.
Creating a map
To create a map, do the following:
- Go to Monitoring → Maps
- Go to the view with all maps
- Click on Create map
You can also use the Clone button in the configuration form of an existing map to create a new map. This map will have all of the properties of the existing map, including general layout attributes, as well as the elements of the existing map.
The Map tab contains general map attributes:
All mandatory input fields are marked with a red asterisk.
General map attributes:
| Parameter | Description |
|---|---|
| Owner | Name of map owner. |
| 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. 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 mapping 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 color 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: 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. |
| Display problems | Select how problems are displayed with a map element: Expand single problem - if there is only one problem, the problem name is displayed. Otherwise, the total number of problems is displayed. Number of problems - the total number of problems is displayed Number of problems and expand most critical one - the 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). For a 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. |
| 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 location | Label location in relation to the map element: Bottom - beneath the map element Left - to the left Right - to the right Top - above the map element |
| 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 |
| Minimum trigger severity | Problems below the selected minimum severity level will not be displayed on the map. For example, with Warning selected, changes with Information and Not classified level triggers will not be reflected in the map. |
| Show suppressed problems | Mark the checkbox to display problems that would otherwise be suppressed (not shown) because of host maintenance. |
| URLs | URLs (up to 2048 characters) for each element type can be defined. A label for the URL can also be defined. 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 supported macros and search for 'map URL names and values'. |
Дељење
Картица Дељење садржи тип карте, као и опције дељења (корисничке групе, корисници) за приватне мапе:
| Parameter | Description |
|---|---|
| Type | Изаберите тип карте: Приватна - мапа је видљива само одабраним групама корисника и корисницима Јавна - мапа је видљива свима |
| List of user group shares | Изаберите групе корисника којима је мапа доступна. Можете дозволити приступ само за читање или за читање-уписивање. |
| List of user shares | Изаберите кориснике којима је мапа доступна. Можете дозволити приступ само за читање или за читање-уписивање. |
Када кликнете на Додај да сачувате ову мапу, направили сте празну мапу са именом, димензијама и одређеним преференцама. Сада треба да додате неки елементи. За то кликните на Уреди на листи мапа да бисте отворили област за уређивање.
Adding elements
To add an element, click on Add next to Map element. 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". (You can align random elements to the grid later, by clicking on Align map elements.)
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:
| 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 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. Macros and multiline strings can be used. Expression macros are supported in this field, but only with avg, last, min and max functions, with time as parameter (for example, {?avg(/host/key,1h)}).For a full list of supported macros, see 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 |
| 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. |
| Map | Select the map if the element type is 'Map'. This field is auto-complete so starting to type the name of a map will offer a dropdown of matching maps. Scroll down to select. Click on 'x' to remove the selected. |
| Triggers | If the element type is 'Trigger', select one or more triggers in the New triggers field below and click on Add. The order of selected triggers can be changed, but only within the same severity of triggers. Multiple trigger selection also affects {HOST.*} macro resolution both in the editing and view modes. // 1 In editing mode// the first displayed {HOST.*} macros will be resolved depending on the first trigger in the list (based on trigger severity). // 2 View mode// depends on the Display problems parameter in General map attributes. * If Expand single problem mode is chosen, the first displayed {HOST.*} macros will be resolved depending on the latest detected problem trigger (not mattering the severity) or the first trigger in the list (in case no problem detected); * If Number of problems and expand most critical one mode is chosen, the first displayed {HOST.*} macros will be resolved depending on the trigger severity. |
| Host group | Enter the host group if the element type is 'Host group'. This field is auto-complete so starting to type the name of a group will offer a dropdown of matching groups. Scroll down to select. Click on 'x' to remove the selected. |
| Tags | Specify tags to limit the number of problems displayed in the widget. It is possible to include as well as exclude specific tags and tag values. Several conditions can be set. Tag name matching is always case-sensitive. There are several operators available for each condition: Exists - include the specified tag names Equals - include the specified tag names and values (case-sensitive) Contains - include the specified tag names where the tag values contain the entered string (substring match, case-insensitive) Does not exist - exclude the specified tag names Does not equal - exclude the specified tag names and values (case-sensitive) Does not contain - exclude the specified tag names where the tag values contain the entered string (substring match, case-insensitive) There are two calculation types for conditions: And/Or - all conditions must be met, conditions having the same tag name will be grouped by the Or condition Or - enough if one condition is met This field is available for host and host group element types. |
| Automatic icon selection | In this case an icon mapping will be used to determine which icon to display. |
| Icons | You can choose to display different icons for the element in these cases: default, problem, maintenance, disabled. |
| Coordinate X | X coordinate of the map element. |
| Coordinate Y | Y coordinate of the map element. |
| URLs | Element-specific URLs (up to 2048 characters) can be set for the element. A label for the URL can also be defined. 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 values. For a full list, see supported macros and search for 'map URL names and values'. |
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 Update 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.
Избор елемената
Да бисте изабрали елементе, изаберите један, а затим држите Ctrl да бисте изабрали други.
Такође можете да изаберете више елемената тако што ћете превући правоугаоник у област која се може уређивати и избор свих елемената у њој.
Када изаберете више од једног елемента, образац својства елемента се помера у режим масовног ажурирања тако да можете променити атрибуте изабраног елемената у једном потезу. Да бисте то урадили, означите атрибут користећи поље за потврду и унесите нову вредност за то. Овде можете користити макрое (нпр. {HOST.NAME} за ознаку елемента).
Повезивање елемената
Када поставите неке елементе на мапу, време је да почнете са њиховим повезивањем. Да бисте повезали два елемента, прво их морате изабрати. Када су елементи изабрани, кликните на Додај поред Линка.
Када је линк креиран, образац за један елемент сада садржи додатни одељак Линкови. Кликните на Уреди да бисте изменили атрибуте линка.
Атрибути линка:
| Parameter | Description |
|---|---|
| Ознака | Ознака која ће се приказивати преко линка. Изрази macros су подржани у овом пољу, али само са функцијама avg, last, min и max, са временом као параметром (на пример, {?avg(/host/key,1h)}). |
| Повежи се са | Елемент са којим се линк повезује. |
| Тип (ОК) | Подразумевани стил линка: Линија - једна линија Подебљана линија - подебљана линија Тачка - тачке Испрекидана линија - испрекидана линија |
| Боја (ОК) | Подразумевана боја линка. |
| Индикатори линка | Листа окидача повезаних са линком. У случају да окидач има статус ПРОБЛЕМ, његов стил се примењује на линк. |
Померање и копирање и лепљење елемената
Неколико изабраних елемената може да се премести на друго место на мапи кликом на један од изабраних елемената, држећи миш дугме и померање курсора на жељену локацију.
Један или више елемената се могу копирати тако што ћете изабрати елементе кликом на изабрани елемент десним тастером миша и избором Копирај из менија.
Да бисте налепили елементе, кликните на област мапе десним тастером миша и изаберите Налепи из менија. Налепи без спољних веза опција ће налепити елементе задржавајући само везе које су између изабране елементе.
Копирање и лепљење ради у оквиру истог прозора прегледача. Пречице на тастатури нису подржани.
Ordering elements
To bring one element in front of the other (or vice versa) click on the element with the right mouse button and select Bring forward/Bring to front or Send backward/Send to back.
Додавање облика
Поред елемената мапе, могуће је додати и неке облике. Облици нису елементи мапе; они су само визуелни приказ. На пример, правоугаони облик може се користити као позадина за груписање неких домаћина. Могу се додати правоугаони и елиптични облици.
Да бисте додали облик, кликните на Додај поред Облика. Нови облик ће се појавити у горњем левом углу мапе. Превуците га и испустите где год желите.
Нови облик се додаје са подразумеваним бојама. Кликом на облик, приказује се форма и можете прилагодити изглед облика, додати текст, итд.
Да бисте изабрали облике, изаберите један, а затим држите притиснут Ctrl да бисте изабрали остале. Када је изабрано неколико облика, заједничка својства се могу масовно ажурирати, слично као и код елемената.
Текст се може додати у облике. Израз макрои су подржани у тексту, али само са функцијама avg, last, min и max, са временом као параметром (на пример, {?avg(/host/key,1h)}).
Да би се приказивао само текст, облик се може учинити невидљивим уклањањем ивице облика (изаберите 'Ниједна' у пољу Ивица). На пример, обратите пажњу на то како је макро {MAP.NAME}, видљив на горњем снимку екрана, заправо правоугаони облик са текстом, што се може видети када се кликне на макро:
{MAP.NAME} се решава у конфигурисано име мапе приликом прегледа мапе.
Ако се хиперлинкови користе у тексту, они постају кликабилни приликом прегледа мапе.
Прелом редова за текст је увек "укључен" унутар облика. Међутим, унутар елипсе, линије се преламају као да је елипса правоугаоник. Прелом речи није имплементиран, тако да се дугачке речи (речи које не одговарају облику) не преламају, већ се маскирају (на страници за уређивање мапе) или се исецају (друге странице са мапама).
Додавање линија
Поред облика, могуће је додати и неке линије. Линије могу користити за повезивање елемената или облика на мапи.
Да бисте додали линију, кликните на Додај поред Облика. Нови облик ће се појавити на горњи леви угао мапе. Изаберите га и кликните на Линија у уређивање форме да бисте променили облик у линију. Затим подесите линију својства, као што су тип линије, ширина, боја итд.
Наручивање облика и линија
Да бисте поставили један облик испред другог (или обрнуто), кликните на облик десним тастером миша који отвара мени облика карте.
