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

Обзор

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

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

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

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

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

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

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

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

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

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

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

Импорт прекращается при первой же ошибке.
При обновлении существующих изображений в процессе импорта изображения, поле "imagetype" игнорируется; т.е. невозможно изменить тип изображения с помощью функции импорта.
При импорте узлов сети / шаблонов с использованием опции "Удалить отсутствующие", макросы узла сети / шаблона, которых нет в импортируемом файле, будут также удалены с узла сети / шаблона после импорта.
Пустые теги элементов данных, триггеров, графиков, правил обнаружения, прототипов элементов данных, прототипов триггеров, прототипов графиков бессмысленны, т.к. они имеют такой же смысл, как если бы были не указаны вовсе.
Импорт поддерживает YAML, XML и JSON, импортируемый файл должен иметь корректное расширение файла: yaml и .yml для YAML, .xml для XML и .json для JSON. Смотрите информацию о совместимости касательно поддерживаемых версий XML.
Импорт поддерживает конфигурационные файлы только в кодировке UTF-8 (как с, так и без маркера последовательности байтов (BOM)); другие кодировки (UTF16LE, UTF16BE, UTF32LE, UTF32BE, etc.) приведут к ошибке конвертации при импорте.

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

Формат экспорта YAML содержит следующие элементы:

Корневой элемент для экспорта Zabbix YAML
Версия экспорта
Дата, когда был выполнен экспорт, в формате ISO 8601 long.

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

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

Формат XML

Формат экспорта XML содержит следующие теги:

Заголовок по умолчанию для XML документов
Корневой элемент при экспорте Zabbix XML
Версия экспорта
Дата, когда был выполнен экспорт, в формате ISO 8601 long

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

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

Формат JSON

Формат экспорта JSON содержит следующие объекты:

Корневой элемент при экспорте Zabbix JSON
Версия экспорта
Дата, когда был выполнен экспорт, в формате ISO 8601 long

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