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 compatibles se exportan en un solo archivo.
• Entidades de equipo y plantilla (métricas, iniciadores, gráficos, reglas de descubrimiento) que se heredan de plantillas vinculadas no se exportan. Cualquier cambio realizado en esas entidades a nivel de equipo (como cambios intervalo de métricas, modificación de expresión regular o prototipos agregados a la regla de descubrimiento de bajo nivel) se perderán al exportar; cuando se importe, todas las entidades de las plantillas vinculadas se recrearán como en la plantilla vinculada original.
• Las entidades creadas por descubrimiento de bajo nivel y cualquier entidad que dependa de ellas no se exportan. Por ejemplo, un iniciador creado para una métrica generada por la regla LLD no se exportará.
• Cuando el equipo/plantilla exportado contiene entidades que admiten tiempos de espera, los valores de tiempo de espera se exportarán si estas entidades tienen sus propios tiempos de espera configurados.

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, 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.
• Si las entidades del equipo/plantilla importadas tienen sus propios tiempos de espera configurados, se aplicarán; de lo contrario, se aplicarán tiempos de espera globales/proxy.
• 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: '7.0'

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>7.0</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": "7.0"
       }
       }

Otros nodos dependen de los objetos exportados.