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:

• grupos de equipos (solo a través de la API de Zabbix)
• plantillas
• equipos
• mapas de red
• tipos de medio
• Imágenes

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 al 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 una importación.
• Al importar equipos/plantillas usando la opción de "Eliminar ausentes" ("Delete missing"), se borrarán también las macros del equipo/plantilla que no estén presentes en el fichero de importación.
• Las etiquetas vacías para métricas, iniciadores, gráficos, aplicaciones de equipo/plantilla, reglas de descubrimiento, prototipos de métrica, prototipos de iniciador y prototipos de gráfico no significan nada, es decir, es lo mismo que si no estuvieran. Otras etiquetas, por ejemplo, las aplicaciones de un monitor, tienen significado, es decir, en este caso las etiquetas vacías significan que no hay aplicaciones para ese monitor, la ausencia de etiquetas significa no actualizar aplicaciones.
• La importación soporta YAML, XML y JSON, el fichero de importación debe tener una extensión correcta: .yaml y .yml para YAML, .xml para XML y .json para JSON. Vea información de compatibilidad sobre las versiones soportadas de XML.
• 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.) provocarán un error de conversión en la importación.

Formato base de YAML

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

• Nodo raíz para exportación Zabbix YAML
• Versión de la exportación

zabbix_export:
         version: '6.4'

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 Zabbix XML
• Versión de la exportación

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

Otras etiquetas dependen de los objetos exportados.

Formato JSON

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

• Objeto raíz para exportación Zabbix JSON
• Versión de la exportación

{
       "zabbix_export": {
       "version": "6.4"
       }
       }

Otros nodos dependen de los objetos exportados.