Konfigurations-Export/Import

Übersicht

Die Export-/Import-Funktionalität von Zabbix ermöglicht den Austausch verschiedener Konfigurationselemente zwischen einem Zabbix-System und einem anderen.

Typische Anwendungsfälle für diese Funktionalität:

  • Vorlagen oder Netzwerkkarten teilen - Zabbix-Benutzer können ihre Konfigurationsparameter weitergeben
  • eine Vorlage in Zabbix Community templates hochladen. Anschließend können andere die Vorlage herunterladen und die Datei in Zabbix importieren.
  • Integration mit Drittanbieter-Tools - universelle YAML-, XML- und JSON- Formate ermöglichen die Integration sowie den Datenimport/-export mit Drittanbieter- Tools und Anwendungen
Was kann exportiert/importiert werden

Objekte, die exportiert/importiert werden können, sind:

Exportformat

Daten können über das Zabbix-Frontend oder die Zabbix API exportiert werden. Unterstützte Exportformate sind YAML, XML und JSON.

Details zum Export

  • Alle unterstützten Elemente werden in einer Datei exportiert.
  • Host- und Vorlagen-Entitäten (Datenpunkte, Auslöser, Diagramme, Erkennungsregeln), die von verknüpften Vorlagen geerbt wurden, werden nicht exportiert. Alle Änderungen, die an diesen Entitäten auf Host-Ebene vorgenommen wurden (z. B. geändertes Datenpunkt-Intervall, geänderte reguläre Ausdrücke oder hinzugefügte Prototypen zur Low-Level-Erkennungsregel), gehen beim Export verloren; beim Import werden alle Entitäten aus verknüpften Vorlagen so neu erstellt wie in der ursprünglich verknüpften Vorlage.
  • Durch Low-Level-Erkennung erstellte Entitäten und alle von ihnen abhängigen Entitäten werden nicht exportiert. Beispielsweise wird ein Auslöser, der für einen von einer LLD-Regel generierten Datenpunkt erstellt wurde, nicht exportiert.
  • Wenn der exportierte Host/die exportierte Vorlage Entitäten enthält, die Timeouts unterstützen, werden die Timeout-Werte exportiert, sofern für diese Entitäten eigene Timeouts konfiguriert sind.

Details zum Import

  • Der Import wird beim ersten Fehler abgebrochen.
  • Beim Aktualisieren vorhandener Bilder während des Bildimports wird das Feld "imagetype" ignoriert, d. h. es ist nicht möglich, den Bildtyp per Import zu ändern.
  • Beim Import von Hosts/Vorlagen mit der Option "Fehlende löschen" werden Host-/Vorlagen-Makros, die in der Importdatei nicht vorhanden sind, nach dem Import vom Host/Vorlage gelöscht.
  • Leere Tags für Datenpunkte, Auslöser, Diagramme, discoveryRules, itemPrototypes, triggerPrototypes, graphPrototypes sind bedeutungslos, d. h. es ist dasselbe, als wären sie nicht vorhanden.
  • Wenn Entitäten des importierten Hosts/Vorlage eigene konfigurierte Timeouts haben, werden diese angewendet; andernfalls werden Proxy-/globale Timeouts angewendet.
  • Der Import unterstützt YAML, XML und JSON. Die Importdatei muss die korrekte Dateiendung haben: .yaml und .yml für YAML, .xml für XML und .json für JSON. Siehe Kompatibilitätsinformationen zu den unterstützten XML-Versionen.
  • Der Import unterstützt Konfigurationsdateien nur in UTF-8-Kodierung (mit oder ohne BOM); andere Kodierungen (UTF16LE, UTF16BE, UTF32LE, UTF32BE usw.) führen zu einem Fehler bei der Importkonvertierung.

YAML-Basisformat

Das YAML-Exportformat enthält die folgenden Knoten:

  • Wurzelknoten für den Zabbix-YAML-Export
  • Exportversion
zabbix_export:
  version: '8.0'

Weitere Knoten hängen von den exportierten Objekten ab.

XML-Format

Das XML-Exportformat enthält die folgenden Tags:

  • Standard-Header für XML-Dokumente
  • Root-Tag für den Zabbix-XML-Export
  • Exportversion
<?xml version="1.0" encoding="UTF-8"?>
<zabbix_export>
    <version>8.0</version>
</zabbix_export>

Andere Tags hängen von den exportierten Objekten ab.

JSON-Format

Das JSON-Exportformat enthält die folgenden Objekte:

  • Wurzelobjekt für den Zabbix-JSON-Export
  • Exportversion
{
    "zabbix_export": {
        "version": "8.0"
    }
}

Andere Objekte sind von den exportierten Objekten abhängig.