Se encuentra viendo la documentación de la versión en desarrollo, puede estar incompleta.
Esta página fue traducida automáticamente. Si detectas un error, selecciónalo y presiona Ctrl+Enter para informarlo a los editores.

14 Exportación/importación de configuración

Descripción general

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

Casos de uso típicos para esta funcionalidad:

  • compartir plantillas o mapas de red: los usuarios de Zabbix pueden compartir sus parámetros de configuración
  • cargar una plantilla en Zabbix Community templates. Luego otros pueden descargar la plantilla 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 pueden exportarse utilizando la interfaz web de Zabbix o la API de Zabbix. Los formatos de exportación admitidos son YAML, XML y JSON.

Detalles sobre la exportación

  • Todos los elementos soportados se exportan en un solo archivo.
  • Las entidades de equipos y plantillas (métricas, disparadores, gráficos, reglas de descubrimiento) que se heredan de plantillas enlazadas no se exportan. Cualquier cambio realizado en esas entidades a nivel de equipo (como el intervalo de la métrica cambiado, la expresión regular modificada o los prototipos añadidos a la regla de descubrimiento de bajo nivel) se perderá al exportar; al importar, todas las entidades de las plantillas enlazadas se recrean como en la plantilla enlazada original.
  • Las entidades creadas por descubrimiento de bajo nivel y cualquier entidad que dependa de ellas no se exportan. Por ejemplo, un disparador creado para una métrica generada por una regla LLD no se exportará.
  • Cuando el equipo/plantilla exportado contiene entidades que soportan 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 en 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 equipos/plantillas utilizando la opción "Eliminar los que faltan", las macros de equipo/plantilla que no estén presentes en el archivo de importación se eliminarán del equipo/plantilla después de la importación.
  • Las etiquetas vacías para métricas, disparadores, gráficos, discoveryRules, itemPrototypes, triggerPrototypes, graphPrototypes no tienen sentido, es decir, es lo mismo que si faltaran.
  • Si las entidades del equipo/plantilla importado tienen sus propios timeouts configurados, se aplicarán; de lo contrario, se aplicarán los timeouts del proxy/globales.
  • 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 de XML compatibles.
  • 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.) resultarán en 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 la exportación YAML de Zabbix
  • Versión de exportación
zabbix_export:
         version: '8.0'

Otros nodos dependen de los objetos exportados.

Formato XML

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

  • Encabezado por defecto 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>

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
{
           "zabbix_export": {
               "version": "8.0"
           }
       }

Otros objetos dependen de los objetos exportados.