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

Pārskats

Zabbix eksportēšanas/importēšanas funkcionalitāte ļauj apmainīties ar dažādiem konfigurācijas objektiem 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 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 padara iespējamu integrāciju un datu importēšanu/eksportēšanu ar trešo pušu rīkiem un lietojumprogrammā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ā.
  • Hosts un veidnes entītijas (vienumi, trigeri, grafiki, atklāšanas noteikumi), kas ir mantotas no saistītajām veidnēm, netiek eksportētas. Jebkādas izmaiņas, kas veiktas šīm entītijām hosta līmenī (piemēram, mainīts vienuma intervāls, modificēta regulārā izteiksme vai pievienoti prototipi zemā līmeņa atklāšanas noteikumam), eksportēšanas laikā tiks zaudētas; importēšanas laikā visas entītijas no saistītajām veidnēm tiek atkārtoti izveidotas tāpat kā sākotnējā saistītajā veidnē.
  • Entītijas, kas izveidotas ar zemā līmeņa atklāšanu, un jebkuras entītijas, kas no tām ir atkarīgas, netiek eksportētas. Piemēram, trigeris, kas izveidots vienumam, ko ģenerējis LLD noteikums, 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 apstājas pie pirmās kļūdas.
  • Atjauninot esošos attēlus attēlu importēšanas laikā, lauks "imagetype" tiek ignorēts, t. i., importēšanas laikā nav iespējams mainīt attēla tipu.
  • Importējot hosts/veidnes, izmantojot opciju "Delete missing", hosta/veidnes makro, kas nav iekļauti importēšanas failā, pēc importēšanas tiks dzēsti no hosta/veidnes.
  • Tukši tagi vienumiem, trigeriem, grafikiem, discoveryRules, itemPrototypes, triggerPrototypes, graphPrototypes nav nozīmīgi, t. i., tas ir tas pats, kas tad, ja tie būtu izlaisti.
  • Ja importētā hosta/veidnes entītijām ir konfigurēti savi noildzes laiki, tiks lietoti tie; pretējā gadījumā tiks lietoti starpniekservera/globalie noildzes laiki.
  • Importēšana atbalsta YAML, XML un JSON, importēšanas failam ir jābūt ar pareizu faila paplašinājumu: .yaml un .yml YAML formātam, .xml XML formātam un .json JSON formātam. Skatiet saderības informāciju par atbalstītajām XML versijām.
  • Importēšana atbalsta konfigurācijas failus tikai UTF-8 kodējumā (ar BOM vai bez tā); citi kodējumi (UTF16LE, UTF16BE, UTF32LE, UTF32BE u. c.) izraisīs importēšanas konvertēšanas kļūdu.

YAML pamata formā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 galvene XML dokumentiem
  • Saknes tags Zabbix XML eksportam
  • Eksporta versija
<?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:

  • Saknes objekts Zabbix JSON eksportam
  • Eksporta versija
{
    "zabbix_export": {
        "version": "8.0"
    }
}

Citi objekti ir atkarīgi no eksportētajiem objektiem.