Sidebar

ru:manual:xml_export_import:map_export_import

5 Экспорт и импорт карт сети

Экспорт и импорт карт сети доступен начиная с версии 1.8.2 .

Элементы управления экспортом и импортом карт сети могут быть найдены в меню Настройка → Карты сети, где отображаются все установленные карты сети.

5.1 Экспорт карт сети

В левом нижнем углу имеется список с доступными двумя опциями: “Экспортировать выбранное” и “Удалить”. Для экспорта карт сети:

  1. Выберите карты, которые вы хотите экспортировать;
  2. Выберите опцию “Экспорт карт”, если еще не выбрана;
  3. Нажмите кнопку “Перейти”;
  4. Выберите файл, в который будет сохранено данные XML с экспортированными картами сети.

5.2 Импорт карт сети

Импортирование карт такое же простое как и экспортирование. Сверху справа рядом с кнопкой “Создать карту” вы можете найти новую кнопку - “Импорт карты”.

Для импортирования карты:

  1. Нажмите кнопку “Импорт карты сети”. Вы перейдете на страницу похожую на ту, что вы видите при импортировании узлов сети в меню Настройка → Экспорт/Импорт;
  2. Нажмите на кнопку “Выбрать файл” для выбора XML файла содержащего данные о экспортированных картах сети Zabbix;
  3. Проверьте опцию “Обновить существующее”, если вы хотите обновить (перезаписать) существующие карты;
  4. Проверьте опцию “Добавить отсутствующее”, если вы хотите создать новую карту, если такой карты нет;
  5. Нажмите импорт для отправки требуемых данных веб-интерфейсу Zabbix;
  6. Подождите обновления страницы. Это может занять некоторое время, если у вас много карт для импорта или много узлов сети, триггеров и т.д.. Веб-интерфейс Zabbix сообщит вам о успешном импорте или об ошибке импорта.
Диалог импорта картыДиалог импорта карты для суперадминистратора Zabbix, отображает опции импорта изображений (доступно начиная с версии 1.8.3)

Нажмите на ссылку “Детали” слева сверху для просмотра подробной информации о результатах импортирования, или чтобы узнать причину ошибки импорта.

5.3 Что экспортируется?

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

5.4 Что не экспортируется?

Любые карты, группы узлов сети, узлы сети, триггеры, изображения или любые другие элементы связанные с экспортируемой картой не экспортируются. Это означает, что если хотя бы один элемент карты ссылается на отсутствующий элемент данных, тогда импортирование будет не успешным.

Например, если карта ссылается на специфичный триггер в специфичной ноде, но этот триггер был тем временем удален, импортирование завершится неудачей с сообщением об ошибке:

Не удалось найти триггер "our_node5:Zabbix server:Disk is full" используемый в экспортируемой карте "Small map".

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

Например экспорт пустой карты с фоновым изображением из узла распределенной установки:

 <sysmap>
   <selements>
   </selements>
   <links>
   </links>
   <name>TEST</name>
   <width>800</width>
   <height>600</height>
   <backgroundid>
     <node>aly_trunk</node>
     <name>Map BG</name>
   </backgroundid>
   <label_type>2</label_type>
   <label_location>0</label_location>
   <highlight>1</highlight>
   <expandproblem>1</expandproblem>
 </sysmap>

5.5.1 Элементы карты

Давайте возьмем XML выборку некоторых элементов карты Zabbix, например:

     <selement>
       <selementid>100100000000372</selementid>
       <elementid>
         <node>noden1</node>
         <host>LocalHost</host>
         <description>DOUBLE</description>
         <expression>{TimeHost:system.localtime[local].last(0)}=0 &amp; {TimeHost:system.localtime[local].last(0)}=2</expression>
       </elementid>
       <elementtype>2</elementtype>
       <iconid_off>
         <node>noden1</node>
         <name>Hub</name>
       </iconid_off>
       <label>New Element</label>
       <label_location>-1</label_location>
       <x>231</x>
       <y>122</y>
     </selement>

  • <selement> является открывающим тэгом для элемента (сокращение от “Элемент карты сети);
  • <selementid> уникальный id элемента, используемый для связей на карте;
  • <elementid> ссылка на физическую запись в Zabbix, которая изображена на карте сети (карта, группа узлов сети/узел сети и др.);
  • <node> тэг будет присутствовать, если экспортируемая карта сделана на распределенной установке, иначе пропускается;
  • <elementtype> описывает, что за тип элемента хранится в тэге <elementid>;
При импортировании XML, значения selementid не должны совпадать с любыми значениями в существующем наборе данных - они используются только для определения связей на карте.
5.5.2 Типы элементов и их сохранение

Тэг elementtype в экспортируемой карте может быть одним из:

ЗначениеТип
0Узел сети
1Карта сети
2Триггер
3Группа узлов сети
4Изображение
  • Ссылка на узел сети

Установка DM (распределенный мониторинг)

       <node>noden1</node>
       <host>LocalHost</host>

Одиночная установка сервера

       <host>LocalHost</host>

Узлы сети ссылаются по имени узла сети.

  • Ссылка на карту сети

Установка DM (распределенный мониторинг)

       <node>noden1</node>
       <name>Local map</name>

Одиночная установка сервера

       <name>Local map</name>

Карты ссылаются по имени карт.

  • Ссылка на триггер

Триггеры описываются более сложным способом: Установка DM (распределенный мониторинг)

       <node>noden1</node>
       <host>LocalHost</host>
       <description>Lack of free memory on server {HOSTNAME}</description>
       <expression>{LocalHost:vm.memory.size[free].last(0)}&lt;10000</expression>

Одиночная установка сервера

       <host>LocalHost</host>
       <description>Lack of free memory on server {HOSTNAME}</description>
       <expression>{LocalHost:vm.memory.size[free].last(0)}&lt;10000</expression>

Триггеры ссылаются по имени узла сети, имени триггера и выражению триггера.

  • Ссылка на группу узлов сети

Установка DM (распределенный мониторинг)

       <node>noden1</node>
       <name>Local Host Group</name>

Одиночная установка сервера

       <name>Local Host Group</name>

Группы узлов сети ссылаются по имени группы узлов сети.

  • Ссылка на изображения
Для изображений <elementid> ноды может быть пропущенным.

Узлы <iconid_off>, <iconid_on>, <iconid_unknown>, <iconid_maintenance> и <iconid_disabled> описываются, какие иконки будут использоваться для элементов карты в зависимости от его состояния.

По умолчанию используется пиктограмма <iconid_off>.

Внутри блока иконки, указывается само изображение: Установка DM (распределенный мониторинг)

       <node>noden1</node>
       <name>Local Image</name>

Одиночная установка сервера

       <name>Local Image</name>

Чтобы использовалась иконка по умолчанию для любого состояния, нода для этого состояния должна быть пропущена в блоке <selement>.

5.5.3 Подписи к элементам
  • <label> описываются подписи к элементам карты. Здесь могут использоваться макросы.
  • <label_location> используется для позиционирования подписи к элементам:
Значение Тип
-1использовать значение по умолчанию для карты
0снизу
1слева
2справа
3сверху
5.5.4 Позиционирование элемента

Тэги <x> и <y> используются для позиционирования элемента карты по координатам x и y.

5.5.5 Связи на карте

Пример:

     <link>
       <selementid1>100100000000399</selementid1>
       <selementid2>100100000000402</selementid2>
       <drawtype>0</drawtype>
       <color>00AA00</color>
       <linktriggers>
       </linktriggers>
     </link>

  • тэги <selemetid1> и <selementid2> используются для указания элементов карты, которые объединяет связь.
  • <drawtype> определяет стиль связи по умолчанию:
Значение Стиль
0линия
2жирная линия
3точечная линия
4пунктирная линия

* <color> указывает цвет связи по умолчанию;

  • <linktriggers> содержит информацию о индикаторах состояния связи.

Пример:

         <linktrigger>
           <triggerid>
             <node>aly_trunk</node>
             <host>Symmetra PX40 Clone2</host>
             <description>APC: Input Current (PHASE L3)</description>
             <expression>{Symmetra PX40 Clone2:upsPhaseInputCurrent.L3.last(0)}&lt;15 | {Symmetra PX40 Clone2:upsPhaseInputCurrent.L3.last(0)}&gt;18</expression>
           </triggerid>
           <drawtype>0</drawtype>
           <color>0</color>
         </linktrigger>

  • <triggerid> описывает какой триггер используется для индикации состояния связи. Связанный триггер ссылается так же как и триггер элемента карты;
  • <drawtype> и <color> используются для индикации того, как связь должна быть отрисована на карте, если этот триггер имеет наивысший уровень важности среди всех активных триггеров, присоединенных к этой связи.
5.5.6 Изображения
Экспорт/импорт изображений поддерживается в Zabbix начиная с версии 1.8.3

Эта функция дает возможность импорта и экспорта изображений, использованных в картах сети. Если экспортируемая карта сети использует какие-либо изображения, то они будут записаны в результирующий XML файл. Например, как будет выглядеть экспортированное изображение:

<images>
  <image>
    <name>Server (small)</name>
    <imagetype>1</imagetype>
    <encodedImage>iVBORw0KGgoAA...ErkJggg==</encodedImage>
  </image>
</images>
Значение для тэга <encodedImage> укорочено в этом примере

Используемые тэги:

  • <images> - корневой тэг для изображений
  • <image> - индивидуальный тэг изображения
  • <name> - имя изображения, уникальное
  • <imagetype> - тип изображения, где 1 ⇒ иконка, 2⇒ фоновое изображение
  • <encodedImage> - закодированное в base64 изображение

При импортировании, отсутствующие изображения могут быть добавлены и существующие изображения могут быть перезаписаны в зависимости от выбранных галочек. Импортирование изображений доступно только пользователем с типом Zabbix Super Admin.

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

Есть возможность импортировать только изображения, сняв обе галочки напротив “Карта сети”.