On this page
12 Esportazione/importazione della configurazione
Panoramica
La funzionalità di esportazione/importazione di Zabbix consente di scambiare varie entità di configurazione tra un sistema Zabbix e un altro.
Casi d'uso tipici di questa funzionalità:
- condividere template o mappe di rete: gli utenti Zabbix possono condividere i propri parametri di configurazione
- caricare un template in Zabbix Community templates. In seguito, altri utenti possono scaricare il template e importare il file in Zabbix.
- integrazione con strumenti di terze parti: i formati universali YAML, XML e JSON rendono possibile l'integrazione e l'importazione/esportazione dei dati con strumenti e applicazioni di terze parti
Cosa può essere esportato/importato
Gli oggetti che possono essere esportati/importati sono:
- Gruppi di host (solo tramite Zabbix API)
- Gruppi di template (solo tramite Zabbix API)
- Template
- Host
- Mappe di rete
- Tipi di supporto
- Immagini
Formati di sportazione
I dati possono essere esportati utilizzando il frontend web Zabbix o Zabbix API. i Formati di Esportazione supportati sono YAML, XML and JSON.
Dettagli sull'esportazione
- Tutti gli elementi supportati vengono esportati in un unico file.
- Le entità di host e template (item, trigger, grafici, regole di individuazione) ereditate dai template collegati non vengono esportate. Eventuali modifiche apportate a tali entità a livello di host (come l'intervallo dell'item modificato, l'espressione regolare modificata o i prototipi aggiunti alla regola di low-level discovery) andranno perse durante l'esportazione; durante l'importazione, tutte le entità dei template collegati vengono ricreate come nel template collegato originale.
- Le entità create dalla low-level discovery e tutte le entità che dipendono da esse non vengono esportate. Ad esempio, un trigger creato per un item generato da una regola LLD non verrà esportato.
- Quando l'host/template esportato contiene entità che supportano i timeout, i valori di timeout verranno esportati se per tali entità sono configurati timeout propri.
Dettagli sull'importazione
- L'importazione si interrompe al primo errore.
- Durante l'aggiornamento di immagini esistenti nell'importazione delle immagini, il campo "imagetype" viene ignorato, cioè non è possibile modificare il tipo di immagine tramite importazione.
- Quando si importano host/template utilizzando l'opzione "Delete missing",
le macro di host/template non presenti nel file di importazione verranno eliminate da
host/template dopo l'importazione. - I tag vuoti per item, trigger, graph, discoveryRules, itemPrototypes, triggerPrototypes, graphPrototypes non hanno significato, cioè è come se fossero assenti.
- Se le entità dell'host/template importato hanno timeout propri configurati, questi verranno applicati; in caso contrario, verranno applicati i timeout del proxy/globali.
- L'importazione supporta YAML, XML e JSON; il file di importazione deve avere una corretta estensione del file: .yaml e .yml per YAML, .xml per XML e .json per JSON. Vedere le informazioni sulla compatibilità relative alle versioni XML supportate.
- L'importazione supporta file di configurazione solo con codifica UTF-8 (con o senza BOM); altre codifiche (UTF16LE, UTF16BE, UTF32LE, UTF32BE, ecc.) comporteranno un errore di conversione durante l'importazione.
Formato YAML di base
Il formato di esportazione YAML contiene i seguenti nodi:
- Nodo radice per l'esportazione YAML di Zabbix
- Versione di esportazione
zabbix_export:
version: '8.0'
Gli altri nodi dipendono dagli oggetti esportati.
Formato XML
Il formato di esportazione XML contiene i seguenti tag:
- Intestazione predefinita per i documenti XML
- Tag radice per l'esportazione XML di Zabbix
- Versione di esportazione
<?xml version="1.0" encoding="UTF-8"?>
<zabbix_export>
<version>8.0</version>
</zabbix_export>
Gli altri tag dipendono dagli oggetti esportati.
Formato JSON
Il formato di esportazione JSON contiene i seguenti oggetti:
- Oggetto radice per l'esportazione JSON di Zabbix
- Versione dell'esportazione
{
"zabbix_export": {
"version": "8.0"
}
}
Gli altri oggetti dipendono dagli oggetti esportati.