5. Карты сети

Обзор

Экспорт карты сети содержит:

все связанные изображения
структуру карты - все настройки карты, все находящиеся на карте элементы с их настройками, связи карты и индикаторы состояний связей карты

Не экспортируются группы узлов сети, узлы сети, триггеры, другие карты и любые другие элементы, которые могут быть связаны с экспортируемой картой. Таким образом, если хотя бы один из элементов, на который ссылается карта, отсутствует, импорт завершится с ошибкой.

Экспорт/импорт карт сетей поддерживается начиная с Zabbix 1.8.2.

Экспорт

Для экспорта карт сети сделайте следующее:

Перейдите в: Мониторинг → Карты сети
Отметьте карты сети, которые нужно экспортировать
Нажмите на Экспорт ниже списка

Выбранные карты сети экспортируются в локальный XML файл с именем по умолчанию zabbix_export_maps.xml.

Импорт

Для импорта карт сети сделайте следующее:

Перейдите в: Мониторинг → Карты сети
Нажмите на Импорт справа
Выберите импортируемый файл
Отметьте необходимые опции в правилах импорта
Нажмите на Импорт

Все обязательные поля ввода отмечены красной звёздочкой.

После импорта в веб-интерфейсе отобразится сообщение об успехе или об ошибке.

Правила импорта:

Правило	Описание
Обновить существующее	Существующие элементы будут обновлены данными взятыми с файла импорта. В противном случае они не будут обновляться.
Создать новое	Импорт добавит новые элементы, используя данные из файла импорта. В противном случае они не будут добавляться.

Если вы не отметите обе опции для карты сети и выберите соответствующие опции для изображений, только изображения будут импортированы. Импорт изображений доступен только пользователям Zabbix Супер Администраторам.

Если заменить существующее изображение, это повлияет на все карты, которые используют это изображение.

Формат экспорта

Экспорт маленькой карты сети с тремя элементами, их изображениями и некоторыми связями между ними. Обратите внимание, что изображения обрезаны, чтобы сэкономить место.

<?xml version="1.0" encoding="UTF-8"?>
       <zabbix_export>
           <version>4.0</version>
           <date>2016-10-05T08:16:20Z</date>
           <images>
               <image>
                   <name>Server_(64)</name>
                   <imagetype>1</imagetype>
                   <encodedImage>iVBOR...SuQmCC</encodedImage>
               </image>
               <image>
                   <name>Workstation_(64)</name>
                   <imagetype>1</imagetype>
                   <encodedImage>iVBOR...SuQmCC</encodedImage>
               </image>
               <image>
                   <name>Zabbix_server_3D_(96)</name>
                   <imagetype>1</imagetype>
                   <encodedImage>iVBOR...ggg==</encodedImage>
               </image>
           </images>
           <maps>
               <map>
                   <name>Network</name>
                   <width>590</width>
                   <height>400</height>
                   <label_type>0</label_type>
                   <label_location>0</label_location>
                   <highlight>1</highlight>
                   <expandproblem>0</expandproblem>
                   <markelements>1</markelements>
                   <show_unack>0</show_unack>
                   <severity_min>2</severity_min>
                   <show_suppressed>0</show_suppressed>
                   <grid_size>40</grid_size>
                   <grid_show>1</grid_show>
                   <grid_align>1</grid_align>
                   <label_format>0</label_format>
                   <label_type_host>2</label_type_host>
                   <label_type_hostgroup>2</label_type_hostgroup>
                   <label_type_trigger>2</label_type_trigger>
                   <label_type_map>2</label_type_map>
                   <label_type_image>2</label_type_image>
                   <label_string_host/>
                   <label_string_hostgroup/>
                   <label_string_trigger/>
                   <label_string_map/>
                   <label_string_image/>
                   <expand_macros>0</expand_macros>
                   <background/>
                   <iconmap/>
                   <urls/>
                   <selements>
                       <selement>
                           <elementtype>0</elementtype>
                           <label>Host 1</label>
                           <label_location>-1</label_location>
                           <x>476</x>
                           <y>28</y>
                           <elementsubtype>0</elementsubtype>
                           <areatype>0</areatype>
                           <width>200</width>
                           <height>200</height>
                           <viewtype>0</viewtype>
                           <use_iconmap>0</use_iconmap>
                           <selementid>8</selementid>
                           <elements>
                               <element>
                                   <host>Discovered host</host>
                               </element>
                           </elements>
                           <icon_off>
                               <name>Server_(64)</name>
                           </icon_off>
                           <icon_on/>
                           <icon_disabled/>
                           <icon_maintenance/>
                           <application/>
                           <urls/>
                       </selement>
                       <selement>
                           <elementtype>0</elementtype>
                           <label>Zabbix server</label>
                           <label_location>-1</label_location>
                           <x>252</x>
                           <y>50</y>
                           <elementsubtype>0</elementsubtype>
                           <areatype>0</areatype>
                           <width>200</width>
                           <height>200</height>
                           <viewtype>0</viewtype>
                           <use_iconmap>0</use_iconmap>
                           <selementid>6</selementid>
                           <elements>
                               <element>
                                   <host>Zabbix server</host>
                               </element>
                           </elements>
                           <icon_off>
                               <name>Zabbix_server_3D_(96)</name>
                           </icon_off>
                           <icon_on/>
                           <icon_disabled/>
                           <icon_maintenance/>
                           <application/>
                           <urls/>
                       </selement>
                       <selement>
                           <elementtype>0</elementtype>
                           <label>New host</label>
                           <label_location>-1</label_location>
                           <x>308</x>
                           <y>230</y>
                           <elementsubtype>0</elementsubtype>
                           <areatype>0</areatype>
                           <width>200</width>
                           <height>200</height>
                           <viewtype>0</viewtype>
                           <use_iconmap>0</use_iconmap>
                           <selementid>7</selementid>
                           <elements>
                               <element>
                                   <host>Zabbix host</host>
                               </element>
                           </elements>
                           <icon_off>
                               <name>Workstation_(64)</name>
                           </icon_off>
                           <icon_on/>
                           <icon_disabled/>
                           <icon_maintenance/>
                           <application/>
                           <urls/>
                       </selement>
                   </selements>
                   <links>
                       <link>
                           <drawtype>0</drawtype>
                           <color>008800</color>
                           <label/>
                           <selementid1>6</selementid1>
                           <selementid2>8</selementid2>
                           <linktriggers/>
                       </link>
                       <link>
                           <drawtype>2</drawtype>
                           <color>00CC00</color>
                           <label>100MBps</label>
                           <selementid1>7</selementid1>
                           <selementid2>6</selementid2>
                           <linktriggers>
                               <linktrigger>
                                   <drawtype>0</drawtype>
                                   <color>DD0000</color>
                                   <trigger>
                                       <description>Zabbix agent on {HOST.NAME} is unreachable for 5 minutes</description>
                                       <expression>{Zabbix host:agent.ping.nodata(5m)}=1</expression>
                                       <recovery_expression/>
                                   </trigger>
                               </linktrigger>
                           </linktriggers>
                       </link>
                   </links>
               </map>
           </maps>
       </zabbix_export>

Теги элементов

Значения тегов элементов описаны в таблице ниже.

Элемент	Свойство элемента	Тип	Диапазон	Описание
images				Корневой элемент изображений.
image				Одиночное изображение.
	name	`строка`		Уникальное имя изображения.
	imagetype	`целое число`	1 - иконка 2 - фон	Тип изображения.
	encodedImage			Изображение закодированное в Base64.
maps				Корневой элемент карт сети.
map				Одиночная карта.
	name	`строка`		Уникальное имя карты.
	width	`целое число`		Ширина карты, в пикселях.
	height	`целое число`		Высота карты, в пикселях.
	label_type	`целое число`	0 - подпись 1 - IP адрес узла сети 2 - имя элемента 3 - только состояние 4 - ничего	Тип подписи к элементам карты.
	label_location	`целое число`	0 - снизу 1 - слева 2 - справа 3 - сверху	Расположение подписи к элементам карты по умолчанию.
	highlight	`целое число`	0 - нет 1 - да	Включение подсветки иконок для активных триггеров и состояний узлов сети.
	expandproblem	`целое число`	0 - нет 1 - да	Отображение триггера с проблемой у элементах с одной проблемой.
	markelements	`целое число`	0 - нет 1 - да	Подсветка элементов карты, которые недавно изменили свое состояние.
	show_unack	`целое число`	0 - количество всех проблем 1 - количество неподтвержденных проблем 2 - количество подтвержденных и неподтвержденных проблем раздельно	Отображение проблем.
	severity_min	`целое число`	0 - не классифицировано 1 - информация 2 - предупреждение 3 - средняя 4 - высокая 5 - чрезвычайная	Минимальная важность триггеров по умолчанию, которая отображается на карте.
	show_suppressed	`целое число`	0 - нет 1 - да	Отображение проблем, которые в противном случае были бы подавлены (не показаны) по причине обслуживания узлов сети.
	grid_size	`целое число`	20, 40, 50, 75 или 100	Размер ячейки сетки карты в пикселях, если "grid_show=1"
	grid_show	`целое число`	0 - да 1 - нет	Отображение сетки в настройке карты.
	grid_align	`целое число`	0 - да 1 - нет	Автоматическое выравнивание иконок в настройке карты.
	label_format	`целое число`	0 - нет 1 - да	Использование расширенной конфигурации подписей.
	label_type_host	`целое число`	0 - подпись 1 - IP адрес узла сети 2 - имя элемента 3 - только состояние 4 - ничего 5 - пользовательская подпись	Метод отображения подписи к узлам сети, если "label_format=1"
	label_type_hostgroup	`целое число`	0 - подпись 2 - имя элемента 3 - только состояние 4 - ничего 5 - пользовательская подпись	Метод отображения подписи к группам узлов сети, если "label_format=1"
	label_type_trigger	`целое число`	0 - подпись 2 - имя элемента 3 - только состояние 4 - ничего 5 - пользовательская подпись	Метод отображения подписи к триггеров, если "label_format=1"
	label_type_map	`целое число`	0 - подпись 2 - имя элемента 3 - только состояние 4 - ничего 5 - пользовательская подпись	Метод отображения подписи к карт сети, если "label_format=1"
	label_type_image	`целое число`	0 - подпись 2 - имя элемента 4 - ничего 5 - пользовательская подпись	Метод отображения подписи к изображений, если "label_format=1"
	label_string_host	`строка`		Пользовательская подпись к элементам узлов сети, если "label_type_host=5"
	label_string_hostgroup	`строка`		Пользовательская подпись к элементам групп узлов сети, если "label_type_hostgroup=5"
	label_string_trigger	`строка`		Пользовательская подпись к элементам триггеров, если "label_type_trigger=5"
	label_string_map	`строка`		Пользовательская подпись к элементам карт сети, если "label_type_map=5"
	label_string_image	`строка`		Пользовательская подпись к элементам изображениям, если "label_type_image=5"
	expand_macros	`целое число`	0 - no 1 - yes	Раскрытие макросов в подписях при настройке карты.
	background	`id`		ID изображения фона (если имеется), если "imagetype=2"
	iconmap	`id`		ID соответствия иконок (если имеется).
urls
url				Одиночный URL.
	name	`строка`		Имя ссылки.
	url	`строка`		Сама ссылка URL.
	elementtype	`целое число`	0 - узел сети 1 - карта 2 - триггер 3 - группа узлов сети 4 - изображение	Принадлежность ссылки к типу элемента карты.
selements
selement				Одиночный элемент карты.
	elementtype	`целое число`	0 - узел сети 1 - карта сети 2 - триггер 3 - группа узлов сети 4 - изображение	Тип элемента карты.
	label	`строка`		Подпись к иконке.
	label_location	`целое число`	-1 - использование умолчаний карты 0 - сниху 1 - слева 2 - справа 3 - сверху
	x	`целое число`		Расположение на оси X.
	y	`целое число`		Расположение на оси Y.
	elementsubtype	`целое число`	0 - одна группа узлов сети 1 - все узлы сети группы	Подтип элемента, если "elementtype=3"
	areatype	`целое число`	0 - вписать во всю карту 1 - пользовательский размер	Размер области, если "elementsubtype=1"
	width	`целое число`		Ширина области, если "areatype=1"
	height	`целое число`		Высота области, если "areatype=1"
	viewtype	`целое число`	0 - располагать равномерно в области	Алгоритм расположения в области, если "elementsubtype=1"
	use_iconmap	`целое число`	0 - нет 1 - да	Использование соответствия иконок для этого элемента. Уместно только, если соответствие иконок активировано на уровне карты.
	selementid	`id`		Уникальный ID записи элемента.
	application	`строка`		Фильтр имени групп элементов данных. Если имя группы элементов данных задана, на карте сети будут отображаться только те проблемы и триггеры, которые принадлежат заданной группе элементов данных.
elements
element				Один Zabbix объект, который представлен на карте (карта, группа узлов сети, узел сети и т.д.).
	host
icon_off				Используемое изображение, когда элемент в состоянии 'OK'.
icon_on				Используемое изображение, когда элемент в состоянии 'Проблема'.
icon_disabled				Используемое изображение, когда элемент деактивирован.
icon_maintenance				Используемое изображение, когда элемент в обслуживании.
	name	`строка`		Уникальное имя изображения.
links
link				Одиночная связь между элементами карты.
	drawtype	`целое число`	0 - линия 2 - жирная линия 3 - точечная линия 4 - пунктирная линия	Стиль связи.
	color	`строка`		Цвет связи (6 символов, hex).
	label	`строка`		Подпись к связи.
	selementid1	`id`		ID первого элемента, с которым соединена связь.
	selementid2	`id`		ID второго элемента, с которым соединена связь.
linktriggers
linktrigger				Одиночный индикатор состояния связи.
	drawtype	`целое число`	0 - линия 2 - жирная линия 3 - точечная линия 4 - пунктирная линия	Стиль связи, когда триггер в состоянии 'Проблема'.
	color	`строка`		Цвет связи (6 символов, hex), когда триггер в состоянии 'Проблема'.
trigger				Используемый триггер для индикации состояния связи.
	description	`строка`		Имя триггера.
	expression	`строка`		Выражение триггера.
	recovery_expression	`строка`		Выражение восстановления триггера.

Maps

Element		Type	Description
name		string	Unique map name.
width		integer	Map width, in pixels.
height		integer	Map height, in pixels.
label_type		integer	Map element label type. Possible values: 0 - Label; 1 - Host IP address; 2 - Element name; 3 - Status only; 4 - Nothing.
label_location		integer	Map element label location by default. Possible values: 0 - Bottom; 1 - Left; 2 - Right; 3 - Top.
highlight		integer	Enable icon highlighting for active triggers and host statuses. Possible values: 0 - No; 1 - Yes.
expandproblem		integer	Display problem trigger for elements with a single problem. Possible values: 0 - No; 1 - Yes.
markelements		integer	Highlight map elements that have recently changed their status. Possible values: 0 - No; 1 - Yes.
show_unack		integer	Problem display. Possible values: 0 - Count of all problems; 1 - Count of unacknowledged problems; 2 - Count of acknowledged and unacknowledged problems separately.
severity_min		integer	Minimum trigger severity to show on the map by default. Possible values: 0 - Not classified; 1 - Information; 2 - Warning; 3 - Average; 4 - High; 5 - Disaster.
show_suppressed		integer	Display problems, which would otherwise be suppressed (not shown) because of host maintenance. Possible values: 0 - No; 1 - Yes.
grid_size		integer	Cell size of a map grid in pixels. Supported if `grid_show` is set to `0`. Possible values: 20, 40, 50, 75 or 100.
grid_show		integer	Display a grid in map configuration. Possible values: 0 - Yes; 1 - No.
grid_align		integer	Automatically align icons in map configuration. Possible values: 0 - Yes; 1 - No.
label_format		integer	Use advanced label configuration. Possible values: 0 - No; 1 - Yes.
label_type_host		integer	Display label as host label. Supported if `label_format` is set to `1`. Possible values: 0 - Label; 1 - Host IP address; 2 - Element name; 3 - Status only; 4 - Nothing; 5 - Custom label.
label_type_hostgroup		integer	Display label as host group label. Supported if `label_format` is set to `1`. Possible values: 0 - Label; 2 - Element name; 3 - Status only; 4 - Nothing; 5 - Custom label.
label_type_trigger		integer	Display label as trigger label. Supported if `label_format` is set to `1`. Possible values: 0 - Label; 2 - Element name; 3 - Status only; 4 - Nothing; 5 - Custom label.
label_type_map		integer	Display label as map label. Supported if `label_format` is set to `1`. Possible values: 0 - Label; 2 - Element name; 3 - Status only; 4 - Nothing; 5 - Custom label.
label_type_image		integer	Display label as image label. Supported if `label_format` is set to `1`. Possible values: 0 - Label; 2 - Element name; 4 - Nothing; 5 - Custom label.
label_string_host		string	Custom label for host elements. Supported if `label_type_host` is set to `5`.
label_string_hostgroup		string	Custom label for host group elements. Supported if `label_type_hostgroup` is set to `5`.
label_string_trigger		string	Custom label for trigger elements. Supported if `label_type_trigger` is set to `5`.
label_string_map		string	Custom label for map elements. Supported if `label_type_map` is set to `5`.
label_string_image		string	Custom label for image elements. Supported if `label_type_image` is set to `5`.
expand_macros		integer	Expand macros in labels in map configuration. Possible values: 0 - No; 1 - Yes.
background			Root element for background image (if any). Supported if `imagetype` is set to `2`.
	name	string	Background image name.
iconmap			Root element for icon mapping (if any).
	name	string	Icon mapping name.
urls			Root element for URLs used by maps or each map element.
	name	string	Link name.
	url	string	Link URL.
	elementtype	integer	Map item type the link belongs to. Possible values: 0 - Host; 1 - Map; 2 - Trigger; 3 - Host group; 4 - Image.
selements			Root element for map selements.
shapes			Root element for map shapes.
	type	integer	Shape type. Possible values: 0 - Rectangle; 1 - Ellipse.
	x	integer	X coordinates of the shape in pixels.
	y	integer	Y coordinates of the shape in pixels.
	width	integer	Shape width.
	height	integer	Shape height.
	text	string	Text inside of shape.
	font	integer	Text font style. Possible values: 0 - Georgia, serif; 1 - "Palatino Linotype", "Book Antiqua", Palatino, serif; 2 - "Times New Roman", Times, serif; 3 - Arial, Helvetica, sans-serif; 4 - "Arial Black", Gadget, sans-serif; 5 - "Comic Sans MS", cursive, sans-serif; 6 - Impact, Charcoal, sans-serif; 7 - "Lucida Sans Unicode", "Lucida Grande", sans-serif; 8 - Tahoma, Geneva, sans-serif; 9 - "Trebuchet MS", Helvetica, sans-serif; 10 - Verdana, Geneva, sans-serif; 11 - "Courier New", Courier, monospace; 12 - "Lucida Console", Monaco, monospace.
	font_size	integer	Font size in pixels.
	font_color	string	Font color represented in hexadecimal code.
	text_halign	integer	Horizontal alignment of text. Possible values: 0 - Center; 1 - Left; 2 - Right.
	text_valign	integer	Vertical alignment of text. Possible values: 0 - Middle; 1 - Top; 2 - Bottom.
	border_type	integer	Type of the border for the shape. Possible values: 0 - None; 1 - Bold line; 2 - Dotted line; 3 - Dashed line.
	border_width	integer	Width of the border in pixels.
	border_color	string	Border color represented in hexadecimal code.
	background_color	string	Background (fill) color represented in hexadecimal code.
	zindex	integer	Value for ordering all shapes and lines (z-index).
lines			Root element for map lines.
	x1	integer	X coordinates of the line point 1 in pixels.
	y1	integer	Y coordinates of the line point 1 in pixels.
	x2	integer	X coordinates of the line point 2 in pixels.
	y2	integer	Y coordinates of the line point 2 in pixels.
	line_type	integer	Line type. Possible values: 0 - None; 1 - Bold line; 2 - Dotted line; 3 - Dashed line.
	line_width	integer	Line width in pixels.
	line_color	string	Line color represented in hexadecimal code.
	zindex	integer	Value for ordering all shapes and lines (z-index).
links			Root element for links between map elements.
	drawtype	integer	Link style. Possible values: 0 - Line; 2 - Bold line; 3 - Dotted line; 4 - Dashed line.
	color	string	Link color (6 symbols, hex).
	label	string	Link label.
	selementid1	id	ID of one element to connect.
	selementid2	id	ID of the other element to connect.
linktriggers			Root element for link status indicators.

See also: Map object (refer to the relevant property with a matching name).

Map selements

Element		Type	Description
elementtype		integer	Map element type. Possible values: 0 - Host; 1 - Map; 2 - Trigger; 3 - Host group; 4 - Image.
elements			Root element for Zabbix entities (host, host group, map, etc.) that are represented on the map. All entities have their respective element (`host`, etc.; see, for example, Export format).
label		string	Icon label.
label_location		integer	Label location. Possible values: -1 - Use map default; 0 - Bottom; 1 - Left; 2 - Right; 3 - Top.
x		integer	Location on the X axis.
y		integer	Location on the Y axis.
elementsubtype		integer	Element subtype. Supported if `elementtype` is set to `3`. Possible values: 0 - Single host group; 1 - All host groups.
areatype		integer	Area size. Supported if `elementtype` is set to `1`. Possible values: 0 - Same as whole map; 1 - Custom size.
width		integer	Width of area. Supported if `areatype` is set to `1`.
height		integer	Height of area. Supported if `areatype` is set to `1`.
viewtype		integer	Area placement algorithm. Supported if `elementsubtype` is set to `1`. Possible values: 0 - Place evenly in the area.
use_iconmap		integer	Use icon mapping for this element. Relevant only if icon mapping is activated on map level. Possible values: 0 - No; 1 - Yes.
selementid		id	Unique element record ID.
icon_off			Root element for image to use when element is in 'OK' status.
	name	string	Unique image name.
icon_on			Root element for image to use when element is in 'Problem' status.
	name	string	Unique image name.
icon_disabled			Root element for image to use when element is disabled.
	name	string	Unique image name.
icon_maintenance			Root element for image to use when element is in maintenance.
	name	string	Unique image name.
urls			Root element for URLs used by maps or each map element.
	name	string	Link name.
	url	string	Link URL.
evaltype		integer	Evaluation type for tags.
tags			Root element for problem tags (for host and host group elements). If tags are given, only problems with these tags will be displayed on the map.
	tag	string	Tag name.
	value	string	Tag value.
	operator	integer	Operator.

See also: Map element object (refer to the relevant property with a matching name).

Map link status indicators

Element		Type	Description
drawtype		integer	Link style when trigger is in the 'Problem' state. Possible values: 0 - Line; 2 - Bold line; 3 - Dotted line; 4 - Dashed line.
color		string	Link color (6 symbols, hex) when trigger is in the 'Problem' state.
trigger			Root element for trigger used to indicate link status.
	description	string	Trigger name.
	expression	string	Trigger expression.
	recovery_expression	string	Trigger recovery expression.

See also: Map link trigger object (refer to the relevant property with a matching name).

Documentation