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 soļi ir definēti vienuma konfigurācijas formas cilnē Priekšapstrāde.

Noklikšķiniet uz Pievienot, lai atlasītu atbalstītu transformāciju.

Lauks Informācijas tips tiek parādīts cilnes apakšdaļā, kad ir definēts vismaz viens priekšapstrādes solis. Ja nepieciešams, informācijas tipu var mainīt, neatstājot cilni Priekšapstrāde. 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 netiks atzīmēts kā neatbalstīts, ja ir 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 tverto grupu izgūšanu, izmantojot secību \N;
  
• Dažus esošus 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

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

Komentāri:

• Lai šī opcija darbotos, Zabbix serveris (vai Zabbix starpniekserveris) ir jākompilē ar libxml atbalstu;
  
• Nosaukumvietas netiek atbalstītas.

Piemēri:

number(/document/item/value) #izgūs '10' no <document><item><value>10</value></item></document>
number(/document/item/@attribute) #izgūs '10' no <document><item attribute="10"></item></document>
/document/item #izgūs '<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ē 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 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 secība (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šās vērtības ar daļskaitli pirms pielāgotā reizinātāja lietošanas tiks noapaļotas, atmetot daļskaitli (t. i., “0.9” kļūs par “0”);
  
• Ja vienumiem, kuru informācijas tips ir Numeric (unsigned), izmantojat pielāgotu reizinātāju vai saglabājat vērtību kā Change per second 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, atmetot decimāldaļu un saglabājot vērtību kā veselu skaitli;
  
• Tiek atbalstīta zinātniskā notācija, 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 pieaugošu vērtību;
  
• Aprēķins tiek veikts kā value-prev_value, kur value ir pašreizējā vērtība, bet prev_value ir iepriekš saņemtā vērtība;
  
• Katram 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 pieauguma ātrumu sekundē;
  
• Tā kā šis aprēķins var radīt peldošā komata skaitļus, ieteicams iestatīt “Informācijas tips” uz Skaitlisks (peldošais komats), 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ā var tikt zaudēta visa vērtība, ieteicams izmantot Skaitlisks (bez zīmes) un tādējādi noapaļot tikai decimāldaļu;
  
• Aprēķins tiek veikts kā (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;
  
• Katram vienumam ir atļauta tikai viena izmaiņas darbība (“Vienkārša izmaiņa” vai “Izmaiņa sekundē”);
• 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ības pārveidošana decimālskaitlī

Pārveidojiet vērtību no Būla formāta uz decimālformā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” — 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 — true, t, yes, y, on, up, running, enabled, available, ok, master; FALSE — 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āiekļaujas 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 (jebkurš ciparu skaits, neobligāta decimāldaļa un neobligāta eksponentes daļa, negatīvas vērtības);
  
• Minimālajai vērtībai jābūt mazākai par maksimālo;
  
• Jābūt 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 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 nederīgu JSON datu parsēšana neizdodas, kļūda netiek ziņota.

Kļūdas pārbaude XML

Pārbaudīt lietojumprogrammas līmeņa kļūdas ziņojumu, kas atrodas XPath. Pārtraukt 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, kas bija 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 XML, kļūda netiks ziņota.

Kļūdu pārbaude, izmantojot regulāro izteiksmi

Pārbaudiet lietojumprogrammas līmeņa kļūdas ziņojumu, izmantojot regulāro izteiksmi.
Pārtrauciet apstrādi, ja pārbaude ir veiksmīga un ziņojums nav tukšs; pretējā gadījumā turpiniet apstrādi 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, vai vērtība netiek atbalstīta

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 šis lauks tiek parādīts, tas ir obligāts.
  

Komentāri:

• Parasti nespēja izgūt vērtību vai tās neesamība izraisa vienuma statusa maiņu uz “neatbalstīts”. Šī 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, vienuma statuss pēc visu priekšapstrādes darbību izpildes joprojām var tikt mainīts uz “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ēri.
• 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ā noteiktajā laika periodā (sekundēs) nav mainījusies.

Komentāri:

• Sekunžu norādīšanai 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.