2 Vienuma vērtības priekšapstrāde

Pārskats

Priekšapstrāde ļauj piemērot transformācijas saņemtajām vienuma vērtībām pirms to saglabāšanas datubāzē. Šīs transformācijas/priekšapstrādes darbības veic Zabbix serveris vai starpniekserveris (ja vienumus uzrauga starpniekserveris).

Šī funkcija atbalsta dažādus lietošanas scenārijus, piemēram:

• baitu pārveidošanu bitos (piemēram, reizinot tīkla datplūsmas vērtības ar "8");
• sekundes statistikas aprēķināšanu pakāpeniski pieaugošām vērtībām;
• regulāro izteiksmju piemērošanu, lai izgūtu vai modificētu vērtības;
• pielāgotu skriptu izpildi vērtībām;
• nemainīgu vērtību atmešanu, lai optimizētu datubāzes glabātuves izmantošanu.

Vienumam var konfigurēt vienu vai vairākas priekšapstrādes darbības. Šīs darbības tiek izpildītas to konfigurēšanas secībā.

Visas vērtības, kas tiek nodotas priekšapstrādei, sākotnēji tiek apstrādātas kā virknes. Pārveidošana uz vēlamo vērtības tipu (kā definēts vienuma konfigurācijā) tiek veikta priekšapstrādes procesa beigās. Tomēr noteiktas priekšapstrādes darbības vajadzības gadījumā var izraisīt agrāku pārveidošanu. Detalizētai tehniskajai informācijai skatiet Priekšapstrādes detalizēta informācija.

Lai pārliecinātos, ka jūsu priekšapstrādes konfigurācija darbojas, kā paredzēts, varat to pārbaudīt.

Skatiet arī: Priekšapstrādes piemēri

Konfigurācija

Priekšapstrādes darbības tiek definētas vienuma konfigurācijas veidlapas cilnē Priekšapstrāde.

Noklikšķiniet uz Pievienot, lai atlasītu atbalstītu pārveidošanu.

Lauks Informācijas tips tiek parādīts cilnes apakšdaļā, kad ir definēta vismaz viena priekšapstrādes darbība. Ja nepieciešams, informācijas tipu var mainīt, neatverot citu cilni. Detalizētu parametru aprakstu skatiet sadaļā Vienuma izveide.

Atbalstītās transformācijas

Visas atbalstītās transformācijas ir norādītas tālāk. Noklikšķiniet uz transformācijas nosaukuma, lai skatītu pilnu informāciju par to.

Ja atlasītajai transformācijai ir iespējota izvēles rūtiņa Pielāgota darbība kļūmes gadījumā, varat to atzīmēt un norādīt pielāgotas kļūdu apstrādes opcijas: Atmest vērtību (atmest vērtību), Iestatīt vērtību uz (iestatīt norādīto vērtību) vai Iestatīt kļūdu uz (iestatīt norādīto kļūdas ziņojumu). Ja priekšapstrādes darbība neizdodas, vienums kļūs neatbalstīts tikai tad, ja nav atlasīta opcija Atmest vērtību vai Iestatīt vērtību uz.

Ņemiet vērā, ka Izmaiņu un Datu plūsmas ierobežošanas priekšapstrādes darbībām Zabbix ir jāatceras pēdējā vērtība, lai pēc nepieciešamības aprēķinātu vai salīdzinātu jauno vērtību. Šīs iepriekšējās vērtības apstrādā priekšapstrādes pārvaldnieks. Ja Zabbix serveris vai starpniekserveris tiek restartēts vai priekšapstrādes darbībās tiek veiktas izmaiņas, attiecīgā vienuma pēdējā vērtība tiek atiestatīta, kā rezultātā:

• Vienkāršas izmaiņas, Izmaiņas sekundē darbībām nākamā vērtība tiks ignorēta, jo nav iepriekšējās vērtības, no kuras aprēķināt izmaiņas;
• Atmest nemainīto, Atmest nemainīto ar sirdspukstu darbībām nākamā vērtība nekad netiks atmesta, pat ja saskaņā ar atmešanas noteikumiem tā būtu jāatmet.

Regulārā izteiksme

Salīdziniet vērtību ar regulāro izteiksmi un aizstājiet to ar nepieciešamo izvadi.

Parametri:

• pattern - regulārā izteiksme;
  
• output - izvades formatēšanas veidne. Escape secība \N (kur N=1…9) tiek aizstāta ar N-to atrasto grupu. Escape secība \0 tiek aizstāta ar atrasto tekstu.

Komentāri:

• Ja ievades vērtībai netiek atrasta atbilstība, vienums kļūs neatbalstīts;
  
• Regulārā izteiksme atbalsta ne vairāk kā 10 uztverto grupu izgūšanu, izmantojot secību \N;
  
• Dažus esošos piemērus skatiet sadaļā regulārās izteiksmes.

Aizstāt

Atrodiet meklējamo virkni un aizstājiet to ar citu virkni (vai neko).

Parametri:

• meklējamā virkne - virkne, ko atrast un aizstāt, reģistrjutīga (obligāti);
  
• aizstāšana - 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ā tiek atrasta.

Komentāri:

• Tiks aizstātas visas meklējamās virknes sakritības;
• Ir iespējams izmantot atsoļa secības, lai meklētu vai aizstātu rindas pārtraukumus, rindas atgriezi, tabulācijas un atstarpes "\n \r \t \s"; atpakaļvērsto slīpsvītru var atsoļot kā "\\" un atsoļa secības var atsoļot kā "\\n";
• Rindas pārtraukumu, rindas atgriezes un tabulāciju atsoļošana tiek veikta automātiski zema līmeņa atklāšanas laikā.

Apgriezt

Noņemt norādītās rakstzīmes no vērtības sākuma un beigām.

Labā apgriešana

Noņemt norādītās rakstzīmes no vērtības beigām.

Kreisā apgriešana

Noņem norādītās rakstzīmes no vērtības sākuma.

XML XPath

Izvelciet vērtību vai fragmentu no XML datiem, izmantojot XPath funkcionalitāti.

Komentāri:

• Lai šī opcija darbotos, Zabbix serverim (vai Zabbix starpniekserverim) jābūt kompilētam ar libxml atbalstu;
  
• Nosaukumvietas netiek atbalstītas.

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>

JSON ceļš

Izgūstiet vērtību vai fragmentu no JSON datiem, izmantojot JSONPath funkcionalitāti.

CSV uz JSON

Pārveidojiet CSV faila datus JSON formātā.

Papildinformāciju skatiet: CSV uz JSON priekšapstrāde.

XML uz JSON

Konvertēt XML formāta datus uz JSON.

Papildinformāciju skatiet sadaļā Serializācijas noteikumi.

SNMP walk vērtība

Izgūt vērtību, izmantojot norādīto OID/MIB nosaukumu, un lietot formatēšanas opcijas:

• Nemainīts - atgriezt heksadecimālo virkni kā neekranētu heksadecimālo virkni (ņemiet vērā, ka attēlošanas norādes joprojām tiek lietotas);
  
• UTF-8 no hex-STRING - pārveidot heksadecimālo virkni par UTF-8 virkni;
  
• MAC no hex-STRING - validēt heksadecimālo virkni kā MAC adresi un atgriezt atbilstošu MAC adreses virkni (kur ' ' tiek aizstātas ar ':');
  
• Integer no BITS - pārveidot bitu virknes pirmos 8 baitus, kas izteikti kā heksadecimālo rakstzīmju secība (piemēram, "1A 2B 3C 4D"), par 64 bitu unsigned integer. Bitu virknēs, kas ir garākas par 8 baitiem, nākamie baiti tiks ignorēti.

SNMP walk uz JSON

Konvertējiet 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.

Komentāri:

• Ir pieejamas līdzīgas vērtību formatēšanas opcijas kā darbībā SNMP walk value;
  
• Šo priekšapstrādes darbību var izmantot SNMP OID atklāšanai.

SNMP get vērtība

Lietot formatēšanas opcijas SNMP get vērtībai:

• UTF-8 no Hex-STRING - konvertēt heksadecimālo virkni par UTF-8 virkni;
  
• MAC no Hex-STRING - validēt heksadecimālo virkni kā MAC adresi un atgriezt atbilstošu MAC adreses virkni (kur ' ' tiek aizstātas ar ':');
  
• Integer no BITS - konvertēt bitu virknes pirmos 8 baitus, kas izteikti kā heksadecimālo rakstzīmju virkne (piemēram, "1A 2B 3C 4D"), par 64 bitu unsigned integer. Bitu virknēs, kas garākas par 8 baitiem, nākamie baiti tiks ignorēti.

Pielāgots reizinātājs

Reiziniet vērtību ar norādīto veselo skaitli vai peldošā komata vērtību.

Komentāri:

• Izmantojiet šo opciju, lai konvertētu vērtības, kas saņemtas KB, MBps u. c. vienībās, uz B, Bps. Pretējā gadījumā Zabbix nevarēs pareizi iestatīt prefiksus (K, M, G u. c.).
  
• Ņemiet vērā: ja vienuma informācijas tips ir Numeric (unsigned), ienākošajām vērtībām ar daļveida daļu tā tiks noapaļota pirms pielāgotā reizinātāja lietošanas (t. i., “0.9” kļūs par “0”);
  
• Ja izmantojat pielāgotu reizinātāju vai glabājat vērtību kā Change per second vienumiem, kuru informācijas tips ir iestatīts uz Numeric (unsigned), un iegūtā aprēķinātā vērtība faktiski ir peldošā komata skaitlis, aprēķinātā vērtība joprojām tiek pieņemta kā pareiza, noņemot decimāldaļu un saglabājot vērtību kā veselu skaitli;
  
• Tiek atbalstīts zinātniskais pieraksts, piemēram, 1e+70; lietotāja makrosi un LLD makrosi; virknes, kas ietver makrosus, piemēram, {#MACRO}e+10, {$MACRO1}e+{$MACRO2}. Makrosiem jāatrisinās par veselu skaitli vai peldošā komata skaitli.

Vienkāršas izmaiņas

Aprēķina starpību starp pašreizējo un iepriekšējo vērtību.

Komentāri:

• Šis solis var būt noderīgs, lai mērītu pastāvīgi augošu vērtību;
  
• Tiek aprēķināts kā value-prev_value, kur value ir pašreizējā vērtība; prev_value ir iepriekš saņemtā vērtība;
  
• Vienam vienumam ir atļauta tikai viena izmaiņu darbība ("Vienkāršas izmaiņas" vai "Izmaiņas sekundē");
• Ja pašreizējā vērtība ir mazāka par iepriekšējo vērtību, Zabbix šo starpību noraida (neko nesaglabā) un gaida nākamo vērtību.

Izmaiņa sekundē

Aprēķina vērtības izmaiņas (starpības starp pašreizējo un iepriekšējo vērtību) ātrumu sekundē.

Komentāri:

• Šis solis ir noderīgs, lai aprēķinātu nepārtraukti augošas vērtības ātrumu sekundē;
  
• Tā kā šis aprēķins var radīt peldošā komata skaitļus, ieteicams iestatīt “Informācijas tips” uz Numeric (float), pat ja saņemtās neapstrādātās vērtības ir veseli skaitļi. Tas ir īpaši svarīgi maziem skaitļiem, kuriem nozīme ir decimāldaļai. Ja peldošā komata vērtības ir lielas un var pārsniegt lauka “float” garumu, kā rezultātā visa vērtība var tikt zaudēta, ieteicams izmantot Numeric (unsigned) un tādējādi noņemt tikai decimāldaļu;
  
• Aprēķins tiek veikts pēc formulas (value-prev_value)/(time-prev_time), kur value - pašreizējā vērtība; prev_value - iepriekš saņemtā vērtība; time - pašreizējā laika zīmoga vērtība; prev_time - iepriekšējās vērtības laika zīmoga vērtība;
  
• Vienam vienumam ir atļauta tikai viena izmaiņas darbība (“Simple change” vai “Change per second”);
• Ja pašreizējā vērtība ir mazāka par iepriekšējo vērtību, Zabbix šo starpību atmet (neko nesaglabā) un gaida nākamo vērtību. Tas palīdz pareizi apstrādāt, piemēram, 32 bitu SNMP skaitītāju pāreju (pārpildi).

Būla vērtība uz decimālu

Konvertē vērtību no Būla formāta uz decimālo formātu.

Komentāri:

• Tekstuālais attēlojums tiek pārveidots par 0 vai 1. Tādējādi “TRUE” tiek saglabāts kā 1, bet “FALSE” tiek saglabāts kā 0. Visas vērtības tiek salīdzinātas, neņemot vērā reģistru. Pašlaik atpazītās vērtības ir šādas: TRUE gadījumā - true, t, yes, y, on, up, running, enabled, available, ok, master; FALSE gadījumā - false, f, no, n, off, down, unused, disabled, unavailable, err, slave. Turklāt jebkura vērtība, kas nav nulle, tiek uzskatīta par TRUE, bet nulle - par FALSE.

No oktālās uz decimālo

Konvertēt vērtību no oktālās formāta uz decimālo.

No heksadecimālās uz decimālo

Konvertē vērtību no heksadecimālā formāta uz decimālo.

JavaScript

Ievadiet JavaScript kodu modālajā redaktorā, kas tiek atvērts, noklikšķinot parametra laukā vai uz zīmuļa ikonas blakus tam.

Komentāri:

• Pieejamais JavaScript garums ir atkarīgs no izmantotās datubāzes;
  
• Papildinformāciju skatiet: Javascript priekšapstrāde.

Diapazonā

Definējiet diapazonu, kurā jāatrodas vērtībai, norādot minimālo/maksimālo vērtību (ieskaitot robežvērtības).

Komentāri:

• Tiek pieņemtas skaitliskas vērtības (tostarp jebkurš ciparu skaits, neobligāta decimāldaļa un neobligāta eksponentdaļa, negatīvas vērtības);
  
• Minimālajai vērtībai jābūt mazākai par maksimālo;
  
• Jābūt norādītai vismaz vienai vērtībai;
  
• Var izmantot lietotāja makro un zema līmeņa atklāšanas makro.

Atbilst regulārajai izteiksmei

Norādiet regulāro izteiksmi, kurai vērtībai jāatbilst.

Neatbilst regulārajai izteiksmei

Norādiet regulāro izteiksmi, kurai vērtība nedrīkst atbilst.

Kļūdas pārbaude JSON datos

Pārbauda lietojumprogrammas līmeņa kļūdas ziņojumu, kas atrodas JSONPath norādītajā vietā.
Ja pārbaude ir veiksmīga un ziņojums nav tukšs, apstrāde tiek pārtraukta; pretējā gadījumā apstrāde tiek turpināta ar vērtību, kas bija pieejama pirms šīs priekšapstrādes darbības.

Komentāri:

• Šīs ārējā pakalpojuma kļūdas lietotājam tiek parādītas tādas, kādas tās ir, nepievienojot informāciju par priekšapstrādes darbību;
  
• Ja neizdodas parsēt nederīgu JSON, kļūda netiek ziņota.

Kļūdas pārbaude XML

Pārbauda lietojumprogrammas līmeņa kļūdas ziņojumu, kas atrodas XPath ceļā.
Pārtrauc apstrādi, ja pārbaude ir veiksmīga un ziņojums nav tukšs; pretējā gadījumā turpina apstrādi ar vērtību, kas bija pirms šī priekšapstrādes soļa.

Komentāri:

• Šīs ārējā pakalpojuma kļūdas lietotājam tiek parādītas tādas, kādas tās ir, nepievienojot informāciju par priekšapstrādes soli;
  
• Ja neizdodas parsēt nederīgu XML, kļūda netiek ziņota.

Pārbaudīt kļūdu, izmantojot regulāro izteiksmi

Pārbaudīt lietojumprogrammas līmeņa kļūdas ziņojumu, izmantojot regulāro izteiksmi.
Ja pārbaude ir veiksmīga un ziņojums nav tukšs, apstrāde tiek pārtraukta; pretējā gadījumā apstrāde tiek turpināta ar vērtību, kas bija pirms šīs priekšapstrādes darbības.

Parametri:

• pattern - regulārā izteiksme;
  
• output - izvades formatēšanas veidne.
  Escape secība \N (kur N=1…9) tiek aizstāta ar N-to atrasto grupu.
  Escape secība \0 tiek aizstāta ar atrasto tekstu.

Komentāri:

• Šīs ārējā servisa kļūdas lietotājam tiek parādītas tādas, kādas tās ir, nepievienojot informāciju par priekšapstrādes darbību.

Pārbaudīt neatbalstītu vērtību

Pārbaudiet, vai nav izdevies izgūt vienuma vērtību. Norādiet, kā apstrādāt kļūmi, pamatojoties uz atgrieztā kļūdas ziņojuma pārbaudi.

Parametri:

• scope - atlasiet kļūdas apstrādes tvērumu:
  any error - jebkura kļūda;
  error matches - tikai kļūda, kas atbilst laukā pattern norādītajai regulārajai izteiksmei;
  error does not match - tikai kļūda, kas neatbilst laukā pattern norādītajai regulārajai izteiksmei
  
• pattern - regulārā izteiksme, kurai jāatbilst kļūdai. Ja tvēruma parametrā ir atlasīts any error, šis lauks netiek parādīts. Ja lauks tiek parādīts, tas ir obligāts.
  

Komentāri:

• Parasti nespēja izgūt vērtību vai kļūme tās izgūšanas laikā izraisītu vienuma statusa maiņu uz neatbalstītu. Šī priekšapstrādes darbība ļauj mainīt šo darbību.
• Šī priekšapstrādes darbība pārbauda tikai to, vai nav izdevies izgūt vienuma vērtību. Tā nepārbauda, piemēram, vai izgūtās vērtības tips (piemēram, virkne) atbilst vienuma informācijas tipam (piemēram, skaitliskam); detalizētu informāciju skatiet sadaļā Priekšapstrādes piemēri. Ja tipi nesakrīt, vienums pēc visu priekšapstrādes darbību izpildes joprojām var kļūt neatbalstīts. Lai pārbaudītu tipu neatbilstību, varat izmantot, piemēram, priekšapstrādes darbību Custom multiplier; skatiet Priekšapstrādes piemērus.
• Regulārās izteiksmes grupu tveršana tiek atbalstīta laukos Set value to vai Set error to. Izmantojiet \N (kur N=1…9), lai izgūtu N-to atbilstošo grupu; izmantojiet \0, lai izgūtu atbilstošo tekstu;
• Šīs darbības vienmēr tiek izpildītas kā pirmās priekšapstrādes darbības un pēc izmaiņu saglabāšanas vienumā tiek novietotas virs visām pārējām darbībām;
• Tiek atbalstītas vairākas Check for not supported value darbības norādītajā secībā. Darbība any error tiks automātiski novietota kā pēdējā darbība šajā grupā.

Atmest nemainīto

Atmest vērtību, ja tā nav mainījusies.

Komentāri:

• Ja vērtība tiek atmesta, tā netiek saglabāta datubāzē, un Zabbix serveris nezina, ka šī vērtība tika saņemta. Trigeru izteiksmes netiks novērtētas, un rezultātā saistītajiem trigeriem netiks izveidotas/atrisinātas nekādas problēmas. Funkcijas darbosies, tikai pamatojoties uz datiem, kas faktiski ir saglabāti datubāzē. Tā kā tendences tiek veidotas, pamatojoties uz datiem datubāzē, ja stundas laikā netiek saglabāta neviena vērtība, tad arī par šo stundu nebūs tendenču datu.
  
• Katram vienumam var norādīt tikai vienu ierobežošanas opciju.

Atmest nemainīto ar sirdspukstu

Atmest vērtību, ja tā nav mainījusies noteiktajā laika periodā (sekundēs).

Komentāri:

• Lai norādītu sekundes, tiek atbalstītas pozitīvas veselas vērtības (minimums - 1 sekunde);
  
• Var izmantot laika sufiksus (piemēram, 30s, 1m, 2h, 1d);
  
• Var izmantot lietotāja makro un zema līmeņa atklāšanas makro;
  
• Ja vērtība tiek atmesta, tā netiek saglabāta datubāzē, un Zabbix serveris nezina, ka šī vērtība ir saņemta. Trigeru izteiksmes netiks novērtētas, tāpēc saistītajiem trigeriem netiks izveidotas vai atrisinātas problēmas. Funkcijas darbosies tikai, pamatojoties uz datiem, kas faktiski saglabāti datubāzē. Tā kā tendenču dati tiek veidoti, pamatojoties uz datiem datubāzē, ja stundu nav saglabāta neviena vērtība, arī par šo stundu tendenču datu nebūs.
  
• Katram vienumam var norādīt tikai vienu ierobežošanas opciju.

Prometheus pattern

Izmantojiet šo vaicājumu, lai iegūtu nepieciešamos datus no Prometheus metrikām.

Skatiet Prometheus pārbaudes, lai iegūtu vairāk informācijas.

Prometheus uz JSON

Pārveido nepieciešamos Prometheus metriku datus JSON formātā.

Skatiet Prometheus pārbaudes, lai iegūtu vairāk informācijas.

Makrosu atbalsts

Tietotāja makrosi un lietotāja makrosi ar kontekstu tiek atbalstīti šeit:

• priekšapstrādes soļa parametros, tostarp JavaScript kodā;
• pielāgotās kļūdu apstrādes parametros (Set value to un Set error to laukos).

Testēšana

Skatiet priekšapstrādes testēšanu.