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

Обзор

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

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

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

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

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

• Группы узлов сети (только через Zabbix API)
• Группы шаблонов (только через 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
• Версия экспорта

zabbix_export:
         version: '7.0'

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

Формат XML

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

• Заголовок по умолчанию для XML документов
• Корневой элемент при экспорте Zabbix XML
• Версия экспорта

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

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

Формат JSON

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

• Корневой элемент при экспорте Zabbix JSON
• Версия экспорта

{
           "zabbix_export": {
               "version": "7.0",
           }
       }

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