On this page
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 su Zabbix Community templates. In seguito, altri possono scaricare il template e importare il file in Zabbix.
- integrarsi 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:
- Host groups (solo tramite Zabbix API)
- Template groups (solo tramite Zabbix API)
- Templates
- Hosts
- Network maps
- Media types
- Images
Formato di esportazione
I dati possono essere esportati tramite il frontend web di Zabbix o Zabbix API. I formati di esportazione supportati sono YAML, XML e 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 discovery) ereditate dai template collegati non vengono esportate. Eventuali modifiche apportate a tali entità a livello di host (ad esempio, intervallo dell'item modificato, espressione regolare modificata o prototipi aggiunti alla regola di discovery a basso livello) 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 discovery a basso livello 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 tali entità hanno timeout propri configurati.
Dettagli sull'importazione
- L'importazione si interrompe al primo errore.
- Durante l'aggiornamento delle 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 usando l'opzione "Delete missing", le macro di host/template non presenti nel file di importazione verranno eliminate dall'host/template dopo l'importazione.
- I tag vuoti per item, trigger, graph, discoveryRules, itemPrototypes, triggerPrototypes, graphPrototypes non hanno significato, cioè è come se fossero mancanti.
- Se le entità dell'host/template importato hanno timeout propri configurati, 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 un'estensione corretta: .yaml e .yml per YAML, .xml per XML e .json per JSON. Vedere le informazioni sulla compatibilità per le versioni XML supportate.
- L'importazione supporta i file di configurazione solo in codifica UTF-8 (con o senza BOM); altre codifiche (UTF16LE, UTF16BE, UTF32LE, UTF32BE, ecc.) comporteranno un errore di conversione dell'importazione.
Formato base YAML
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 di esportazione
{
"zabbix_export": {
"version": "8.0"
}
}
Gli altri oggetti dipendono dagli oggetti esportati.