2 Претходна обрада вредности ставке

Преглед

Претходна обрада вам омогућава да примените трансформације на примљене вредности ставки пре него што их сачувате у базу података. Ове трансформације/кораке претходне обраде извршава Zabbix сервер или прокси (ако се ставке прате путем проксија).

Ова функција подржава различите случајеве употребе, као што су:

• претварање бајтова у битове (нпр. множење вредности мрежног саобраћаја са "8");
• израчунавање статистике по секунди за постепено повећање вредности;
• примена регуларних израза за издвајање или модификовање вредности;
• извршавање прилагођених скрипти на вредностима;
• одбацивање непромењених вредности ради оптимизације складиштења базе података.

За ставку се може конфигурисати један или више корака претходне обраде. Ови кораци се извршавају редоследом којим су конфигурисани.

Све вредности прослеђене претходној обради се иницијално третирају као стрингови. Конверзија у жељени тип вредности (као што је дефинисано у конфигурацији ставке) се врши на крају цевовода претходне обраде. Међутим, одређени кораци претходне обраде могу покренути раније конверзије, ако је потребно. За детаљне техничке информације, погледајте Детаљи претходне обраде.

Да бисте били сигурни да ваша конфигурација претходне обраде функционише како се очекује, можете је тестирати.

Погледајте такође: Примери претходне обраде

Конфигурација

Кораци претходне обраде су дефинисани на картици Претходна обрада ставке конфигурација образац.

Кликните на Додај да бисте изабрали подржану трансформацију.

Поље Врста информација је приказано на дну таб када је дефинисан бар један корак претходне обраде. Ако је потребно, јесте могуће је променити врсту информација без напуштања Картица Претходна обрада. Погледајте Креирање ставке за детаљан опис параметара.

Подржане трансформације

Све подржане трансформације су наведене у наставку. Кликните на назив трансформације да бисте видели све детаље о њој.

|Octal to decimal|Претворите вредност из окталног формата у децимални.|^| |Hexadecimal to decimal|Претворите вредност из хексадецималног формата у децимални.|^| |JavaScript|Унесите ЈаваСкрипт код.|Прилагођени скриптови| |[In range]](#inrange)|Дефинишите опсег у коме вредност треба да буде.|Валидација| |Matches regular expression|Наведите регуларни израз са којим се вредност мора подударати.|^| |Does not match regular expression|Наведите регуларни израз са којим се вредност не сме подударати.|^| |[Check for error in JSON]](#errorinjson)|Провери поруку о грешци на нивоу апликације која се налази на JSONPath.|^| |Check for error in XML|Провери поруку о грешци на нивоу апликације која се налази на XPath.|^| |Check for error using a regular expression|Провери поруку о грешци на нивоу апликације користећи регуларни израз.|^| |Check for not supported value|Провери да ли се ниједна вредност ставке не може преузети.|^| |Discard unchanged|Одбаци вредност ако се није променила.|Успоравање| |Discard unchanged with heartbeat|Одбаци вредност ако се није променила у дефинисаном временском периоду.|^| |[Prometheus pattern]](#prometheus)|Користите следећи упит да бисте извукли потребне податке из Прометеус метрике.|Прометеус| |Prometheus to JSON|Конвертујте потребне Прометеус метрике у JSON.|^|

Имајте на уму да за кораке претходне обраде Промена и Успоравање, Zabbix мора да запамти последњу вредност да би израчунао/упоредио нову вредност како је потребно. Ове претходне вредности обрађује менаџер претходне обраде. Ако се Zabbix сервер или прокси поново покрене или дође до било какве промене у корацима претходне обраде, последња вредност одговарајуће ставке се ресетује, што резултира:

• за кораке Једноставна промена, Промена по секунди - следећа вредност ће бити игнорисана јер нема претходне вредности за израчунавање промене из;
• за кораке Одбаци непромењено, Одбаци непромењено са откуцајима срца - следећа вредност никада неће бити одбачена, чак и ако је требало да буде због правила одбацивања.

Регуларни израз

Ускладите вредност са регуларним изразом и замените је потребним излазом.

Параметри:

• шаблон - регуларни израз;
  
• излаз - шаблон за форматирање излаза. Ескејп секвенца \N (где је N=1…9) замењује се N-том подударном групом. Ескејп секвенца \0 замењује се подударним текстом.

Коментари:

• Неуспех у подударању са улазном вредношћу учиниће ставку неподржаном;
  
• Регуларни израз подржава издвајање највише 10 снимљених група са секвенцом \N;
  
• Ако означите поље за потврду Прилагођено при неуспеху, могуће је навести прилагођене опције за руковање грешкама: или одбацити вредност, подесити одређену вредност или подесити одређену поруку о грешци. У случају неуспешног корака претходне обраде, ставка неће постати неподржана ако је изабрана опција за одбацивање вредности или постављање одређене вредности.
  
• Молимо погледајте одељак регуларни изрази за неке постојеће примере.

Замени

Пронађите стринг за претрагу и замените га другим (или ништа).

Параметри:

• search string - стринг за проналажење и замену, разликује велика и мала слова (обавезно);
  
• replacement - стринг којим ће се заменити стринг за претрагу. Низ за замену такође може бити празан што омогућава брисање стринга за претрагу када се пронађе.

Коментари:

• Сва појављивања стринга за претрагу ће бити замењена;
• Могуће је користити есцапе секвенце за тражење или замену прелома редова, враћања носиоца, табулатора и размака "\n \r \t \s"; обрнута коса црта се може избећи као "\\", а излазне секвенце се могу избећи као "\\n";
• Бежање од линије паузе, повратак кочије, картице се аутоматски врши током откривања ниског нивоа.

Трим

Уклоните наведене знакове са почетка и краја вредности.

Десни трим

Уклоните наведене знакове са краја вредности.

Леви оквир

Уклоните наведене знакове са почетка вредности.

XML XPath

Извуците вредност или фрагмент из XML података користећи XPath функционалност.

Коментари:

• Да би ова опција радила, Zabbix сервер (или Zabbix прокси) мора бити компајлиран са подршком за либкмл;
  
• Простори имена нису подржани;
  
• Ако означите поље за потврду Прилагођено при неуспеху, могуће је навести прилагођене опције за руковање грешкама: или да одбаците вредност, поставите одређену вредност или поставите одређену поруку о грешци. У случају неуспелог корака претходне обраде, ставка неће постати неподржана ако је изабрана опција за одбацивање вредности или постављање одређене вредности.

Примери:

number(/document/item/value) #will издвојити '10' из <document><item><value>10</value></item></document>
       number(/document/item/@attribute) #will издвојити '10' из  <document><item attribute="10"></item></document>/document/item #will издвојити '<item><value>10</value></item>' из <document><item><value>10</value></item></document>

JSON путања

Извуците вредност или фрагмент из JSON података помоћу JSONPath функционалност.

Ако означите поље за потврду Прилагођено при неуспеху, могуће је навести прилагођене опције за руковање грешкама: или да одбаците вредност, поставите одређену вредност или поставите одређену поруку о грешци. У случају неуспелог корака претходне обраде, ставка неће постати неподржана ако је изабрана опција за одбацивање вредности или постављање одређене вредности.

CSV у JSON

Конвертујте податке CSV датотеке у JSON формат.

За више информација погледајте: Претходна обрада CSV у JSON.

XML у JSON

Конвертујте податке у XML формату у JSON.

За више информација погледајте: Правила серијализације.

Ако означите поље за потврду Прилагођено при неуспеху, могуће је навести прилагођене опције за руковање грешкама: или да одбаците вредност, поставите одређену вредност или поставите одређену поруку о грешци. У случају неуспелог корака претходне обраде, ставка неће постати неподржана ако је изабрана опција за одбацивање вредности или постављање одређене вредности.

Вредност SNMP шетње

Издвоји вредност према наведеном OID/MIB имену и примени опције форматирања:

• Unchanged - врати хексадецимални стринг као неекскапирани хексадецимални стринг (напомена да се и даље примењују савети за приказивање);
  
• UTF-8 from hex-STRING - конвертуј хексадецимални стринг у UTF-8 стринг;
  
• MAC from hex-STRING - потврди хексадецимални стринг као MAC адресу и врати исправан MAC адресни стринг (где су ' ' замењени са ':');
  
• Integer from BITS - конвертуј првих 8 бајтова битовског стринга израженог као низ хексадецималних знакова (нпр. "1A 2B 3C 4D") у 64-битни неозначени цео број. У битовским стринговима дужим од 8 бајтова, наредни бајтови ће бити игнорисани.

Ако означите поље за потврду Прилагођено при неуспеху, могуће је навести прилагођене опције за руковање грешкама: или одбацивање вредности, постављање одређене вредности или постављање одређене поруке о грешци. У случају неуспелог корака претходне обраде, ставка неће постати неподржана ако је изабрана опција за одбацивање вредности или постављање одређене вредности.

SNMP хода до JSON

Конвертујте SNMP вредности у JSON.

Наведите име поља у JSON-у и одговарајућу SNMP OID путању. Вредности поља ће бити попуњене вредностима у наведеној SNMP OID путањи.

Коментари:

• Доступне су сличне опције форматирања вредности као у кораку SNMP вредност хода;
  – Можете да користите овај корак претходне обраде за SNMP OID откривање;
  
• Ако означите поље за потврду Прилагођено при неуспеху, могуће је навести прилагођене опције за руковање грешкама: или да одбаците вредност, поставите одређену вредност или поставите одређену поруку о грешци. У случају неуспелог корака претходне обраде, ставка неће постати неподржана ако је изабрана опција за одбацивање вредности или постављање одређене вредности.

SNMP вредност за добијање

Примените опције форматирања на SNMP вредност за добијање:

• UTF-8 из Hex-STRING - конвертује hex-стринг у UTF-8 стринг;
  
• MAC из Hex-STRING - валидира hex-стринг као MAC адресу и враћа исправан стринг MAC адресе (где су ' ' замењени са ':');
  
• Цео број из BITS - конвертује првих 8 бајтова битовског стринга израженог као низ хексадецималних знакова (нпр., "1A 2B 3C 4D") у 64-битни неозначени цео број. У битовским стринговима дужим од 8 бајтова, наредни бајтови ће бити игнорисани.

Ако означите поље за потврду Прилагођено при неуспеху, могуће је одредити прилагођене опције за руковање грешкама: или одбацити вредност, подесити одређену вредност или подесити одређену поруку о грешци. У случају неуспешног корака претходне обраде, ставка неће постати неподржана ако је изабрана опција за одбацивање вредности или постављање одређене вредности.

Прилагођени множилац

Помножите вредност са наведеним целим бројем или вредношћу са покретним зарезом.

Коментари:

• Користите ову опцију да бисте конвертовали вредности примљене у KB, MBps итд. у B, Bps. У супротном, Zabbix не може правилно да подеси префиксе (K, M, G, итд.).
  
• Имајте на уму да ако је тип информација ставке Нумерички (непотписан), долазне вредности са разломљеним делом ће бити скраћене (тј. '0,9' ће постати '0') пре него што се примени прилагођени множилац;
  
• Ако користите прилагођени множилац или сачувате вредност као Промена у секунди за ставке са типом информација подешеним на Нумерички (непотписан) и резултујућа израчуната вредност је заправо број са покретним зарезом, израчуната вредност се и даље прихвата као исправна скраћивањем децималног дела и чувањем вредности као целог броја;
  
• Подржано: научна нотација, на пример, 1e+70; кориснички макрои и LLD макрои; стрингови који садрже макрое, на пример, {#MACRO}e+10, {$MACRO1}e+{$MACRO2}. Макрои морају бити цео број или број са покретним зарезом.
• Ако означите поље за потврду Прилагођено при неуспеху, могуће је навести прилагођене опције за руковање грешкама: или одбацивање вредности, постављање одређене вредности или постављање одређене поруке о грешци. У случају неуспелог корака претходне обраде, ставка неће постати неподржана ако је изабрана опција за одбацивање вредности или постављање одређене вредности.

Једноставна промена

Израчунајте разлику између тренутне и претходне вредности.

Коментари:

• Овај корак може бити користан за мерење вредности која стално расте;
  
• Процењује се као value-prev_value, где је value - тренутна вредност; prev_value - претходно примљена вредност;
  
• Дозвољена је само једна операција промене по ставци ("Једноставна промена" или "Промена у секунди");
• Ако је тренутна вредност мања од претходне вредности, Zabbix одбацује ту разлику (ништа не складишти) и чека другу вредност;
  
• Ако означите поље за потврду Прилагођено при неуспеху, могуће је навести прилагођене опције за руковање грешкама: или да одбаците вредност, поставите одређену вредност или поставите одређену поруку о грешци. У случају неуспелог корака претходне обраде, ставка неће постати неподржана ако је изабрана опција за одбацивање вредности или постављање одређене вредности.

Промена у секунди

Израчунајте брзину промене вредности (разлике између тренутне и претходне вредности) у секунди.

Коментари:

• Овај корак је користан за израчунавање брзине у секунди стално растуће вредности;
  
• Пошто овај прорачун може произвести бројеве са покретним зарезом, препоручује се да подесите 'Тип информација' на Нумеричко (float), чак и ако су долазне сирове вредности цели бројеви. Ово је посебно релевантно за мале бројеве где је децимални део важан. Ако су вредности са покретним зарезом велике и могу прећи дужину поља 'float', у ком случају се цела вредност може изгубити, заправо се препоручује да се користи Нумеричко (без знака) и тако се скрати само децимални део.
  
• Израчунава се као (value-prev_value)/(time-prev_time), где је вредност - тренутна вредност; prev_value - претходно примљена вредност; време - тренутна временска ознака; prev_time - временска ознака претходне вредности;
  
• Дозвољена је само једна операција промене по ставци ("Једноставна промена" или "Промена по секунди");
• Ако је тренутна вредност мања од претходне вредности, Zabbix одбацује ту разлику (не чува ништа) и чека другу вредност. Ово помаже у исправном раду са, на пример, преклапањем (препуњавањем) 32-битних SNMP бројача.
  
• Ако означите поље за потврду Прилагођено при неуспеху, могуће је одредити прилагођене опције за руковање грешкама: или одбацити вредност, подесити одређену вредност или подесити одређену поруку о грешци. У случају неуспелог корака претходне обраде, ставка неће постати неподржана ако је изабрана опција за одбацивање вредности или постављање одређене вредности.

Логички у децимални

Претворите вредност из логичког формата у децимални.

Коментари:

• Текстуални приказ се преводи у 0 или 1. Дакле, 'TRUE' се чува као 1, а 'FALSE' се чува као 0. Све вредности се подударају на начин без обзира на велика и мала слова. Тренутно препознате вредности су, за TRUE - true, t, yes, y, on, up, running, enabled, available, ok, master; за FALSE - false, f, no, n, off, down, unused, disabled, unavailable, err, slave. Поред тога, свака нумеричка вредност различита од нуле сматра се TRUE, а нула се сматра FALSE.
  
• Ако означите поље за потврду Прилагођено при неуспеху, могуће је навести прилагођене опције за руковање грешкама: или да одбаците вредност, поставите одређену вредност или поставите одређену поруку о грешци. У случају неуспелог корака претходне обраде, ставка неће постати неподржана ако је изабрана опција за одбацивање вредности или постављање одређене вредности.

октално до децимално

Претворите вредност из окталног формата у децимални.

Ако означите поље за потврду Прилагођено при неуспеху, могуће је навести прилагођене опције за руковање грешкама: или да одбаците вредност, поставите одређену вредност или поставите одређену поруку о грешци. У случају неуспелог корака претходне обраде, ставка неће постати неподржана ако је изабрана опција за одбацивање вредности или постављање одређене вредности.

Хексадецимално у децимално

Претворите вредност из хексадецималног формата у децимални.

Ако означите поље за потврду Прилагођено при неуспеху, могуће је навести прилагођене опције за руковање грешкама: или да одбаците вредност, поставите одређену вредност или поставите одређену поруку о грешци. У случају неуспелог корака претходне обраде, ставка неће постати неподржана ако је изабрана опција за одбацивање вредности или постављање одређене вредности.

JavaScript

Унесите JavaScript код у модални едитор који се отвара кликом на поље параметра или на икону оловке поред њега.

Коментари:

• Доступна дужина JavaScript кода зависи од коришћене базе података;
  
• За више информација погледајте: Претходна обрада JavaScript-а.

У опсегу

Дефинишите опсег у коме вредност треба да буде тако што ћете навести минималне/максималне вредности (укључиво).

Коментари:

– Нумеричке вредности су прихваћене (укључујући било који број цифара, опциони децимални део и опциони експоненцијални део, негативне вредности);
- Минимална вредност треба да буде мања од максималне;
- Мора постојати најмање једна вредност;
- Могу се користити кориснички макрои и макрои за откривање ниског нивоа;
- Ако означите поље за потврду Прилагођено при неуспеху, могуће је навести прилагођене опције за руковање грешкама: или да одбаците вредност, поставите одређену вредност или поставите одређену поруку о грешци. У случају неуспелог корака претходне обраде, ставка неће постати неподржана ако је изабрана опција за одбацивање вредности или постављање одређене вредности.

Одговара регуларном изразу

Наведите регуларни израз са којим вредност мора да одговара.

Ако означите поље за потврду Прилагођено при неуспеху, могуће је навести прилагођене опције за руковање грешкама: или да одбаците вредност, поставите одређену вредност или поставите одређену поруку о грешци. У случају неуспелог корака предобраде, ставка неће постати неподржана ако је изабрана опција за одбацивање вредности или постављање одређене вредности.

Не подудара се са регуларним изразом

Наведите регуларни израз са којим вредност не сме да се подудара.

Ако означите поље за потврду Прилагођено при неуспеху, могуће је навести прилагођене опције за руковање грешкама: или да одбаците вредност, поставите одређену вредност или поставите одређену поруку о грешци. У случају неуспелог корака претходне обраде, ставка неће постати неподржана ако је изабрана опција за одбацивање вредности или постављање одређене вредности.

Проверите да ли постоји грешка у JSON-у

Проверите да ли се порука о грешци на нивоу апликације налази на JSONPath-у. Зауставите обраду ако је успела и порука није празна; у супротном, наставите са обрадом са вредношћу која је била пре овог корака претходне обраде.

Коментари:

• Ове грешке екстерне услуге се пријављују кориснику какве јесу, без додавања информација о кораку претходне обраде;
  
• Неће бити пријављена грешка у случају неуспеха да се рашчлани неважећи JSON;
  
• Ако означите поље за потврду Прилагођено при неуспеху, могуће је навести прилагођене опције за руковање грешкама: или да одбаците вредност, поставите одређену вредност или поставите одређену поруку о грешци. У случају неуспелог корака претходне обраде, ставка неће постати неподржана ако је изабрана опција за одбацивање вредности или постављање одређене вредности.

Проверите да ли постоји грешка у XML-у

Проверите да ли се порука о грешци на нивоу апликације налази на XPath-у. Зауставите обраду ако је успела и порука није празна; у супротном, наставите са обрадом са вредношћу која је била пре овог корака претходне обраде.

Коментари:

• Ове грешке екстерне услуге се пријављују кориснику какве јесу, без додавања информација о кораку претходне обраде;
  
• Неће бити пријављена грешка у случају неуспеха у рашчлањивању неважећег XML-а;
  
• Ако означите поље за потврду Прилагођено при неуспеху, могуће је навести прилагођене опције за руковање грешкама: или да одбаците вредност, поставите одређену вредност или поставите одређену поруку о грешци. У случају неуспелог корака претходне обраде, ставка неће постати неподржана ако је изабрана опција за одбацивање вредности или постављање одређене вредности.

Проверите да ли постоји грешка користећи регуларни израз

Проверите да ли постоји порука о грешци на нивоу апликације користећи регуларни израз. Зауставите обраду ако је успела и порука није празна; у супротном, наставите са обрадом са вредношћу која је била пре овог корака предобрадe.

Параметри:

• pattern - регуларни израз;
  
• output - шаблон за форматирање излаза. \N (где је N=1…9) излазна секвенца је замењена Н-том подударном групом. \0 излазна секвенца је замењена одговарајућим текстом.

Коментари:

• Ове грешке екстерне услуге се пријављују кориснику какве јесу, без додавања информација о кораку претходне обраде;
  
• Ако означите поље за потврду Прилагођено при неуспеху, могуће је навести прилагођене опције за руковање грешкама: или да одбаците вредност, поставите одређену вредност или поставите одређену поруку о грешци. У случају неуспелог корака претходне обраде, ставка неће постати неподржана ако је изабрана опција за одбацивање вредности или постављање одређене вредности.

Провери вредност која није подржана

Провери да ли се вредност ставке не може преузети. Наведи како треба обрадити грешку, на основу прегледа враћене поруке о грешци.

Параметри:

• ** scope** - изаберите обхват обраде грешке:
  било која грешка - било која грешка;
  грешка се подудара - само грешка која се подудара са регуларним изразом наведеним у шаблон;
  грешка се не подудара - само грешка која се не подудара са регуларним изразом наведеним у шаблон
  
• ** pattern** - регуларни израз са којим се грешка подудара. Ако је у параметру обхвата изабрано било која грешка, ово поље се не приказује. Ако се приказује, ово поље је обавезно.
  

Коментари:

• Нормално, одсуство/неуспех у преузимању вредности довео би до тога да ставка постане неподржана. Овај корак претходне обраде вам омогућава да измените ово понашање. Ако означите поље за потврду Прилагођено при неуспеху (увек означено и сиво за овај корак претходне обраде), могуће је одредити прилагођене опције за руковање грешкама: или одбацивање вредности, постављање одређене вредности или постављање одређене поруке о грешци. У случају неуспелог корака претходне обраде, ставка неће постати неподржана ако је изабрана опција за одбацивање вредности или постављање одређене вредности.
• Овај корак претходне обраде проверава само да ли се ниједна вредност ставке не може преузети. Не проверава, на пример, да ли се тип преузете вредности (нпр. стринг) подудара са типом информација ставке (нпр. нумеричким); за детаље погледајте Примери претходне обраде. Ако постоји неусклађеност типа, ставка може и даље постати неподржана након што се изврше сви кораци претходне обраде. Да бисте проверили неусклађеност типа, можете користити, на пример, корак претходне обраде Прилагођени множилац; Погледајте Примери претходне обраде.
• Снимање група регуларних израза је подржано у пољима Постави вредност на или Постави грешку на. Користите \N (где је N=1…9) да бисте преузели N-ту подударну групу; користите \0 да бисте преузели подударни текст;
• Ови кораци се увек извршавају као први кораци претходне обраде и постављају се изнад свих осталих након чувања промена ставке;
• Подржано је више корака Провери вредности које нису подржане, у наведеном редоследу. Корак за било коју грешку ће аутоматски бити постављен као последњи корак у овој групи.

Одбаци непромењено

Одбаците вредност ако се није променила.

Коментари:

• Ако је вредност одбачена, она се не чува у бази података и Zabbix сервер нема сазнања да је ова вредност примљена. Изрази окидача неће бити процењени, као резултат тога, неће бити креирани/решени никакви проблеми за повезане окидаче. Функције ће радити само на основу података који су стварно сачувани у бази података. Пошто се трендови граде на основу података у бази података, ако нема сачуване вредности за сат времена, неће бити ни података о трендовима за тај сат.
  
• Само једна опција пригушивања може бити наведена по ставци.

Одбаци непромењено са откуцајима срца

Одбаците вредност ако се није променила у дефинисаном временском периоду (у секундама).

Коментари:

– Подржане су позитивне целобројне вредности за одређивање секунди (минимално – 1 секунда);
– Могу се користити временски суфикси (нпр. 30s, 1m, 2h, 1d);
- Могу се користити кориснички макрои и макрои за откривање ниског нивоа;
- Ако је вредност одбачена, она се не чува у бази података и Zabbix сервер нема сазнања да је ова вредност примљена. Изрази окидача неће бити процењени, као резултат тога, неће бити креирани/решени никакви проблеми за повезане окидаче. Функције ће радити само на основу података који су стварно сачувани у бази података. Пошто се трендови граде на основу података у бази података, ако нема сачуване вредности за сат времена, неће бити ни података о трендовима за тај сат.
- Само једна опција пригушења може бити наведена по ставци.

Прометејев образац

Користите следећи упит да бисте издвојили потребне податке из Prometheus метрике.

Погледајте Prometheus провере за више детаља.

Прометеј у JSON

Претворите потребне Prometheus метрике у JSON.

Погледајте Prometheus провере за више детаља.

Макро подршка

Кориснички макрои и кориснички макрои са контекст су подржани у:

• параметри корака предобраде, укључујући JavaScript код;
• прилагођени параметри за руковање грешкама (Постави вредност на и Постави грешку на поља).

Тестирање

Погледајте тестирање претпроцесирања.