Exportación/importación de configuración

Descripción general

La funcionalidad de exportación/importación de Zabbix permite intercambiar diversas entidades de configuración entre un sistema Zabbix y otro.

Casos de uso típicos de esta funcionalidad:

  • compartir templates o mapas de red: los usuarios de Zabbix pueden compartir sus parámetros de configuración
  • cargar un template en Zabbix Community templates. Luego, otros pueden descargar el template e importar el archivo en Zabbix.
  • integrarse con herramientas de terceros: los formatos universales YAML, XML y JSON hacen posible la integración y la importación/exportación de datos con herramientas y aplicaciones de terceros
Qué se puede exportar/importar

Los objetos que se pueden exportar/importar son:

Formato de exportación

Los datos se pueden exportar usando el frontend web de Zabbix o Zabbix API. Los formatos de exportación compatibles son YAML, XML y JSON.

Detalles sobre la exportación

  • Todos los elementos compatibles se exportan en un solo archivo.
  • Las entidades de host y template (items, triggers, gráficos, reglas de descubrimiento) que se heredan de templates vinculadas no se exportan. Cualquier cambio realizado en esas entidades a nivel de host (como un intervalo de item modificado, una expresión regular modificada o prototipos añadidos a la regla de descubrimiento de bajo nivel) se perderá al exportar; al importar, todas las entidades de las templates vinculadas se recrean tal como en la template vinculada original.
  • Las entidades creadas por el descubrimiento de bajo nivel y cualquier entidad que dependa de ellas no se exportan. Por ejemplo, un trigger creado para un item generado por una regla LLD no se exportará.
  • Cuando el host/template exportado contiene entidades que admiten timeouts, los valores de timeout se exportarán si estas entidades tienen sus propios timeouts configurados.

Detalles sobre la importación

  • La importación se detiene ante el primer error.
  • Al actualizar imágenes existentes durante la importación de imágenes, el campo "imagetype" se ignora; es decir, no es posible cambiar el tipo de imagen mediante la importación.
  • Al importar hosts/templates usando la opción "Delete missing", las macros de host/template que no estén presentes en el archivo de importación se eliminarán del host/template después de la importación.
  • Las etiquetas vacías para items, triggers, graphs, discoveryRules, itemPrototypes, triggerPrototypes, graphPrototypes no tienen significado; es decir, es lo mismo que si faltaran.
  • Si las entidades del host/template importado tienen sus propios timeouts configurados, se aplicarán; de lo contrario, se aplicarán los timeouts de proxy/global.
  • La importación admite YAML, XML y JSON; el archivo de importación debe tener una extensión de archivo correcta: .yaml y .yml para YAML, .xml para XML y .json para JSON. Consulte la información de compatibilidad sobre las versiones XML admitidas.
  • La importación solo admite archivos de configuración en codificación UTF-8 (con o sin BOM); otras codificaciones (UTF16LE, UTF16BE, UTF32LE, UTF32BE, etc.) darán como resultado un error de conversión de importación.

Formato base de YAML

El formato de exportación YAML contiene los siguientes nodos:

  • Nodo raíz para la exportación YAML de Zabbix
  • Versión de exportación
zabbix_export:
  version: '8.0'

Los demás nodos dependen de los objetos exportados.

Formato XML

El formato de exportación XML contiene las siguientes etiquetas:

  • Encabezado predeterminado para documentos XML
  • Etiqueta raíz para la exportación XML de Zabbix
  • Versión de exportación
<?xml version="1.0" encoding="UTF-8"?>
<zabbix_export>
    <version>8.0</version>
</zabbix_export>

Las demás etiquetas dependen de los objetos exportados.

Formato JSON

El formato de exportación JSON contiene los siguientes objetos:

  • Objeto raíz para la exportación JSON de Zabbix
  • Versión de exportación
{
    "zabbix_export": {
        "version": "8.0"
    }
}

Los demás objetos dependen de los objetos exportados.