13. Экспорт/импорт настроек

Обзор

Функциональность эспорта/импорта настроек в Zabbix делает возможным выполнять обмен объектами конфигурации между одной Zabbix системой и другой.

Типичные случаи применения этой функционала:

  • обмен шаблонами и картами сети - Zabbix пользователи могут опубликовывать их параметры конфигурации
  • обмен веб-сценариями на share.zabbix.com - эскпортируйте шаблон с веб-сценариями и загрузите его на share.zabbix.com. Другие люди могут загрузить этот шаблон себе и импортировать XML в Zabbix.
  • интеграция с прикладными инструментами - универсальный XML формат делает возможным интеграцию и импорт/экспорт данных в прикладные инструменты и приложения.
Что можно импортировать/экспортировать

Объекты, которые можно импортировать/экспортировать:

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

Данные можно экспортировать при помощи веб-интерфейса Zabbix или Zabbix API. Поддерживаемые форматы экспорта:

  • XML - в веб-интерфейсе Zabbix
  • XML или JSON - в Zabbix API

Дополнительная информация о экспорте

  • Все поддерживаемые элементы экспортируются в один файл.
  • Объекты на узлах сети и в шаблонах (элементы данных, триггеры, графики, правила обнаружения), которые унаследованы из шаблонов не экспортируются. Любые изменения выполненные над этими объектами на уровне узла сети (такие как, изменен интервал обновления, изменено регулярное выражение или добавлены прототипы к низкоуровневому правилу обнаружения) при экспорте будут потеряны; при импорте все объекты из присоединенных шаблонов пересоздаются, такими как они есть в присоединенном шаблоне.
  • Созданные низкоуровневым обнаружением элементы и любые объекты, которые связаны с ними, не экспортируются. Например, если триггер создан для элемента данных, сгенерированного правилом обнаружения, то такой триггер не будет экспортирован.

Дополнительная информация об импорте

  • Импорт останавливается при первой же ошибке.
  • При обновлении существующих изображений в процессе импорта изображения, поле "imagetype" игнорируется, т.е. невозможно изменить тип изображения с помощью функции импорта.
  • При импорте узлов сети/шаблонов, при использовании опции "Удалить отсутствующие", макросы узла сети/шаблона, которых нет в импортируемом XML файле будут также удалены.
  • Пустые теги элементов данных, триггеров, графиков, групп элементов данных узлов сети/шаблонов, правил обнаружения, прототипов элементов данных, прототипов триггеров, прототипов графиков бессмысленны, т.к. они имеют такой же смысл, как если бы были не указаны вовсе. Другие теги, например группы элементов данных, имеют смысл, например, пустой тег означает отсутствие группы элементов данных у элемента данных, пропущенный тег означает запрет обновления групп элементов данных.
  • Импорт поддерживает как XML, так и JSON, импортируемый файл должен иметь корректное расширение файла: .xml для XML и .json для JSON
  • Смотрите информацию о совместимости по поводу поддерживаемых версий XML.

Общий формат XML

<?xml version="1.0" encoding="UTF-8"?>
       <zabbix_export>
           <version>4.0</version>
           <date>2016-10-04T06:20:11Z</date>
       </zabbix_export>
<?xml version="1.0" encoding="UTF-8"?>

Заголовок XML документов по умолчанию.

<zabbix_export>

Корневой элемент при экспорте Zabbix XML.

<version>4.0</version>

Версия экспорта.

<date>2016-10-04T06:20:11Z</date>

Дата, когда был выполнен экспорт, в формате ISO 8601 long.

Остальные теги зависят от экспортируемых объектов.

XML format

<?xml version="1.0" encoding="UTF-8"?>
       <zabbix_export>
           <version>5.4</version>
           <date>2020-04-22T06:20:11Z</date>
       </zabbix_export>
<?xml version="1.0" encoding="UTF-8"?>

Default header for XML documents.

<zabbix_export>

Root element for Zabbix XML export.

<version>5.4</version>

Export version.

<date>2020-04-22T06:20:11Z</date>

Date when export was created in ISO 8601 long format.

Other tags are dependent on exported objects.

JSON format

{
           "zabbix_export": {
               "version": "5.4",
               "date": "2020-04-22T06:20:11Z"
           }
       }
  "zabbix_export":

Root node for Zabbix JSON export.

      "version": "5.4"

Export version.

      "date": "2020-04-22T06:20:11Z"

Date when export was created in ISO 8601 long format.

Other nodes are dependent on exported objects.