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:

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.