On this page
12 Eksport/import konfiguracji
Przegląd
Funkcjonalność eksportu/importu w Zabbix umożliwia wymianę różnych elementów konfiguracji między jednym systemem Zabbix a drugim.
Typowe przypadki użycia tej funkcjonalności:
- udostępnianie szablonów lub map sieciowych — użytkownicy Zabbix mogą udostępniać swoje parametry konfiguracji
- przesyłanie szablonu do Zabbix Community templates. Następnie inni mogą pobrać szablon i zaimportować plik do Zabbix.
- integracja z narzędziami innych firm — uniwersalne formaty YAML, XML i JSON umożliwiają integrację oraz import/eksport danych za pomocą narzędzi i aplikacji innych firm
Co można eksportować/importować
Obiekty, które można eksportować/importować to:
- Grupy hostów (tylko przez Zabbix API)
- Grupy szablonów (tylko przez Zabbix API)
- Szablony
- Hosty
- Mapy sieci
- Typy mediów
- Obrazy
Format eksportu
Dane można eksportować za pomocą interfejsu użytkowania Zabbix lub Zabbix API. Obsługiwane formaty eksportu to YAML, XML i JSON.
Szczegóły eksportu
- Wszystkie obsługiwane elementy są eksportowane do jednego pliku.
- Encje hosta i szablonu (pozycje, wyzwalacze, wykresy, reguły wykrywania), które są dziedziczone z podłączonych szablonów, nie są eksportowane. Wszelkie zmiany wprowadzone w tych encjach na poziomie hosta (takie jak zmieniony interwał pozycji, zmodyfikowane wyrażenie regularne lub dodane prototypy do reguły wykrywania niskiego poziomu) zostaną utracone podczas eksportu; podczas importu wszystkie encje z podłączonych szablonów są odtwarzane tak jak w oryginalnym podłączonym szablonie.
- Encje utworzone przez wykrywanie niskiego poziomu oraz wszelkie encje od nich zależne nie są eksportowane. Na przykład wyzwalacz utworzony dla pozycji wygenerowanej przez regułę LLD nie zostanie wyeksportowany.
- Jeśli eksportowany host/szablon zawiera encje obsługujące limity czasu, wartości limitu czasu zostaną wyeksportowane, jeśli dla tych encji skonfigurowano własne limity czasu.
Szczegóły dotyczące importu
- Import zatrzymuje się przy pierwszym błędzie.
- Podczas aktualizacji istniejących obrazów w trakcie importu obrazów pole "imagetype" jest ignorowane, tj. nie można zmienić typu obrazu za pomocą importu.
- Podczas importowania hostów/szablonów z użyciem opcji "Delete missing"
makra hosta/szablonu, które nie są obecne w pliku importu, zostaną usunięte z
hosta/szablonu po imporcie. - Puste tagi dla pozycji, wyzwalaczy, wykresów, discoveryRules, itemPrototypes, triggerPrototypes, graphPrototypes nie mają znaczenia, tj. to tak, jakby ich brakowało.
- Jeśli encje importowanego hosta/szablonu mają skonfigurowane własne limity czasu, zostaną one zastosowane; w przeciwnym razie zostaną zastosowane limity czasu proxy/globalne.
- Import obsługuje YAML, XML i JSON, a plik importu musi mieć poprawne rozszerzenie pliku: .yaml i .yml dla YAML, .xml dla XML oraz .json dla JSON. Zobacz informacje o kompatybilności dotyczące obsługiwanych wersji XML.
- Import obsługuje pliki konfiguracyjne wyłącznie w kodowaniu UTF-8 (z BOM lub bez); inne kodowania (UTF16LE, UTF16BE, UTF32LE, UTF32BE itd.) spowodują błąd konwersji podczas importu.
Podstawowy format YAML
Format eksportu YAML zawiera następujące węzły:
- Węzeł główny eksportu Zabbix YAML
- Wersja eksportu
zabbix_export:
version: '8.0'
Pozostałe węzły zależą od eksportowanych obiektów.
Format XML
Format eksportu XML zawiera następujące tagi:
- Domyślny nagłówek dla dokumentów XML
- Główny tag dla eksportu XML Zabbix
- Wersja eksportu
<?xml version="1.0" encoding="UTF-8"?>
<zabbix_export>
<version>8.0</version>
</zabbix_export>
Pozostałe tagi zależą od eksportowanych obiektów.
Format JSON
Format eksportu JSON zawiera następujące obiekty:
- Obiekt główny eksportu JSON Zabbix
- Wersja eksportu
{
"zabbix_export": {
"version": "8.0"
}
}
Pozostałe obiekty zależą od eksportowanych obiektów.