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
• Compartir escenarios web en share.zabbix.com - Exportar una plantilla con los escenarios web y subirla a share.zabbix.com. Luego, otros pueden descargar la plantilla e importar el fichero en 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 y aplicaciones de terceros

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 monitores, iniciadores, gráficos, aplicaciones de equipo/plantilla, reglas de descubrimiento, prototipos de monitor, 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.

Formato base de YAML

zabbix_export:
         version: '6.0'
         date: '2020-04-22T06:20:11Z'

zabbix_export:

Nodo raíz para la exportación YAML.

version: '6.0'

Version de la exportación.

date: '2020-04-22T06:20:11Z'

Fecha en la que se creó en formato largo ISO 8601.

Los otros nodos dependen de los objetos exportados.

Formato XML

<?xml version="1.0" encoding="UTF-8"?>
       <zabbix_export>
           <version>6.0</version>
           <date>2020-04-22T06:20:11Z</date>
       </zabbix_export>

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

Cabecera por defecto para los documentos XML.

<zabbix_export>

Elemento raíz para las exportaciones de Zabbix XML.

<version>6.0</version>

Versión de la exportación.

<date>2020-04-22T06:20:11Z</date>

Fecha en la que se creó la exportación en formato largo ISO 8601.

Las otras etiquetas dependen de los objetos exportados.

Formato JSON

{
           "zabbix_export": {
               "version": "6.0",
               "date": "2020-04-22T06:20:11Z"
           }
       }

  "zabbix_export":

Nodo raíz para la exportación JSON de Zabbix.

      "version": "6.0"

Versión de la exportación.

      "date": "2020-04-22T06:20:11Z"

Fecha en la que la exportación fue creada en formato largo ISO 8601.

Los otros nodos dependen de los objetos exportados.