3 Zema līmeņa atklāšana

Pārskats

Zema līmeņa atklāšana (LLD) nodrošina iespēju automātiski izveidot vienumus, trigerus un grafikus dažādām entītijām hostā. Piemēram, Zabbix var automātiski sākt uzraudzīt failu sistēmas vai tīkla saskarnes jūsu datorā, bez nepieciešamības manuāli izveidot vienumus katrai failu sistēmai vai tīkla saskarnei. LLD var arī izveidot hostus, piemēram, lai aizpildītu virtuālās mašīnas, kas atklātas hipervizorā, kā arī ligzdotās atklāšanas kārtulas, nodrošinot daudzlīmeņu atklāšanu. Papildus tam ir iespējams konfigurēt Zabbix tā, lai tas automātiski noņemtu nevajadzīgās entītijas, pamatojoties uz faktiskiem periodiski veiktās atklāšanas rezultātiem.

Lietotājs var definēt savus atklāšanas tipus, ja vien tie ievēro noteiktu JSON protokolu.

Atklāšanas procesa vispārējā arhitektūra ir šāda.

Vispirms lietotājs izveido atklāšanas kārtulu sadaļā Datu ievākšana > Veidnes, kolonnā Atklāšana. Atklāšanas kārtula sastāv no (1) vienuma, kas atklāj nepieciešamās entītijas (piemēram, failu sistēmas vai tīkla saskarnes), un (2) vienumu, trigeru un grafiku prototipiem, kas jāizveido, pamatojoties uz šī vienuma vērtību.

Vienums, kas atklāj nepieciešamās entītijas, ir līdzīgs parastam vienumam, kas redzams citur: serveris pieprasa Zabbix aģentam (vai jebkuram citam tipam, kas iestatīts šim vienumam) šī vienuma vērtību, un aģents atbild ar teksta vērtību. Atšķirība ir tāda, ka vērtībai, ko atgriež aģents, jāietver atklāto entītiju saraksts JSON formātā. Lai gan šī formāta detaļas ir svarīgas tikai pielāgotu atklāšanas pārbaužu izstrādātājiem, ir svarīgi zināt, ka atgrieztā vērtība satur makro → vērtība pāru sarakstu. Piemēram, vienums "net.if.discovery" var atgriezt divus pārus: "{#IFNAME}" → "lo" un "{#IFNAME}" → "eth0".

Šie makro tiek izmantoti nosaukumos, atslēgās un citos prototipu laukos, kur tie pēc tam tiek aizstāti ar saņemtajām vērtībām, lai katrai atklātajai entītijai izveidotu reālus vienumus, trigerus, grafikus vai pat hostus. Skatiet pilnu opciju sarakstu LLD makro izmantošanai.

Kad serveris saņem atklāšanas vienuma vērtību, tas aplūko makro → vērtība pārus un katram pārim ģenerē reālus vienumus, trigerus un grafikus, pamatojoties uz to prototipiem. Iepriekš minētajā piemērā ar "net.if.discovery" serveris ģenerētu vienu vienumu, trigeru un grafiku kopu cilpas saskarnei "lo" un citu kopu saskarnei "eth0".

Ņemiet vērā, ka kopš Zabbix 4.2 ir mainīts JSON formāts, ko atgriež zema līmeņa atklāšanas kārtulas. Vairs netiek sagaidīts, ka JSON saturēs objektu "data". Zema līmeņa atklāšana tagad pieņem parastu JSON, kas satur masīvu, lai atbalstītu jaunas iespējas, piemēram, vienuma vērtības priekšapstrādi un pielāgotus ceļus uz zema līmeņa atklāšanas makro vērtībām JSON dokumentā.

Iebūvētās atklāšanas atslēgas ir atjauninātas tā, lai tās atgrieztu LLD rindu masīvu JSON dokumenta saknē. Zabbix automātiski izgūs makro un vērtību, ja masīva lauks kā atslēgu izmanto sintaksi {#MACRO}. Jebkuras jaunas iebūvētās atklāšanas pārbaudes izmantos jauno sintaksi bez "data" elementiem. Apstrādājot zema līmeņa atklāšanas vērtību, vispirms tiek noteikta sakne (masīvs pie $. vai $.data).

Lai gan elements "data" ir noņemts no visiem ar atklāšanu saistītajiem iebūvētajiem vienumiem, atpakaļsaderības nolūkos Zabbix joprojām pieņems JSON pierakstu ar elementu "data", lai gan tā izmantošana nav ieteicama. Ja JSON satur objektu tikai ar vienu masīva elementu "data", tad tas automātiski izgūs šī elementa saturu, izmantojot JSONPath $.data. Zema līmeņa atklāšana tagad pieņem arī neobligātus lietotāja definētus LLD makro ar pielāgotu ceļu, kas norādīts JSONPath sintaksē.

Iepriekš minēto izmaiņu rezultātā jaunāki aģenti vairs nevarēs darboties ar vecāku Zabbix serveri.

Skatiet arī: Atklātās entītijas

Zema līmeņa atklāšanas konfigurēšana

Mēs ilustrēsim zema līmeņa atklāšanu, izmantojot failu sistēmas atklāšanas piemēru.

Lai konfigurētu atklāšanu, rīkojieties šādi:

  • Dodieties uz: Datu ievākšana > Veidnes vai Hosts.
  • Noklikšķiniet uz Atklāšana atbilstošās veidnes/hosta rindā.

  • Ekrāna augšējā labajā stūrī noklikšķiniet uz Izveidot atklāšanas kārtulu.
  • Aizpildiet atklāšanas kārtulas veidlapu ar nepieciešamo informāciju.

Atklāšanas kārtula

Atklāšanas kārtulas forma satur piecas cilnes, kas no kreisās uz labo pusi attēlo datu plūsmu atklāšanas laikā:

  • Atklāšanas kārtula — nosaka, galvenokārt, iebūvēto vienumu vai pielāgotu skriptu atklāšanas datu iegūšanai.
  • Priekšapstrāde — piemēro noteiktu priekšapstrādi atklātajiem datiem.
  • LLD makrosi — ļauj izvilkt noteiktas makrosu vērtības izmantošanai atklātajos vienumos, trigeros utt.
  • Filtri — ļauj filtrēt atklātās vērtības.
  • Aizstāšanas — ļauj modificēt vienumus, trigerus, grafikus vai hostu prototipus, piemērojot tos konkrētiem atklātajiem objektiem.

Cilne Atklāšanas kārtula satur atklāšanai izmantojamo vienuma atslēgu (kā arī dažus vispārīgus atklāšanas kārtulas atribūtus):

Visi obligātie ievades lauki ir atzīmēti ar sarkanu zvaigznīti.

Parameter Description
Name Atklāšanas kārtulas nosaukums.
Type Pārbaudes tips, ko izmantot atklāšanai.
Šajā piemērā mēs izmantojam Zabbix aģents vienuma tipu.
Atklāšanas kārtula var būt arī atkarīgais vienums, kas ir atkarīgs no parasta vienuma. Tā nevar būt atkarīga no citas atklāšanas kārtulas. Atkarīgajam vienumam atlasiet attiecīgo tipu (Atkarīgais vienums) un laukā 'Master item' norādiet galveno vienumu. Galvenajam vienumam ir jāeksistē.
Key Ievadiet atklāšanas vienuma atslēgu (līdz 2048 rakstzīmēm).
Piemēram, varat izmantot iebūvēto vienuma atslēgu "vfs.fs.discovery", lai atgrieztu JSON virkni ar datorā esošo failu sistēmu sarakstu, to tipiem un montēšanas opcijām.
Ņemiet vērā, ka cita failu sistēmu atklāšanas iespēja ir izmantot atklāšanas rezultātus ar aģenta atslēgu "vfs.fs.get" (skatiet piemēru).
Update interval Šis lauks nosaka, cik bieži Zabbix veic atklāšanu. Sākumā, kad tikai iestatāt failu sistēmu atklāšanu, iespējams, vēlēsieties iestatīt nelielu intervālu, taču, kad būsiet pārliecinājies, ka tā darbojas, varat to iestatīt uz 30 minūtēm vai vairāk, jo failu sistēmas parasti nemainās ļoti bieži.
Tiek atbalstīti laika sufiksi, piemēram, 30s, 1m, 2h, 1d.
Tiek atbalstīti lietotāja makrosi.
Piezīme: atjaunināšanas intervālu var iestatīt uz '0' tikai tad, ja pastāv pielāgoti intervāli ar vērtību, kas nav nulle. Ja iestatīta vērtība '0' un pastāv pielāgots intervāls (elastīgs vai plānots) ar vērtību, kas nav nulle, vienums tiks aptaujāts pielāgotā intervāla darbības laikā.
Jaunas atklāšanas kārtulas tiks pārbaudītas 60 sekunžu laikā pēc to izveides, ja vien tām nav iestatīts Scheduling vai Flexible update interval un Update interval nav iestatīts uz 0.
Ņemiet vērā, ka esošai atklāšanas kārtulai atklāšanu var veikt nekavējoties, nospiežot pogu Execute now.
Custom intervals Varat izveidot pielāgotas kārtulas vienuma pārbaudei:
Flexible — izveidot izņēmumu Update interval vērtībai (intervāls ar citu biežumu)
Scheduling — izveidot pielāgotu aptaujas grafiku.
Detalizētu informāciju skatiet sadaļā Pielāgotie intervāli.
Timeout Iestatiet atklāšanas pārbaudes noildzi. Atlasiet noildzes opciju:
Global — tiek izmantota starpniekservera/globālā noildze (parādīta pelēkajā laukā Timeout);
Override — tiek izmantota pielāgota noildze (iestatīta laukā Timeout; atļautais diapazons: 1 - 600s). Tiek atbalstīti laika sufiksi, piemēram, 30s, 1m, un lietotāja makrosi.
Noklikšķinot uz saites Timeouts, varat konfigurēt starpniekservera noildzes vai globālās noildzes (ja starpniekserveris netiek izmantots). Ņemiet vērā, ka saite Timeouts ir redzama tikai lietotājiem ar tipu Super admin un atļaujām uz lietotāja saskarne sadaļām Administration > General vai Administration > Proxies.
Delete lost resources Norādiet, cik drīz atklātā entītija tiks dzēsta, tiklīdz tās atklāšanas statuss kļūs par "Not discovered anymore":
Never — tā netiks dzēsta;
Immediately — tā tiks dzēsta nekavējoties;
After — tā tiks dzēsta pēc norādītā laika perioda. Vērtībai jābūt lielākai par Disable lost resources vērtību.
Tiek atbalstīti laika sufiksi, piemēram, 2h, 1d.
Tiek atbalstīti lietotāja makrosi.
Piezīme: nav ieteicams izmantot "Immediately", jo pat nepareiza filtra rediģēšana var novest pie tā, ka entītija tiek dzēsta kopā ar visiem vēsturiskajiem datiem.
Ņemiet vērā, ka manuāli atspējoti resursi netiks dzēsti ar zema līmeņa atklāšanu.
Disable lost resources Norādiet, cik drīz atklātā entītija tiks atspējota, tiklīdz tās atklāšanas statuss kļūs par "Not discovered anymore":
Never — tā netiks atspējota;
Immediately — tā tiks atspējota nekavējoties;
After — tā tiks atspējota pēc norādītā laika perioda. Vērtībai jābūt lielākai par atklāšanas kārtulas atjaunināšanas intervālu.
Ņemiet vērā, ka automātiski atspējoti resursi tiks atkal iespējoti, ja zema līmeņa atklāšana tos atklās no jauna. Manuāli atspējoti resursi netiks atkal iespējoti, ja tie tiks atklāti no jauna.
Šis lauks netiek parādīts, ja Delete lost resources ir iestatīts uz "Immediately".
Tiek atbalstīti laika sufiksi, piemēram, 2h, 1d.
Tiek atbalstīti lietotāja makrosi.
Description Ievadiet aprakstu.
Enabled Ja atzīmēts, kārtula tiks apstrādāta.

Atklāšanas kārtulas vēsture netiek saglabāta.

Priekšapstrāde

Cilne Priekšapstrāde ļauj definēt pārveidošanas noteikumus, ko piemērot atklāšanas rezultātam. Šajā solī ir iespējama viena vai vairākas pārveidošanas. Pārveidošanas tiek izpildītas tādā secībā, kādā tās ir definētas. Visa priekšapstrāde tiek veikta Zabbix serverī.

Skatiet arī:

Type
Pārveidošana Apraksts
Text
Regulārā izteiksme Salīdzināt saņemto vērtību ar <pattern> regulāro izteiksmi un aizstāt vērtību ar izvilkto <output>. Regulārā izteiksme atbalsta ne vairāk kā 10 uztvertu grupu izvilkšanu, izmantojot \N secību.
Parametri:
pattern - regulārā izteiksme
output - izvades formatēšanas veidne. \N (kur N=1…9) atsoļa secība tiek aizstāta ar N-to atrasto grupu. \0 atsoļa secība tiek aizstāta ar atrasto tekstu.
Ja atzīmējat izvēles rūtiņu Custom on fail, ir iespējams norādīt pielāgotas kļūdu apstrādes opcijas: vai nu atmest vērtību, iestatīt norādītu vērtību vai iestatīt norādītu kļūdas ziņojumu.
Aizstāt Atrast meklējamo virkni un aizstāt to ar citu (vai neko). Tiks aizstātas visas meklējamās virknes parādīšanās reizes.
Parametri:
search string - virkne, ko atrast un aizstāt, reģistrjutīga (obligāti)
replacement - virkne, ar ko aizstāt meklējamo virkni. Aizstāšanas virkne var būt arī tukša, tādējādi ļaujot dzēst meklējamo virkni, kad tā ir atrasta.
Ir iespējams izmantot atsoļa secības, lai meklētu vai aizstātu rindas pārtraukumus, kursora atgriešanu, tabulācijas un atstarpes "\n \r \t \s"; slīpsvītru var atsoļot kā "\\" un atsoļa secības var atsoļot kā "\\n". Rindas pārtraukumu, kursora atgriešanas un tabulāciju atsoļošana zema līmeņa atklāšanas laikā tiek veikta automātiski.
Structured data
JSONPath Izvilkt vērtību vai fragmentu no JSON datiem, izmantojot JSONPath funkcionalitāti.
Ja atzīmējat izvēles rūtiņu Custom on fail, ir iespējams norādīt pielāgotas kļūdu apstrādes opcijas: vai nu atmest vērtību, iestatīt norādītu vērtību vai iestatīt norādītu kļūdas ziņojumu.
XML XPath Izvilkt vērtību vai fragmentu no XML datiem, izmantojot XPath funkcionalitāti.
Lai šī opcija darbotos, Zabbix serverim jābūt kompilētam ar libxml atbalstu.
Piemēri:
number(/document/item/value) izvilks 10 no <document><item><value>10</value></item></document>
number(/document/item/@attribute) izvilks 10 no <document><item attribute="10"></item></document>
/document/item izvilks <item><value>10</value></item> no <document><item><value>10</value></item></document>
Ņemiet vērā, ka nosaukumvietas netiek atbalstītas.
Ja atzīmējat izvēles rūtiņu Custom on fail, ir iespējams norādīt pielāgotas kļūdu apstrādes opcijas: vai nu atmest vērtību, iestatīt norādītu vērtību vai iestatīt norādītu kļūdas ziņojumu.
CSV uz JSON Pārveidot CSV faila datus JSON formātā.
Papildinformāciju skatiet: CSV uz JSON priekšapstrāde.
XML uz JSON Pārveidot XML formāta datus uz JSON.
Papildinformāciju skatiet: Serializācijas noteikumi.
Ja atzīmējat izvēles rūtiņu Custom on fail, ir iespējams norādīt pielāgotas kļūdu apstrādes opcijas: vai nu atmest vērtību, iestatīt norādītu vērtību vai iestatīt norādītu kļūdas ziņojumu.
SNMP
SNMP walk vērtība Izvilkt vērtību pēc norādītā OID/MIB nosaukuma un piemērot formatēšanas opcijas:
Unchanged - atgriezt Hex-STRING kā neatsoļotu heksadecimālu virkni (ņemiet vērā, ka attēlošanas norādes joprojām tiek piemērotas);
UTF-8 from Hex-STRING - pārveidot Hex-STRING par UTF-8 virkni;
MAC from Hex-STRING - pārveidot Hex-STRING par MAC adreses virkni (kurā ' ' tiks aizstāts ar ':');
Integer from BITS - pārveidot pirmos 8 baitus no bitu virknes, kas izteikta kā heksadecimālu rakstzīmju secība (piemēram, "1A 2B 3C 4D"), par 64 bitu bezparaksta veselu skaitli. Bitu virknēs, kas ir garākas par 8 baitiem, nākamie baiti tiks ignorēti.
Ja atzīmējat izvēles rūtiņu Custom on fail, ir iespējams norādīt pielāgotas kļūdu apstrādes opcijas: vai nu atmest vērtību, iestatīt norādītu vērtību vai iestatīt norādītu kļūdas ziņojumu.
SNMP walk uz JSON Pārveidot SNMP vērtības uz JSON. Norādiet lauka nosaukumu JSON un atbilstošo SNMP OID ceļu. Lauku vērtības tiks aizpildītas ar vērtībām no norādītā SNMP OID ceļa.
Šo priekšapstrādes soli var izmantot SNMP OID atklāšanai.
Ir pieejamas līdzīgas vērtību formatēšanas opcijas kā solī SNMP walk vērtība.
Ja atzīmējat izvēles rūtiņu Custom on fail, ir iespējams norādīt pielāgotas kļūdu apstrādes opcijas: vai nu atmest vērtību, iestatīt norādītu vērtību vai iestatīt norādītu kļūdas ziņojumu.
SNMP get vērtība Piemērot formatēšanas opcijas SNMP get vērtībai:
UTF-8 from Hex-STRING - pārveidot Hex-STRING par UTF-8 virkni;
MAC from Hex-STRING - pārveidot Hex-STRING par MAC adreses virkni (kurā ' ' tiks aizstāts ar ':');
Integer from BITS - pārveidot pirmos 8 baitus no bitu virknes, kas izteikta kā heksadecimālu rakstzīmju secība (piemēram, "1A 2B 3C 4D"), par 64 bitu bezparaksta veselu skaitli. Bitu virknēs, kas ir garākas par 8 baitiem, nākamie baiti tiks ignorēti.
Ja atzīmējat izvēles rūtiņu Custom on fail, ir iespējams norādīt pielāgotas kļūdu apstrādes opcijas: vai nu atmest vērtību, iestatīt norādītu vērtību vai iestatīt norādītu kļūdas ziņojumu.
Custom scripts
JavaScript Ievadiet JavaScript kodu modālajā redaktorā, kas tiek atvērts, noklikšķinot parametra laukā vai uz zīmuļa ikonas blakus tam.
Ņemiet vērā, ka pieejamais JavaScript garums ir atkarīgs no izmantotās datubāzes.
Papildinformāciju skatiet: Javascript priekšapstrāde
Validation
Neatbilst regulārajai izteiksmei Norādiet regulāro izteiksmi, kurai vērtība nedrīkst atbilst.
Piemēram, Error:(.*?)\.
Ja atzīmējat izvēles rūtiņu Custom on fail, ir iespējams norādīt pielāgotas kļūdu apstrādes opcijas: vai nu atmest vērtību, iestatīt norādītu vērtību vai iestatīt norādītu kļūdas ziņojumu.
Pārbaudīt kļūdu JSON Pārbaudīt lietojumprogrammas līmeņa kļūdas ziņojumu, kas atrodas JSONPath. Apturēt apstrādi, ja pārbaude ir veiksmīga un ziņojums nav tukšs; pretējā gadījumā turpināt apstrādi ar vērtību, kāda tā bija pirms šī priekšapstrādes soļa. Ņemiet vērā, ka šīs ārējo servisu kļūdas lietotājam tiek ziņotas tādas, kādas tās ir, nepievienojot informāciju par priekšapstrādes soli.
Piemēram, $.errors. Ja tiek saņemts JSON, piemēram, {"errors":"e1"}, nākamais priekšapstrādes solis netiks izpildīts.
Ja atzīmējat izvēles rūtiņu Custom on fail, ir iespējams norādīt pielāgotas kļūdu apstrādes opcijas: vai nu atmest vērtību, iestatīt norādītu vērtību vai iestatīt norādītu kļūdas ziņojumu.
Pārbaudīt kļūdu XML Pārbaudīt lietojumprogrammas līmeņa kļūdas ziņojumu, kas atrodas XPath. Apturēt apstrādi, ja pārbaude ir veiksmīga un ziņojums nav tukšs; pretējā gadījumā turpināt apstrādi ar vērtību, kāda tā bija pirms šī priekšapstrādes soļa. Ņemiet vērā, ka šīs ārējo servisu kļūdas lietotājam tiek ziņotas tādas, kādas tās ir, nepievienojot informāciju par priekšapstrādes soli.
Nederīga XML parsēšanas kļūmes gadījumā kļūda netiks ziņota.
Ja atzīmējat izvēles rūtiņu Custom on fail, ir iespējams norādīt pielāgotas kļūdu apstrādes opcijas: vai nu atmest vērtību, iestatīt norādītu vērtību vai iestatīt norādītu kļūdas ziņojumu.
Atbilst regulārajai izteiksmei Norādiet regulāro izteiksmi, kurai vērtībai jāatbilst.
Ja atzīmējat izvēles rūtiņu Custom on fail, ir iespējams norādīt pielāgotas kļūdu apstrādes opcijas: vai nu atmest vērtību, iestatīt norādītu vērtību vai iestatīt norādītu kļūdas ziņojumu.
Throttling
Atmest nemainīgu ar sirdspukstu Atmest vērtību, ja tā nav mainījusies definētajā laika periodā (sekundēs).
Sekunžu norādīšanai tiek atbalstītas pozitīvas veselas skaitļu vērtības (minimums - 1 sekunde). Šajā laukā var izmantot laika sufiksus (piemēram, 30s, 1m, 2h, 1d). Šajā laukā var izmantot lietotāja makrosus un zema līmeņa atklāšanas makrosus.
Atklāšanas vienumam var norādīt tikai vienu ierobežošanas opciju.
Piemēram, 1m. Ja identisks teksts tiek nodots šim noteikumam divreiz 60 sekunžu laikā, tas tiks atmests.
Piezīme: vienumu prototipu maiņa neatiestata ierobežošanu. Ierobežošana tiek atiestatīta tikai tad, kad tiek mainīti priekšapstrādes soļi.
Prometheus
Prometheus uz JSON Pārveidot nepieciešamās Prometheus metrikas uz JSON.
Sīkāku informāciju skatiet Prometheus pārbaudes.

Ņemiet vērā, ka, ja atklāšanas kārtula hostam ir piemērota, izmantojot veidni, tad šīs cilnes saturs ir tikai lasāms.

Pielāgotas makrokomandas

Cilne LLD makrokomandas ļauj norādīt pielāgotas zema līmeņa atklāšanas makrokomandas.

Pielāgotas makrokomandas ir noderīgas gadījumos, kad atgrieztajā JSON jau nav definētas nepieciešamās makrokomandas. Tātad, piemēram:

  • Vietējā vfs.fs.discovery atslēga failu sistēmu atklāšanai atgriež JSON ar dažām iepriekš definētām LLD makrokomandām, piemēram, {#FSNAME}, {#FSTYPE}. Šīs makrokomandas var izmantot tieši vienumu un trigeru prototipos (skatiet turpmākās šīs lapas sadaļas); pielāgotu makrokomandu definēšana nav nepieciešama;
  • Arī aģenta vienums vfs.fs.get atgriež JSON ar failu sistēmu datiem, taču bez iepriekš definētām LLD makrokomandām. Šajā gadījumā makrokomandas varat definēt pats un sasaistīt tās ar vērtībām JSON, izmantojot JSONPath:

Izgūtās vērtības var izmantot atklātajos vienumos, trigeros utt. Ņemiet vērā, ka vērtības tiks izgūtas no atklāšanas rezultāta un visām līdz šim veiktajām priekšapstrādes darbībām.

Parameter Description
LLD macro Zema līmeņa atklāšanas makrokomandas nosaukums, izmantojot šādu sintaksi: {#MACRO}.
JSONPath Ceļš, kas tiek izmantots LLD makrokomandas vērtības izgūšanai no LLD rindas, izmantojot JSONPath sintaksi.
Vērtības, kas izgūtas no atgrieztā JSON, tiek izmantotas, lai aizstātu LLD makrokomandas vienumu, trigeru utt. prototipu laukos.
JSONPath var norādīt, izmantojot punkta notāciju vai iekavu notāciju. Iekavu notācija jāizmanto īpašo rakstzīmju un unikoda gadījumā, piemēram, $['unicode + special chars #1']['unicode + special chars #2'].

Piemēram, $.foo izgūs "bar" un "baz" no šī JSON: [{"foo":"bar"}, {"foo":"baz"}]
Ņemiet vērā, ka $.foo izgūs "bar" un "baz" arī no šī JSON: {"data":[{"foo":"bar"}, {"foo":"baz"}]}, jo viens "data" objekts tiek apstrādāts automātiski (lai nodrošinātu atpakaļsaderību ar zema līmeņa atklāšanas ieviešanu Zabbix versijās pirms 4.2).

Filtrs

Filtru var izmantot, lai ģenerētu reālus vienumus, trigerus un grafikus tikai tām entītijām, kas atbilst kritērijiem. Cilnē Filtri ir ietvertas atklāšanas kārtulas filtru definīcijas, kas ļauj filtrēt atklāšanas vērtības:

Parametrs Apraksts
Aprēķina veids Ir pieejamas šādas filtru aprēķināšanas opcijas:
And - jāizpildās visiem filtriem;
Or - pietiek, ja izpildās viens filtrs;
And/Or - izmanto And ar dažādiem makrosu nosaukumiem un Or ar vienādiem makrosu nosaukumiem;
Custom expression - piedāvā iespēju definēt pielāgotu filtru aprēķinu. Formulai jāietver visi sarakstā esošie filtri. Ierobežots līdz 255 simboliem.
Filtri Ir pieejami šādi filtra nosacījumu operatori: matches, does not match, exists, does not exist.
Operatoriem matches un does not match ir nepieciešama Perl Compatible Regular Expression (PCRE). Piemēram, ja jūs interesē tikai C:, D: un E: failu sistēmas, laukā "Macro" varat ievadīt {#FSNAME}, bet laukā "Regular expression" - regulāro izteiksmi "\C|\D|\E". Filtrēšana ir iespējama arī pēc failu sistēmu tipiem, izmantojot makrosu {#FSTYPE} (piemēram, "\ext|\reiserfs"), un pēc disku tipiem (atbalstīts tikai Windows aģents), izmantojot makrosu {#FSDRIVETYPE} (piemēram, "fixed").
Laukā "Regular expression" varat ievadīt regulāro izteiksmi vai atsauci uz globālu regular expression.
Lai pārbaudītu regulāro izteiksmi, varat izmantot "grep -E", piemēram: ````for f in ext2 nfs reiserfs smbfs; do echo $f | grep -E 'ext|^reiserfs' || echo "SKIP: $f"; done````

Operatori exists un does not exist ļauj filtrēt entītijas, pamatojoties uz norādītā LLD makrosa esamību vai neesamību atbildē.
Ņemiet vērā, ka, ja atbildē trūkst makrosa no filtra, atrastā entītija tiks ignorēta, ja vien šim makrosam nav norādīts nosacījums "does not exist".

Tiks parādīts brīdinājums, ja makrosa neesamība ietekmē izteiksmes rezultātu. Piemēram, ja {#B} trūkst šādā izteiksmē:
{#A} matches 1 and {#B} matches 2 - tiks parādīts brīdinājums
{#A} matches 1 or {#B} matches 2 - brīdinājuma nebūs

Kļūda vai drukas kļūda regulārajā izteiksmē, kas izmantota LLD kārtulā (piemēram, nekorekta regulārā izteiksme "File systems for discovery"), var izraisīt tūkstošiem konfigurācijas elementu, vēsturisko vērtību un notikumu dzēšanu daudziem hostiem.

Zabbix datubāze MySQL vidē jāizveido ar reģistrjutīgu salīdzināšanu, lai failu sistēmu nosaukumi, kas atšķiras tikai ar burtu reģistru, tiktu atklāti pareizi.

Pārrakstīšana

Cilne Pārrakstīšana ļauj iestatīt noteikumus, lai mainītu vienumu, trigeru, grafiku, hostu un atklāšanas prototipu sarakstu vai to atribūtus atklātajiem objektiem, kas atbilst norādītajiem kritērijiem.

Pārrakstīšanas (ja tādas ir) tiek parādītas pārkārtojamā vilkšanas un nomešanas sarakstā un izpildītas tādā secībā, kādā tās ir definētas. Lai konfigurētu jaunas pārrakstīšanas informāciju, noklikšķiniet uz blokā Overrides. Lai rediģētu esošu pārrakstīšanu, noklikšķiniet uz pārrakstīšanas nosaukuma. Tiks atvērts uznirstošais logs, kurā var rediģēt pārrakstīšanas noteikuma informāciju.

Visi obligātie parametri ir atzīmēti ar sarkanām zvaigznītēm.

Parameter Description
Name Unikāls (katram LLD noteikumam) pārrakstīšanas nosaukums.
If filter matches Nosaka, vai nākamās pārrakstīšanas ir jāapstrādā, kad filtra nosacījumi ir izpildīti:
Continue overrides - tiks apstrādātas nākamās pārrakstīšanas.
Stop processing - tiks izpildītas iepriekšējo (ja tādas ir) un šīs pārrakstīšanas darbības, bet nākamās pārrakstīšanas atbilstošajām LLD rindām tiks ignorētas.
Filters Nosaka, kurām atklātajām entītijām pārrakstīšana ir jāpiemēro. Pārrakstīšanas filtri tiek apstrādāti pēc atklāšanas noteikuma filtriem, un tiem ir tāda pati funkcionalitāte.
Operations Pārrakstīšanas darbības tiek parādītas ar šādu informāciju:
Condition - objekta tips un nosacījums, kam jābūt izpildītam objekta nosaukumam; piemēram: Trigera prototips nav vienāds ar Disk space is low (used > 50%).
Actions - tiek parādītas saites darbības rediģēšanai un noņemšanai.

Darbības konfigurēšana

Lai konfigurētu jaunas darbības informāciju, noklikšķiniet uz blokā Operations. Lai rediģētu esošu darbību, noklikšķiniet uz blakus darbībai. Tiks atvērts uznirstošais logs, kurā var rediģēt darbības informāciju.

Parameter Description
Object Ir pieejami pieci objektu tipi:
Vienuma prototips
Trigera prototips
Grafika prototips
Hosta prototips
Atklāšanas prototips
Condition Ļauj filtrēt entītijas, kurām darbība ir jāpiemēro.
Operator Atbalstītie operatori:
equals - piemērot šim prototipam
does not equal - piemērot visiem prototipiem, izņemot šo
contains - piemērot, ja prototipa nosaukums satur šo virkni
does not contain - piemērot, ja prototipa nosaukums nesatur šo virkni
matches - piemērot, ja prototipa nosaukums atbilst regulārajai izteiksmei
does not match - piemērot, ja prototipa nosaukums neatbilst regulārajai izteiksmei
Pattern Regulārā izteiksme vai meklējamā virkne.
Object: Item prototype
Create enabled Kad izvēles rūtiņa ir atzīmēta, parādīsies pogas, kas ļaus pārrakstīt sākotnējos vienuma prototipa iestatījumus:
Yes - vienums tiks pievienots iespējotā stāvoklī.
No - vienums tiks pievienots atklātajai entītijai, bet atspējotā stāvoklī.
Discover Kad izvēles rūtiņa ir atzīmēta, parādīsies pogas, kas ļaus pārrakstīt sākotnējos vienuma prototipa iestatījumus:
Yes - vienums tiks pievienots.
No - vienums netiks pievienots.
Update interval Kad izvēles rūtiņa ir atzīmēta, parādīsies divas opcijas, kas ļaus iestatīt citu intervālu vienumam:
Delay - vienuma atjaunināšanas intervāls. Tiek atbalstīti lietotāja makrosi un laika sufiksi (piemēram, 30s, 1m, 2h, 1d). Jāiestata uz 0, ja tiek izmantots Custom interval.
Custom interval - noklikšķiniet uz , lai norādītu elastīgus/plānotus intervālus. Detalizētu informāciju skatiet sadaļā Pielāgoti intervāli.
History Kad izvēles rūtiņa ir atzīmēta, parādīsies pogas, kas ļaus vienumam iestatīt citu vēstures glabāšanas periodu:
Do not store - ja atlasīts, vēsture netiks glabāta.
Store up to - ja atlasīts, labajā pusē parādīsies ievades lauks glabāšanas perioda norādīšanai. Tiek atbalstīti lietotāja makrosi un LLD makrosi.
Trends Kad izvēles rūtiņa ir atzīmēta, parādīsies pogas, kas ļaus vienumam iestatīt citu tendenču glabāšanas periodu:
Do not store - ja atlasīts, tendences netiks glabātas.
Store up to - ja atlasīts, labajā pusē parādīsies ievades lauks glabāšanas perioda norādīšanai. Tiek atbalstīti lietotāja makrosi un LLD makrosi.
Tags Kad izvēles rūtiņa ir atzīmēta, parādīsies jauns bloks, kas ļaus norādīt birkas-vērtības pārus.
Šīs birkas tiks pievienotas vienuma prototipā norādītajām birkām, pat ja birku nosaukumi sakrīt.
Object: Trigger prototype
Create enabled Kad izvēles rūtiņa ir atzīmēta, parādīsies pogas, kas ļaus pārrakstīt sākotnējos trigera prototipa iestatījumus:
Yes - trigeris tiks pievienots iespējotā stāvoklī.
No - trigeris tiks pievienots atklātajai entītijai, bet atspējotā stāvoklī.
Discover Kad izvēles rūtiņa ir atzīmēta, parādīsies pogas, kas ļaus pārrakstīt sākotnējos trigera prototipa iestatījumus:
Yes - trigeris tiks pievienots.
No - trigeris netiks pievienots.
Severity Kad izvēles rūtiņa ir atzīmēta, parādīsies trigera būtiskuma pogas, kas ļaus mainīt trigera būtiskumu.
Tags Kad izvēles rūtiņa ir atzīmēta, parādīsies jauns bloks, kas ļaus norādīt birkas-vērtības pārus.
Šīs birkas tiks pievienotas trigera prototipā norādītajām birkām, pat ja birku nosaukumi sakrīt.
Object: Graph prototype
Discover Kad izvēles rūtiņa ir atzīmēta, parādīsies pogas, kas ļaus pārrakstīt sākotnējos grafika prototipa iestatījumus:
Yes - grafiks tiks pievienots.
No - grafiks netiks pievienots.
Object: Host prototype
Create enabled Kad izvēles rūtiņa ir atzīmēta, parādīsies pogas, kas ļaus pārrakstīt sākotnējos hosta prototipa iestatījumus:
Yes - hosts tiks izveidots iespējotā stāvoklī.
No - hosts tiks izveidots atspējotā stāvoklī.
Discover Kad izvēles rūtiņa ir atzīmēta, parādīsies pogas, kas ļaus pārrakstīt sākotnējos hosta prototipa iestatījumus:
Yes - hosts tiks atklāts.
No - hosts netiks atklāts.
Link templates Kad izvēles rūtiņa ir atzīmēta, parādīsies ievades lauks veidņu norādīšanai. Sāciet rakstīt veidnes nosaukumu vai noklikšķiniet uz Select blakus laukam un atlasiet veidnes no saraksta uznirstošajā logā.
Veidnes no šīs pārrakstīšanas tiek pievienotas visām veidnēm, kas jau ir piesaistītas hosta prototipam.
Tags Kad izvēles rūtiņa ir atzīmēta, parādīsies jauns bloks, kas ļaus norādīt birkas-vērtības pārus.
Šīs birkas tiks pievienotas hosta prototipā norādītajām birkām, pat ja birku nosaukumi sakrīt.
Host inventory Kad izvēles rūtiņa ir atzīmēta, parādīsies pogas, kas ļaus atlasīt citu hosta prototipa inventāra režīmu:
Disabled - neaizpildīt hosta inventāru
Manual - norādīt informāciju manuāli
Automated - automātiski aizpildīt hosta inventāra datus, pamatojoties uz savāktajiem mērījumiem.

Veidlapas pogas

Pogas veidlapas apakšdaļā ļauj veikt vairākas darbības.
Pievienot atklāšanas kārtulu. Šī poga ir pieejama tikai jaunām atklāšanas kārtulām.
Atjaunināt atklāšanas kārtulas rekvizītus. Šī poga ir pieejama tikai esošām atklāšanas kārtulām.
Izveidot citu atklāšanas kārtulu, pamatojoties uz pašreizējās atklāšanas kārtulas rekvizītiem.
Nekavējoties veikt atklāšanu, pamatojoties uz atklāšanas kārtulu. Atklāšanas kārtulai jau ir jāeksistē. Skatiet vairāk informācijas.
Piezīme: veicot atklāšanu nekavējoties, konfigurācijas kešatmiņa netiek atjaunināta, tādēļ rezultāts neatspoguļos pavisam nesenās izmaiņas atklāšanas kārtulas konfigurācijā.
Pārbaudīt atklāšanas kārtulas konfigurāciju. Izmantojiet šo pogu, lai pārbaudītu konfigurācijas iestatījumus (piemēram, savienojamību un parametru pareizību), pastāvīgi nepiemērojot nekādas izmaiņas.
Dzēst atklāšanas kārtulu.
Atcelt atklāšanas kārtulas rekvizītu rediģēšanu.

Atklātās entītijas

Tālāk redzamie ekrānuzņēmumi ilustrē, kā hosta konfigurācijā izskatās atklātie vienumi, trigeri un grafiki. Atklātajām entītijām priekšā ir oranža saite uz atklāšanas kārtulu, no kuras tās ir iegūtas.

Ņemiet vērā, ka atklātās entītijas netiks izveidotas, ja jau pastāv entītijas ar tiem pašiem unikalitātes kritērijiem, piemēram, vienums ar to pašu atslēgu vai grafiks ar to pašu nosaukumu. Šādā gadījumā lietotāja saskarnē tiek parādīts kļūdas ziņojums, ka zema līmeņa atklāšanas kārtula nevarēja izveidot noteiktas entītijas. Tomēr pati atklāšanas kārtula nekļūs par neatbalstītu tikai tāpēc, ka kādu entītiju nevarēja izveidot un tā bija jāizlaiž. Atklāšanas kārtula turpinās izveidot/atjaunināt citas entītijas.

Ja atklātā entītija (hosts, failu sistēma, saskarne utt.) vairs netiek atklāta (vai vairs neatbilst filtram), entītijas, kas tika izveidotas, pamatojoties uz to, var tikt automātiski atspējotas un vēlāk dzēstas.

Zaudētie resursi var tikt automātiski atspējoti atkarībā no parametra Disable lost resources vērtības. Tas attiecas uz zaudētajiem hostiem, vienumiem un trigeriem.

Zaudētie resursi var tikt automātiski dzēsti atkarībā no parametra Delete lost resources vērtības. Tas attiecas uz zaudētajiem hostiem, hostu grupām, vienumiem, trigeriem un grafikiem.

Kad atklātās entītijas kļūst par "Vairs netiek atklātas", entītiju sarakstā tiek parādīts dzīves ilguma indikators. Pārvietojiet peles kursoru virs tā, un tiks parādīts ziņojums ar detalizētu informāciju par statusu.

Ja entītijas tika atzīmētas dzēšanai, bet netika dzēstas paredzētajā laikā (atspējota atklāšanas kārtula vai vienuma hosts), tās tiks dzēstas nākamajā reizē, kad tiks apstrādāta atklāšanas kārtula.

Entītijas, kas satur citas entītijas un ir atzīmētas dzēšanai, netiks atjauninātas, ja izmaiņas tiks veiktas atklāšanas kārtulas līmenī. Piemēram, uz LLD balstīti trigeri netiks atjaunināti, ja tie satur vienumus, kas ir atzīmēti dzēšanai.

Citi atklāšanas veidi

Plašāka informācija un instrukcijas par citiem gatavajiem atklāšanas veidiem ir pieejamas šādās sadaļās:

Plašāku informāciju par JSON formātu atklāšanas vienumiem un piemēru, kā ieviest savu failu sistēmas atklājēju kā Perl skriptu, skatiet sadaļā pielāgotu LLD noteikumu izveide.