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

Обзор

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

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

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

Что можно импортировать / экспортировать

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

• группы узлов сети (только через Zabbix API)
• шаблоны
• узлы сети
• карты сети
• способы оповещения
• изображения

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

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

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

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

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

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

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

zabbix_export:
         version: '6.0'
         date: '2020-04-22T06:20:11Z'

zabbix_export:

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

version: '6.0'

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

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

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

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

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

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

<?xml version="1.0" encoding="UTF-8"?>

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

<zabbix_export>

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

<version>6.0</version>

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

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

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

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

Формат JSON

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

  "zabbix_export":

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

      "version": "6.0"

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

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

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

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