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

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

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

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

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

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

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

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

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

Диалог импорта карты	Диалог импорта карты для суперадминистратора Zabbix, отображает опции импорта изображений (доступно начиная с версии 1.8.3)

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

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

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

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

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

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

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

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

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

 <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>

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

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

     <selement>
       <selementid>100100000000372</selementid>
       <elementid>
         <node>noden1</node>
         <host>LocalHost</host>
         <description>DOUBLE</description>
         <expression>{TimeHost:system.localtime[local].last(0)}=0 & {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>;

- Типы элементов и их сохранение

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

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

Установка 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)}<10000</expression>

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

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

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

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

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

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

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

       <name>Local Host Group</name>

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

• Ссылка на изображения

Узлы <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>.

- Подписи к элементам

• <label> описываются подписи к элементам карты. Здесь могут использоваться макросы.
• <label_location> используется для позиционирования подписи к элементам:

- Позиционирование элемента

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

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

Пример:

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

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

• <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)}<15 | {Symmetra PX40 Clone2:upsPhaseInputCurrent.L3.last(0)}>18</expression>
           </triggerid>
           <drawtype>0</drawtype>
           <color>0</color>
         </linktrigger>

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

- Изображения

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

<images>
  <image>
    <name>Server (small)</name>
    <imagetype>1</imagetype>
    <encodedImage>iVBORw0KGgoAA...ErkJggg==</encodedImage>
  </image>
</images>

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

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

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

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