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:

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.