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

Pārskats

Priekšapstrāde ļauj piemērot pārveidojumus saņemtajām vienuma vērtībām pirms to saglabāšanas datubāzē. Šie pārveidojumi/priekšapstrādes soļi tiek izpildīti Zabbix serverī vai starpniekserverī (ja vienumus uzrauga starpniekserveris).

Šī iespēja 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 iegū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ākus priekšapstrādes soļus. Šie soļi tiek izpildīti 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 noteikti priekšapstrādes soļi vajadzības gadījumā var izraisīt agrāku pārveidošanu. Detalizētai tehniskai informācijai skatiet Priekšapstrādes 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 tiek definēti vienuma konfigurācijas formā 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 ir iespējams mainīt, neatstājot cilni Priekšapstrāde. Detalizētu parametru aprakstu skatiet sadaļā Vienuma izveide.

Atbalstītās transformācijas

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

Ņemiet vērā, ka Izmaiņas un Datu plūsmas ierobežošanas priekšapstrādes soļiem Zabbix ir jāatceras pēdējā vērtība, lai pēc nepieciešamības aprēķinātu/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 soļos tiek veiktas jebkādas izmaiņas, atbilstošā vienuma pēdējā vērtība tiek atiestatīta, kā rezultātā:

• Vienkāršas izmaiņas un Izmaiņas sekundē soļiem — nākamā vērtība tiks ignorēta, jo nav iepriekšējās vērtības, no kuras aprēķināt izmaiņu;
• Atmest nemainīgu un Atmest nemainīgu ar sirdspukstu soļiem — nākamā vērtība nekad netiks atmesta, pat ja saskaņā ar atmešanas noteikumiem tai vajadzētu tikt atmestai.

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. Atkāpju secība \N (kur N=1…9) tiek aizstāta ar N-to atrasto grupu. Atkāpju secība \0 tiek aizstāta ar atrasto tekstu.

Komentāri:

• Ja ievades vērtība neatbilst, vienums kļūs neatbalstīts;
  
• Regulārā izteiksme atbalsta ne vairāk kā 10 uztvertu grupu izvilkšanu ar \N secību;
  
• 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. Ja priekšapstrādes solis neizdodas, vienums nekļūs neatbalstīts, ja ir atlasīta opcija atmest vērtību vai iestatīt norādītu vērtību.
  
• Lūdzu, skatiet sadaļu regulārās izteiksmes, kur pieejami daži esoši piemēri.

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ūt 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;
  
• Vārdtelpas netiek atbalstītas;
  
• Ja atzīmējat izvēles rūtiņu Pielāgots kļūmes gadījumā, ir iespējams norādīt pielāgotas kļūdu apstrādes opcijas: vai nu atmest vērtību, iestatīt norādīto vērtību vai iestatīt norādīto kļūdas ziņojumu. Ja priekšapstrādes solis neizdodas, vienums nekļūs par neatbalstītu, ja ir atlasīta opcija atmest vērtību vai iestatīt norādīto vērtību.

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 Path

Izgūstiet 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. Ja priekšapstrādes solis neizdodas, vienums nekļūs par neatbalstītu, ja ir atlasīta opcija atmest vērtību vai iestatīt norādītu vērtību.

CSV uz JSON

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

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

XML uz JSON

Pārveido datus XML formātā uz JSON.

Papildinformāciju skatiet: Serializācijas noteikumi.

Ja atzīmējat izvēles rūtiņu Pielāgots kļūmes gadījumā, 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. Ja priekšapstrādes solis neizdodas, vienums nekļūs par neatbalstītu, ja ir atlasīta opcija atmest vērtību vai iestatīt norādītu vērtību.

SNMP walk vērtība

Izgūt vērtību pēc norādītā OID/MIB nosaukuma un piemērot formatēšanas opcijas:

• Bez izmaiņām - atgriezt heksadecimālo virkni kā neekranētu heksadecimālo virkni (ņemiet vērā, ka attēlošanas norādes joprojām tiek piemērotas);
  
• 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 korektu MAC adreses virkni (kur ' ' tiek aizstātas ar ':');
  
• Vesels skaitlis no BITS - pārveidot pirmos 8 baitus bitu virknei, kas izteikta kā heksadecimālo 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īto vērtību vai iestatīt norādīto kļūdas ziņojumu. Ja priekšapstrādes solis neizdodas, vienums nekļūs par neatbalstītu, ja ir atlasīta opcija atmest vērtību vai iestatīt norādīto vērtību.

SNMP walk uz JSON

Pārveido SNMP vērtības uz JSON.

Norādiet lauka nosaukumu JSON formātā 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ā solī SNMP walk value;
  
• Jūs varat izmantot šo priekšapstrādes soli SNMP OID atklāšanai;
  
• 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īto vērtību vai iestatīt norādīto kļūdas ziņojumu. Ja priekšapstrādes solis neizdodas, vienums nekļūs par neatbalstītu, ja ir atlasīta opcija atmest vērtību vai iestatīt norādīto vērtību.

SNMP iegūtā vērtība

Pielietojiet formatēšanas opcijas SNMP iegūtajai vērtībai:

• UTF-8 no Hex-STRING - pārveidot hex-virkni par UTF-8 virkni;
  
• MAC no Hex-STRING - validēt hex-virkni kā MAC adresi un atgriezt korektu MAC adreses virkni (kur ' ' tiek aizstātas ar ':');
  
• Vesels skaitlis no BITS - pārveidot pirmos 8 baitus bitu virknei, 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, turpmākie baiti tiks ignorēti.

Ja atzīmējat izvēles rūtiņu Pielāgots kļūmes gadījumā, ir iespējams norādīt pielāgotas kļūdu apstrādes opcijas: vai nu atmest vērtību, iestatīt norādīto vērtību vai iestatīt norādīto kļūdas ziņojumu. Neveiksmīga priekšapstrādes soļa gadījumā vienums nekļūs neatbalstīts, ja ir atlasīta opcija atmest vērtību vai iestatīt norādīto vērtību.

Pielāgots reizinātājs

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

Komentāri:

• Izmantojiet šo opciju, lai pārvērstu saņemtās vērtības 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ā, ka, ja vienuma informācijas tips ir Numeric (unsigned), ienākošajām vērtībām ar daļskaitļa daļu tā tiks noņemta (t.i., '0.9' kļūs par '0') pirms pielāgotā reizinātāja piemērošanas;
  
• Ja izmantojat pielāgotu reizinātāju vai saglabājat vērtību kā Change per second vienumiem, kuriem 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ā korekta, 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 ir jāatrisinās par veselu skaitli vai peldošā komata skaitli.
• 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. Neveiksmīga priekšapstrādes soļa gadījumā vienums nekļūs neatbalstīts, ja ir atlasīta opcija atmest vērtību vai iestatīt norādītu vērtību.

Vienkārša izmaiņa

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 — pašreizējā vērtība; prev_value — iepriekš saņemtā vērtība;
  
• Katram vienumam ir atļauta tikai viena izmaiņas operācija ("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 citu vērtību;
  
• 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. Neveiksmīga priekšapstrādes soļa gadījumā vienums nekļūs par neatbalstītu, ja ir atlasīta opcija atmest vērtību vai iestatīt norādītu vērtību.

Izmaiņa sekundē

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

Komentāri:

• Šis solis ir noderīgs, lai aprēķinātu pastāvīgi augošas vērtības pieauguma ātrumu sekundē;
  
• Tā kā šis aprēķins var radīt peldošā komata skaitļus, ieteicams iestatīt 'Type of information' uz Numeric (float), pat ja ienākošās neapstrādātās vērtības ir veseli skaitļi. Tas ir īpaši svarīgi maziem skaitļiem, kur nozīme ir decimāldaļai. Ja peldošā komata vērtības ir lielas un var pārsniegt 'float' lauka garumu, kā rezultātā visa vērtība var tikt zaudēta, faktiski ieteicams izmantot Numeric (unsigned) un tādējādi nogriezt tikai decimāldaļu.
  
• Tiek novērtēts 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īmogs;
  
• Katram vienums ir atļauta tikai viena izmaiņu operācija ("Simple change" vai "Change per second");
• Ja pašreizējā vērtība ir mazāka par iepriekšējo vērtību, Zabbix atmet šo starpību (neko nesaglabā) un gaida nākamo vērtību. Tas palīdz korekti strādāt, piemēram, ar 32 bitu SNMP skaitītāju pārgriešanos (pārpildi).
  
• 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. Neveiksmīga priekšapstrādes soļa gadījumā vienums nekļūs par neatbalstītu, ja ir atlasīta opcija atmest vērtību vai iestatīt norādītu vērtību.

Būla vērtības pārveidošana decimālskaitlī

Pārveido vērtību no būla formāta uz decimālskaitli.

Komentāri:

• Tekstuālais attēlojums tiek pārveidots par 0 vai 1. Tādējādi 'TRUE' tiek saglabāts kā 1 un 'FALSE' tiek saglabāts kā 0. Visas vērtības tiek salīdzinātas, neņemot vērā burtu 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. Papildus tam jebkura skaitliska vērtība, kas nav nulle, tiek uzskatīta par TRUE, bet nulle tiek uzskatīta par FALSE.
  
• 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. Ja priekšapstrādes solis neizdodas, vienums nekļūs neatbalstīts, ja ir atlasīta opcija atmest vērtību vai iestatīt norādītu vērtību.

Oktālais uz decimālo

Pārveido vērtību no oktālā formāta uz decimālo.

Ja atzīmējat izvēles rūtiņu Pielāgots kļūmes gadījumā, 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. Ja priekšapstrādes solis neizdodas, vienums nekļūs neatbalstīts, ja ir atlasīta opcija atmest vērtību vai iestatīt norādītu vērtību.

No heksadecimālā uz decimālo

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

Ja atzīmējat izvēles rūtiņu Pielāgots kļūmes gadījumā, ir iespējams norādīt pielāgotas kļūdu apstrādes opcijas: vai nu atmest vērtību, iestatīt norādīto vērtību vai iestatīt norādīto kļūdas ziņojumu. Ja priekšapstrādes solis neizdodas, vienums nekļūs par neatbalstītu, ja ir atlasīta opcija atmest vērtību vai iestatīt norādīto vērtību.

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ā vērtībai jāatrodas, norādot minimālo/maksimālo vērtību (ieskaitot robežvērtības).

Komentāri:

• Tiek pieņemtas skaitliskas vērtības (ieskaitot jebkādu ciparu skaitu, neobligātu decimāldaļu un neobligātu eksponentdaļu, kā arī 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 makrosus un zema līmeņa atklāšanas makrosus;
  
• Ja atzīmējat izvēles rūtiņu Pielāgots kļūmes gadījumā, 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.

Ja priekšapstrādes solis neizdodas, vienums nekļūs neatbalstīts, ja ir atlasīta opcija atmest vērtību vai iestatīt norādītu vērtību.

Atbilst regulārajai izteiksmei

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

Ja atzīmējat izvēles rūtiņu Pielāgots kļūmes gadījumā, 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. Neveiksmīga priekšapstrādes soļa gadījumā vienums nekļūs neatbalstīts, ja ir atlasīta opcija atmest vērtību vai iestatīt norādītu vērtību.

Neatbilst regulārajai izteiksmei

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

Ja atzīmējat izvēles rūtiņu Pielāgots kļūmes gadījumā, ir iespējams norādīt pielāgotas kļūdu apstrādes opcijas: vai nu atmest vērtību, iestatīt norādīto vērtību vai iestatīt norādīto kļūdas ziņojumu. Neveiksmīga priekšapstrādes soļa gadījumā vienums nekļūs par neatbalstītu, ja ir atlasīta opcija atmest vērtību vai iestatīt norādīto vērtību.

Kļūdas pārbaude JSON formātā

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

Komentāri:

• Šīs ārējo pakalpojumu kļūdas lietotājam tiek parādītas tādas, kādas tās ir, nepievienojot informāciju par priekšapstrādes darbību;
  
• Kļūda netiks ziņota, ja neizdosies parsēt nederīgu JSON;
  
• Ja atzīmējat izvēles rūtiņu Pielāgots kļūmes gadījumā, ir iespējams norādīt pielāgotas kļūdu apstrādes opcijas: vai nu atmest vērtību, iestatīt norādīto vērtību vai iestatīt norādīto kļūdas ziņojumu. Neveiksmīgas priekšapstrādes darbības gadījumā vienums nekļūs neatbalstīts, ja ir atlasīta opcija atmest vērtību vai iestatīt norādīto vērtību.

Kļūdas pārbaude XML failā

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

Komentāri:

• Šīs ārējo pakalpojumu kļūdas lietotājam tiek parādītas tādas, kādas tās ir, nepievienojot informāciju par priekšapstrādes darbību;
  
• Kļūda netiks ziņota, ja neizdosies parsēt nederīgu XML;
  
• Ja atzīmējat izvēles rūtiņu Pielāgots kļūmes gadījumā, 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. Ja priekšapstrādes darbība neizdodas, vienums nekļūs neatbalstīts, ja ir atlasīta opcija atmest vērtību vai iestatīt norādītu vērtību.

Kļūdas 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, kāda bija pirms šīs priekšapstrādes darbības.

Parametri:

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

Komentāri:

• Šīs ārējo pakalpojumu 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 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. Neveiksmīgas priekšapstrādes darbības gadījumā vienums nekļūs par neatbalstītu, ja ir atlasīta opcija atmest vērtību vai iestatīt norādītu vērtību.

Nepārbaudītas vērtības pārbaude

Pārbaudiet, vai nevarēja iegūt nevienu vienuma vērtību. Norādiet, kā kļūme jāapstrādā, pamatojoties uz atgrieztā kļūdas ziņojuma pārbaudi.

Parametri:

• scope - atlasiet kļūdu apstrādes tvērumu:
  jebkura kļūda - jebkura kļūda;
  kļūda atbilst - tikai kļūda, kas atbilst regulārajai izteiksmei, kas norādīta laukā pattern;
  kļūda neatbilst - tikai kļūda, kas neatbilst regulārajai izteiksmei, kas norādīta laukā pattern
  
• pattern - regulārā izteiksme, ar kuru salīdzināt kļūdu. Ja parametrā scope ir atlasīts jebkura kļūda, šis lauks netiek parādīts. Ja tas tiek parādīts, šis lauks ir obligāts.
  

Komentāri:

• Parasti vērtības neesamība/neizdošanās to iegūt noved pie tā, ka vienums kļūst neatbalstīts. Šī priekšapstrādes darbība ļauj mainīt šo uzvedību. Ja atzīmējat izvēles rūtiņu Custom on fail (šai priekšapstrādes darbībai tā vienmēr ir atzīmēta un pelēkota), 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. Ja priekšapstrādes darbība neizdodas, vienums nekļūs neatbalstīts, ja ir atlasīta opcija atmest vērtību vai iestatīt norādītu vērtību.
• Šī priekšapstrādes darbība pārbauda tikai to, vai nevarēja iegūt nevienu vienuma vērtību. Tā nepārbauda, piemēram, vai iegūtās vērtības tips (piemēram, virkne) atbilst vienuma informācijas tipam (piemēram, skaitlisks); sīkāku informāciju skatiet sadaļā Priekšapstrādes piemēri. Ja ir tipu neatbilstība, vienums joprojām var kļūt neatbalstīts pēc visu priekšapstrādes darbību izpildes. 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āro izteiksmju grupu uztveršana tiek atbalstīta laukos Set value to vai Set error to. Izmantojiet \N (kur N=1…9), lai iegūtu N-to atbilstošo grupu; izmantojiet \0, lai iegū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;
• Tiek atbalstītas vairākas darbības Nepārbaudītas vērtības pārbaude norādītajā secībā. Darbība jebkura kļūda 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īgu ar sirdspukstu

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

Komentāri:

• Tiek atbalstītas pozitīvas veselu skaitļu vērtības, lai norādītu sekundes (minimums — 1 sekunde);
  
• Var izmantot laika sufiksus (piemēram, 30s, 1m, 2h, 1d);
  
• Var izmantot lietotāja makrosus un zema līmeņa atklāšanas makrosus;
  
• Ja vērtība tiek atmesta, tā netiek saglabāta datubāzē, un Zabbix serveris nezina, ka šī vērtība tika saņemta. Netiks novērtētas nekādas trigeru izteiksmes, 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 droselēšanas opciju.

Prometheus raksts

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

Plašāku informāciju skatiet sadaļā Prometheus pārbaudes.

Prometheus uz JSON

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

Plašāku informāciju skatiet sadaļā Prometheus checks.

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.