En esta página
Exportación/importación de configuración
Descripción general
La funcionalidad de exportación/importación de Zabbix permite intercambiar diversas entidades de configuración entre un sistema Zabbix y otro.
Casos de uso típicos de esta funcionalidad:
- compartir templates o mapas de red: los usuarios de Zabbix pueden compartir sus parámetros de configuración
- cargar un template en Zabbix Community templates. Luego, otros pueden descargar el template 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:
- Grupos de host (solo a través de la API de Zabbix)
- Grupos de template (solo a través de la API de Zabbix)
- Templates
- Hosts
- Mapas de red
- Tipos de medio
- Imágenes
Formato de exportación
Los datos se pueden exportar usando el frontend web de Zabbix o Zabbix API. Los formatos de exportación compatibles son YAML, XML y JSON.
Detalles sobre la exportación
- Todos los elementos compatibles se exportan en un solo archivo.
- Las entidades de host y template (items, triggers, gráficos, reglas de descubrimiento) que se heredan de templates vinculadas no se exportan. Cualquier cambio realizado en esas entidades a nivel de host (como un intervalo de item modificado, una expresión regular modificada o prototipos añadidos a la regla de descubrimiento de bajo nivel) se perderá al exportar; al importar, todas las entidades de las templates vinculadas se recrean tal como en la template vinculada original.
- Las entidades creadas por el descubrimiento de bajo nivel y cualquier entidad que dependa de ellas no se exportan. Por ejemplo, un trigger creado para un item generado por una regla LLD no se exportará.
- Cuando el host/template exportado contiene entidades que admiten timeouts, los valores de timeout se exportarán si estas entidades tienen sus propios timeouts configurados.
Detalles sobre la importación
- La importación se detiene ante 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 hosts/templates usando la opción "Delete missing", las macros de host/template que no estén presentes en el archivo de importación se eliminarán del host/template después de la importación.
- Las etiquetas vacías para items, triggers, graphs, discoveryRules, itemPrototypes, triggerPrototypes, graphPrototypes no tienen significado; es decir, es lo mismo que si faltaran.
- Si las entidades del host/template importado tienen sus propios timeouts configurados, se aplicarán; de lo contrario, se aplicarán los timeouts de proxy/global.
- 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 XML admitidas.
- 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.) darán como resultado un error de conversión de importación.
Formato base de 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'
Los demás 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 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>
Las demás 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"
}
}
Los demás objetos dependen de los objetos exportados.