Экспорт/импорт конфигурации

Обзор

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

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

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

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

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

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

Подробности об экспорте

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

Сведения об импорте

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

Базовый формат YAML

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

  • Корневой узел для экспорта Zabbix в YAML
  • Версия экспорта
zabbix_export:
  version: '8.0'

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

XML-формат

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

  • Стандартный заголовок для XML-документов
  • Корневой тег для XML-экспорта Zabbix
  • Версия экспорта
<?xml version="1.0" encoding="UTF-8"?>
<zabbix_export>
    <version>8.0</version>
</zabbix_export>

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

Формат JSON

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

  • Корневой объект для экспорта Zabbix JSON
  • Версия экспорта
{
    "zabbix_export": {
        "version": "8.0"
    }
}

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