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

Преглед

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Параметри:

• pattern - регуларни израз;
  
• output - шаблон за форматирање излаза. \N (where 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 хода

Издвоји вредност према наведеном 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 бајтова, наредни бајтови ће бити занемарени.

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

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

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

Коментари:

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

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

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

Коментари:

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

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

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

Коментари:

• Овај корак је користан за израчунавање брзине у секунди константно растуће вредности;
  
• Пошто ова калкулација може да произведе бројеве са покретним зарезом, препоручује се да подесите 'Тип информације' на Нумеричке (флоат), чак и ако су улазне необрађене вредности цели бројеви. Ово је посебно релевантно за мале бројеве где је децимални део битан. Ако су вредности с помичним зарезом велике и могу премашити дужину поља 'флоат', у ком случају се цела вредност може изгубити, заправо се предлаже да се користи Нумеричке (непотписан) и тако исече само децимални део.
  
• Процењује се као (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 излазна секвенца је замењена одговарајућим текстом.

Коментари:

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

Провера за неподржану вредност

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

Параметри:

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

Коментари:

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

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

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

Коментари:

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

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

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

Коментари:

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

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

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

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

Прометеј у JSON

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

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

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

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

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

Тестирање

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