14. Exportación e importación de configuración

Vista general

La funcionalidad de importación/exportación de Zabbix hace posible el intercambio de diversas entidades de configuración entre un sistema Zabbix y otro.

Casos de uso típico de esta funcionalidad:

  • Compartir plantillas o mapas de red - los usuarios de Zabbix pueden compartir sus ajustes de configuración
  • suba una plantilla a [plantillas de la comunidad Zabbix] (https://github.com/zabbix/community-templates). Entonces otros pueden descargar la plantilla e importar el archivo a Zabbix.
  • integrar 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 de terceros terceros y aplicaciones
Qué puede ser exportado/importado

Los objetos que pueden ser exportados/importados son:

Formato de exportación

Los datos pueden ser exportados usando el frontal web de Zabbix o la API de Zabbix. Los formatos de exportación soportados son YAML, XML y JSON.

Detalles sobre la exportación

  • Todos los elementos soportados son exportados en un único fichero.
  • Los equipos y las entidades de las plantillas (monitores, iniciadores, gráficos, reglas de descubrimiento) que son heredados de otras plantillas enlazadas no son exportados. Todos los cambios hechos a nivel de equipo en estas entidades (como intervalos de monitor cambiados, expresiones regulares modificadas o prototipos añadidos a la regla de descubrimiento a bajo nivel) se perderán al exportar; al importar, todas las entidades de plantillas enlazadas son recreadas según la plantilla enlazada original.
  • Las entidades creadas por un descubrimiento de bajo nivel, y cualquier entidad que dependa de ellas, no son exportadas. Por ejemplo, un iniciador creado sobre un monitor que ha sido generado por una regla LLD no será exportado.

Detalles sobre la importación

  • La importación se detiene en el primer error.
  • Al actualizar imágenes existentes durante la importación de imágenes, el campo "imagetype" se ignora, es decir, es imposible cambiar el tipo de imagen a través de la importación.
  • Al importar hosts/plantillas con la opción "Eliminar faltantes", las macros de host/plantilla que no estén presentes en el archivo de importación se eliminarán del host/plantilla después de la importación.
  • Las etiquetas vacías para métricas, iniciadores, gráficos, discoveryRules, itemPrototypes, triggerPrototypes, graphPrototypes no tienen sentido, es decir, es lo mismo que si faltaran.
  • 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 información de compatibilidad para obtener información sobre las versiones XML compatibles.
  • La importación admite archivos de configuración solo en codificación UTF-8 (con o sin BOM); otras codificaciones (UTF16LE, UTF16BE, UTF32LE, UTF32BE, etc.) generarán un error de conversión de importación.

Formato base YAML

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

  • Nodo raíz para exportación Zabbix YAML
  • Exportar versión
  • Fecha en que se creó la exportación en formato largo ISO 8601
zabbix_export:
         version: '6.0'
         date: '2020-04-22T06:20:11Z'

Otros 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 exportación XML de Zabbix
  • Versión de exportación
  • Fecha en la que se creó la exportación en formato largo ISO 8601
<?xml version="1.0" encoding="UTF-8"?>
       <zabbix_export>
           <version>6.0</version>
           <date>2020-04-22T06:20:11Z</date>
       </zabbix_export>

Las otras 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
  • Fecha en la que se creó la exportación en formato largo ISO 8601
{
           "zabbix_export": {
           "version": "6.0",
           "date": "2020-04-22T06:20:11Z"
           }
       }

Otros objetos dependen de los objetos exportados.