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

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

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

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

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

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

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

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

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

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

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

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

zabbix_export:
version: "1.0"
date: "2024-03-01T06:20:11Z"

где:

zabbix_export – корневой элемент при экспорте YAML;
version: "1.0" – версия экспорта;
date: "2024-03-01T06:20:11Z" – дата, когда был выполнен экспорт, в формате "ISO 8601 long".

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

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

<?xml version="1.0" encoding="UTF-8"?>
<zabbix_export>
<version>1.0</version>
<date>2024-03-01T06:20:11Z</date>
</zabbix_export>

где:

<?xml version="1.0" encoding="UTF-8"?> – заголовок по умолчанию для XML документов;
<zabbix_export> – корневой элемент при экспорте XML;
1.0 – версия экспорта;
<date>2024-03-01T06:20:11Z</date> – дата, когда был выполнен экспорт, в формате "ISO 8601 long".

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

Формат JSON:

{
"zabbix_export": {
"version": "1.0",
"date": "2024-03-01T06:20:11Z"
}
}

где:

"zabbix_export" – корневой элемент при экспорте JSON;
"version": "1.0" – версия экспорта;
"date": "2024-03-01T06:20:11Z" – дата, когда был выполнен экспорт, в формате "ISO 8601 long".

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