12 Konfigurācijas eksportēšana/importēšana

Pārskats

Zabbix eksporta/importa funkcionalitāte ļauj apmainīties ar dažādām konfigurācijas entītijām starp vienu Zabbix sistēmu un citu.

Tipiski šīs funkcionalitātes lietošanas gadījumi:

  • koplietot veidnes vai tīkla kartes — Zabbix lietotāji var koplietot savus konfigurācijas parametrus
  • augšupielādēt veidni uz Zabbix Community templates. Pēc tam citi var lejupielādēt veidni un importēt failu Zabbix.
  • integrēties ar trešo pušu rīkiem — universālie YAML, XML un JSON formāti nodrošina integrāciju un datu importu/eksportu ar trešo pušu rīkiem un lietotnēm
Ko var eksportēt/importēt

Objekti, kurus var eksportēt/importēt, ir:

Eksporta formāts

Datus var eksportēt, izmantojot Zabbix lietotāja saskarni vai Zabbix API. Atbalstītie eksporta formāti ir YAML, XML un JSON.

Informācija par eksportēšanu

  • Visi atbalstītie elementi tiek eksportēti vienā failā.
  • No saistītajām veidnēm mantotās hostu un veidņu entītijas (vienumi, trigeri, grafiki, atklāšanas kārtulas) netiek eksportētas. Visas izmaiņas, kas veiktas šajās entītijās hosta līmenī (piemēram, mainīts vienuma intervāls, modificēta regulārā izteiksme vai zema līmeņa atklāšanas kārtulai pievienoti prototipi), eksportēšanas laikā tiks zaudētas; importēšanas laikā visas entītijas no saistītajām veidnēm tiek izveidotas no jauna tāpat kā sākotnējā saistītajā veidnē.
  • Zema līmeņa atklāšanas izveidotās entītijas un visas no tām atkarīgās entītijas netiek eksportētas. Piemēram, trigeris, kas izveidots vienumam, kuru ģenerējusi ZLA kārtula, netiks eksportēts.
  • Ja eksportētais hosts/veidne satur entītijas, kas atbalsta noildzes, noildzes vērtības tiks eksportētas, ja šīm entītijām ir konfigurētas savas noildzes.

Informācija par importēšanu

  • Importēšana tiek pārtraukta pie pirmās kļūdas.
  • Atjauninot esošos attēlus attēlu importēšanas laikā, lauks "imagetype" tiek ignorēts, t.i., attēla tipu nav iespējams mainīt, izmantojot importēšanu.
  • Importējot hosts/veidnes, izmantojot opciju "Delete missing", hosts/veidnes makrosi, kas nav iekļauti importēšanas failā, pēc importēšanas tiks dzēsti no
    hosts/veidnes.
  • Tukšas birkas vienumiem, trigeriem, grafikiem, discoveryRules, itemPrototypes, triggerPrototypes, graphPrototypes ir bezjēdzīgas, t.i., tas ir tas pats, it kā tās nebūtu norādītas.
  • Ja importētā hosts/veidnes entītijām ir konfigurēti savi noildzes laiki, tie tiks piemēroti; pretējā gadījumā tiks piemēroti starpniekservera/globālie noildzes laiki.
  • Importēšana atbalsta YAML, XML un JSON; importēšanas failam jābūt ar pareizu faila paplašinājumu: .yaml un .yml YAML failiem, .xml XML failiem un .json JSON failiem. Skatiet saderības informāciju par atbalstītajām XML versijām.
  • Importēšana atbalsta tikai konfigurācijas failus UTF-8 kodējumā (ar vai bez BOM); citi kodējumi (UTF16LE, UTF16BE, UTF32LE, UTF32BE u.c.) izraisīs importēšanas konvertēšanas kļūdu.

YAML pamatformāts

YAML eksporta formāts satur šādus mezglus:

  • Saknes mezgls Zabbix YAML eksportam
  • Eksporta versija
zabbix_export:
  version: '8.0'

Pārējie mezgli ir atkarīgi no eksportētajiem objektiem.

XML formāts

XML eksporta formāts satur šādus tagus:

  • Noklusējuma galveni XML dokumentiem
  • Saknes tagu Zabbix XML eksportam
  • Eksporta versiju
<?xml version="1.0" encoding="UTF-8"?>
<zabbix_export>
    <version>8.0</version>
</zabbix_export>

Pārējie tagi ir atkarīgi no eksportētajiem objektiem.

JSON formāts

JSON eksporta formāts satur šādus objektus:

  • Zabbix JSON eksporta saknes objekts
  • Eksporta versija
{
    "zabbix_export": {
        "version": "8.0"
    }
}

Pārējie objekti ir atkarīgi no eksportētajiem objektiem.