3 Откриће ниског нивоа

Преглед

Откривање ниског нивоа пружа начин за аутоматско креирање ставки, покретача и графикона за различите ентитете на рачунару. На пример, Zabbix може аутоматски да покрене надгледање система датотека или мрежних интерфејса на вашој машини, без потребе да ручно креира ставке за сваки систем датотека или мрежни интерфејс. Поред тога, могуће је конфигурисати Zabbix да аутоматски уклања непотребне ентитете на основу стварних резултата периодично вршеног откривања.

Корисник може да дефинише сопствене типове откривања, под условом да прати одређени JSON протокол.

Општа архитектура процеса откривања је следећа.

Прво , корисник креира правило откривања у Прикупљање података → Шаблони, у колониОткривање. Правило откривања се састоји од (1) ставке која открива неопходне ентитете (на пример, системе датотека или мрежних интерфејса) и (2) прототипова ставки, покретача и графикона које треба креирати на основу вредности те ставке.

Ставка која открива неопходни ентитети су као обичне ставке које се могу видети на другим местима: сервер тражи од Zabbix агента (или било шта на који је тип ставке подешен) за вредност те ставке, агент одговара текстуалном вредношћу. Разлика је у томе што вредност на коју агент одговара треба да садржи листу откривених ентитета у JSON формату. Иако су детаљи овог формата важни само за имплементаторе провера прилагођеног откривања, неопходно је знати да враћена вредност садржи листу парова макро → вредности. На пример, ставка "net.if.discovery" може да врати два пара: "{#IFNAME}" → "lo" и "{#IFNAME}" → "eth0".

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

Када сервер прими вредност за ставку открића, гледа макро → парове вредности и за сваки пар генерише стварне ставке, покретаче и графиконе, на основу њихових прототипова. У примеру са "net.if.discovery" изнад, сервер би генерисао један скуп ставки, покретача и графикона за интерфејс повратне петље"lo", а други сет за интерфејс "eth0".

Имајте на уму да од **Zabbix 4.2* *, промењен је формат JSON које су вратила правила откривања ниског нивоа. Више се не очекује да ће JSON садржати објекат "податак" . Откривање ниског нивоа ће сада прихватити нормалан JSON који садржи низ, како би подржао нове функције као што су претходна обрада вредности ставке и прилагођене путање до вредности макроа за откривање ниског нивоа у JSON документу.

Уграђени кључеви за откривање су ажурирани да враћају низ LLD редова у корену JSON документа. Zabbix ће аутоматски издвојити макро и вредност ако поље низа користи {#MACRO} синтаксу као кључ. Све нове провере открића ће користити нову синтаксу без елемената "податак". Приликом обраде вредности откривања ниског нивоа прво се лоцира корен (низ на $. или $. data).

Док је елемент "податак" уклоњен из свих изворних ставки које се односе на откривање, за компатибилност уназад Zabbix ће и даље прихватати JSON нотацију са елементом "подаци", иако се не препоручује њено коришћење. Ако JSON садржи објекат са само једним елементом низа "податак", онда ће аутоматски издвојити садржај елемента користећи JSONPath$. data. Откривање ниског нивоа сада прихвата опционе кориснички дефинисане LLD макрое са прилагођеном путањом наведеном у JSONPath синтакси.

Погледајте такође : Откривени ентитети

Конфигурисање откривања ниског нивоа

Илустроваћемо откривање ниског нивоа на основу примера откривања система датотека.

Да бисте конфигурисали откривање, урадите следеће:

• Идите на: Прикупљање података → Шаблони или Домаћини
• Кликните на Откриће у реду одговарајући шаблон/домаћин

• Кликните на Креирај правило откривања у горњем десном углу екрана
• Попуните откриће образац правила са потребним детаљима

Правило откривања

Образац правила откривања садржи пет картица, које представљају, с лева надесно, ток података током откривања:

• Правило за откривање - одређује, што је најважније, уграђену ставку или прилагођену скрипту за преузимање података о откривању
• Претходна обрада - примењује неку претходну обраду на откривене податке
• LLD макрои - омогућава издвајање неких вредности макроа за коришћење неоткривених ставки, покретача, итд
• Филтери - омогућава филтрирање откривених вредности
• Преклапања - омогућава да се модификују ставке, покретачи, графикони или прототипови хоста када се примењују на одређене откривене објекте.

Картица Правило за откривање садржи кључ ставке који се користи за откривање (као као и неко опште правило откривања атрибути):

Сва обавезна поља за унос су означена црвеном звездицом.

Препроцесирање

Картица Претходна обрада омогућава да се дефинишу правила трансформације која ће се применити на резултат откривања. У овом кораку могућа је једна или више трансформација. Трансформације се извршавају редоследом којим су дефинисане. Свo препроцесирање обавља Zabbix сервер.

Погледајте такође:

• Детаљи о претходној обради
• Тестирање претходне обрде

|- |------------------------------------ --| | |* Transformation| Description | | Text |<|<| |<|Regular expression|Упарите примљену вредност са регуларним изразом <образац> и замените вредност екстрахованим <излазом>. Регуларни израз подржава екстракцију максимално 10 ухваћених група са \ N секвенцом.
Параметри:
узорак - регуларни израз
излаз - шаблон за форматирање излаза. \N (где је N =1…9) излазна секвенца је замењена N-том подударном групом. \0 излазна секвенца је замењена одговарајућим текстом.
Ако означите поље за потврду Прилагођено при неуспеху, могуће је навести прилагођене опције руковања грешкама: или да одбаците вредност, поставите одређену вредност или подесите наведену поруку о грешци.| |^|Replace|Пронађи стринг за претрагу и замени га другим (или ништа). Сва појављивања стринга за претрагу ће бити замењена.
Параметри:
стринг за претрагу - стринг за проналажење и замену, осетљивост на велика и мала слова (обавезно)
замена - стринг за замените стринг за претрагу са. Низ за замену такође може бити празан, што омогућава брисање стринга за претрагу када се пронађе.
Могуће је користити излазне секвенце за тражење или замену прелома редова, враћања слова, табулатора и размака "\n \r \t \s"; обрнута коса црта се може избећи као "\\", а излазне секвенце се могу избећи као "\\n". Избегавање прелома реда, враћања носиоца, табулатора се аутоматски врши током откривања ниског нивоа.| |Structured data|<|<| |<|JSONPath|Издвоји вредност или фрагмент из JSON података помоћу JSONPath функционалност.
Ако означите поље за потврду Custom on fail, могуће је навести прилагођено Опције руковања грешкама: или да одбаците вредност, поставите одређену вредност или поставите одређену поруку о грешци.| |<| XML XPath|Издвоји вредност или фрагмент из XML података користећи XPath функционалност.
Да би ова опција радила , Zabbix сервер мора бити компајлиран са подршком за libxml.
Примери:
number(/document/item/value) ће издвојити10из<document><item><value>10</value></item></document>
number(/document/item/@attribute)ће издвојити10из<document>< item attribute="10"></item></document>
/document/itemће издвојити<item><value>10</value></item>од<document><item><value>10</value></item></document>
Имајте на уму да простори имена нису подржано.
Ако означите поље за потврду *Прилагођено при неуспеху*, могуће је да наведете прилагођене опције за руковање грешкама: или да одбаците вредност, поставите одређену вредност или подесите одређену грешку порука.| |<|*CSV to JSON*|Конвертујте податке CSV датотеке у JSON формат.
За више информација погледајте: [Претходна обрада CSV у JSON](/manual/config/items/preprocessing/csv_to_json#csv_header_processing). | |^|*XML to JSON*|Конвертујте податке у XML формату у JSON.
За више информација погледајте: [Серијализација правила](/manual/config/items/preprocessing/javascript/javascript_objects#serialization_rules).
Ако означите поље за потврду *Прилагођено при неуспеху*, могуће је навести прилагођене опције за руковање грешкама: или да одбаците вредност, поставити одређену вредност или поставити одређену поруку о грешци.| | SNMP |<|<| | |*SNMP walk value*|Издвоји вредност према наведеном називу OID/MIB-а и примени опције форматирања:
**Непромењено** - врати Hex-STRING као хексадецимални стринг без преклапања;
** UTF-8 из Hex-STRING** - претворити Hex-STRING UTF-8 стринг;
** MAC из Hex-STRING** - претворити Hex-STRING у стринг MAC адресе (који ће имати ''''' замењен са':');
**Цео број из BITS-а** - конвертујте првих 8 бајтова низа битова изражених као низ хексадецималних знакова (нпр. "1A 2B 3C 4D") у 64-битни непотписани цео број . У низовима битова дужим од 8 бајтова, наредни бајтови ће бити занемарени.
Ако означите поље за потврду *Прилагођено при неуспеху*, могуће је навести прилагођене опције за руковање грешкама: или да одбаците вредност, поставите одређену вредност или поставити наведену поруку о грешци.| | |*SNMP walk to JSON*|Конвертујте SNMP вредности у JSON. Наведите име поља у JSON-у и одговарајућу SNMP OID путању. Вредности поља ће бити попуњене вредностима на наведеној путањи SNMP OID-а.
Овај корак препроцесирања можете да користите за [SNMP OID откриће](/manual/discovery/low_level_discovery/examples/snmp_oids_walk).
Сличне опције форматирања вредности као у кораку *SNMP walk value* су доступни.
Ако означите поље за потврду *Прилагођено при неуспеху*, могуће је навести прилагођене опције руковања грешкама: или одбацити вредност, поставити одређену вредност или поставити одређену поруку о грешци.| | |*SNMP get value*|Примени опције форматирања на SNMP добијену вредност:<бр>**UTF-8 из Hex-STRING** - претворити Hex-STRING у UTF-8 стринг;
** MAC из Hex-STRING** - претворити Hex-STRINGГ у низ MAC адресе (који ће имати' `замењен са':');
**Цео број из BITS-а** - претворити првих 8 бајтова стринг битова изражен као низ хексадецималних знакова (нпр. "1A 2B 3C 4D") у 64-битни цели број без предзнака. У низовима битова дужим од 8 бајтова, наредни бајтови ће бити занемарени.
Ако означите поље за потврду *Прилагођено при неуспеху*, могуће је навести прилагођене опције за руковање грешкама: или да одбаците вредност, поставите одређену вредност или поставите наведену поруку о грешци.| |Custom scripts|<|<| |<|*JavaScript*|Унесите JavaScript код у модални уређивач који се отвара када кликнете на поље параметара или на икони оловке поред ње.
Имајте на уму да доступна дужина JavaScript зависи од [коришћене базе података](/manual/config/items/item#custom_script_limit).
За више информација погледајте: [Претходна обрада JavaScripta]( /manual/config/items/preprocessing/javascript)| | Validation |<|<| |<|*Does not match regular expression*|Наведите регуларни израз израз да вредност не сме да се подудара.
Нпр.Грешка:(.?).`
Ако означите поље за потврду Прилагођено при неуспеху, могуће је да наведете прилагођене опције за руковање грешкама: или да одбаците вредност, поставите одређену вредност или поставите одређену порука о грешци.|

|^|Check for error in JSON|Провери поруку о грешци на нивоу апликације која се налази на JSONPath-у. Зауставите обраду ако је успела и порука није празна; у супротном наставите обраду са вредношћу која је била пре овог корака претходне обраде. Имајте на уму да се ове грешке спољне услуге пријављују кориснику какве јесу, без додавања информација о кораку претходне обраде.
Нпр. $. errors. Ако се прими JSON као што је {"errors":"е1"}, следећи корак претходне обраде неће бити извршен.
Ако означите поље за потврду Прилагођено при неуспеху, могуће је навести прилагођено руковање грешкама опције: или да одбаците вредност, поставите наведену вредност или поставите одређену поруку о грешци.| |^|Check for error in XML|Провери да ли постоји порука о грешци на нивоу апликације која се налази на Xpath. Зауставите обраду ако је успела и порука није празна; у супротном наставите обраду са вредношћу која је била пре овог корака претходне обраде. Имајте на уму да се ове грешке спољне услуге пријављују кориснику какве јесу, без додавања информација о кораку пре обраде.
Неће бити пријављена грешка у случају неуспеха да се анализира неважећи XML.
Ако означите поље за потврду Прилагођено при неуспеху, могуће је навести прилагођене опције за руковање грешкама: или да одбаците вредност, поставите одређену вредност или поставите одређену поруку о грешци.| |<|Matches regular expression|Наведите регуларни израз који вредност мора подударање.
Ако означите поље за потврду Прилагођено при неуспеху, могуће је навести прилагођене опције руковања грешкама: или да одбаците вредност, поставите наведену вредност или подесите наведену поруку о грешци.| | Throttling |<| <| |<|Discard unchanged with heartbeat|Одбаци вредност ако се није променила у дефинисаном временском периоду (у секундама).
Позитивне целобројне вредности су подржане за одређивање секунди (минимум - 1 секунда). У овом пољу се могу користити временски суфикси (нпр. 30s, 1m, 2h, 1d). Кориснички макрои и макрои за откривање ниског нивоа могу да се користе у овом пољу.
Само једна опција ограничавања може да се наведе за ставку откривања.
Нпр. 1m. Ако се идентичан текст проследи у ово правило два пута у року од 60 секунди, биће одбачен.
Напомена: Промена прототипова ставки не ресетује пригушивање. Пригушивање се ресетује само када се промене кораци препроцесирања.| | Prometheus |<|<| |<|Prometheus to JSON|Конвертујте потребне Prometheus метрике у JSON.
Погледајте [Prometheus провере](/manual/config/items/itemtypes/prometheus за више детаља.|

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

Прилагођени макрои

Картица LLD макрои омогућава да одредите прилагођено откривање ниског нивоа мацрос.

Прилагођени макрои су корисни у случајевима када враћени JSON нема већ дефинисани потребни макрои. Дакле, на пример:

• Изворни кључ vfs.fs.discovery за откривање система датотека враћа а JSON са неким унапред дефинисаним LLD макроима као што је {#FSNAME}, {#FSTYPE}. Ови макрои се могу користити у прототиповима ставки, покретача (погледајте следеће делове странице) директно; дефинисање обичаја макрои нису потребни;
• Ставка агента vfs.fs.get такође враћа JSON са [подаци система датотека ](/manual/discovery/low_level_discovery/examples/mounted_filesystems, али без унапред дефинисаних LLD макроа. У овом случају можете дефинисати сами макрои и мапирајте их са вредностима у JSON-у користећи JSONPath:

Извучене вредности се могу користити у откривеним ставкама, окидачима итд. Имајте на уму да ће вредности бити извучене из резултата откривања и било којег кораке претходне обраде.

Филтер

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

Преклапање

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

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

Сви обавезни параметри су означени црвеним звездицама.

Конфигурисање операције

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

|Parameter|<|<|Description| |- |-|----------|----------------------------------- ----| |* Object|<|<|Доступна су четири типа објеката:
Предмет прототип
Прототип окидача
Прототип графа<бр>Прототип домаћина| | Condition|<|<|Дозвољава филтрирање ентитета на које треба применити операцију.| | | Operator |<|Подржани оператори:
једнако - применити на овај прототип
није једнако - применити на све прототипове, осим овог
садржи - применити, ако име прототипа садржи овај стринг
не садржи - примените, ако име прототипа не садржи овај стринг
подудара - примените, ако се име прототипа поклапа са регуларним израз
не подудара - примените, ако се име прототипа не поклапа са регуларним изразом
| |^| Pattern |<|регуларни израз или стринг за претрагу .| |^| Object: Прототип ставке|<|<| |^| |Create enabled|Када је поље за потврду означено, појавиће се дугмад која омогућавају да се замени подешавања оригиналног прототипа ставке:
Да* - ставка ће бити додата у омогућеном стању.
Не - ставка ће бити додата откривеном ентитету али у онемогућеном стању.| |^||* Discover|Када је поље за потврду означено, појавиће се дугмад која омогућавају заменити подешавања прототипа оригиналне ставке:
Да* - ставка ће бити додата.
Не - ставка неће бити додата.| |^||Update interval|Када је поље за потврду означено, две опције ће се појавити, омогућавајући подешавање различитог интервала за ставку:
Кашњење - Интервал ажурирања ставке. Кориснички макрои и временски суфикси (нпр. 30s, 1m, 2h, 1d) су подржани. Требало би да буде подешено на 0 ако се користи Прилагођени интервал.
Прилагођени интервал - кликните на да бисте одредили флексибилно/интервали распореда. За детаљније информације погледајте Прилагођени интервали.| |^||* History|Када је поље за потврду означено, појавиће се дугмад, која омогућавају подешавање различитог периода складиштења историје за ставку:
Не чувај* - ако је изабрано, историја неће бити сачувана.
Спреми до - ако је изабрано, поље за унос за одређивање период складиштења ће се појавити са десне стране. Кориснички макрои и LLD макрои су подржани.| |^||* Trends|Када је поље за потврду означено, појавиће се дугмад, омогућавајући да се за ставку подеси другачији период складиштења тренда:
Не чувај* - ако је изабрано, трендови се неће чувати .
Спреми до - ако је изабрано, са десне стране ће се појавити поље за унос за одређивање периода складиштења. Кориснички макрои и LLD макрои су подржани.| |^||* Tags|Када је поље за потврду означено, нови појавиће се блок који омогућава да се наведу парови ознака-вредност.
Ове ознаке ће бити додате ознакама наведеним у ставци прототип, чак и ако се имена ознака подударају.| |^| Object: Прототип окидача|<|<| |^| |Create enabled|Када је поље за потврду означено, појавиће се дугмад која омогућавају да се замени оригинална подешавања прототипа окидача:
Да* - окидач ће бити додат у омогућеном стању.
Не - окидач ће бити додат откривеном ентитету, али у онемогућеном стању.| |^||* Discover|Када је поље за потврду означено, појавиће се дугмад која омогућавају замени подешавања оригиналног прототипа окидача:
Да* - окидач ће бити додат.
Не - окидач неће бити додат.| |^||* Severity|Када је поље за потврду означено, окидач Дугмад за озбиљност ће се појавити, омогућавајући да промените озбиљност окидача.| |^|| Tags|Када је поље за потврду означено, појавиће се нови блок, који омогућава да се наведе вредност ознаке парови.
Ове ознаке ће бити додате ознакама наведеним у прототипу окидача, чак и ако се имена ознака подударају.| |^| Object: Прототип графикона|<|<| |^| | Discover|Када је поље за потврду означено, појавиће се дугмад која омогућавају да се замене подешавања оригиналног прототипа графикона:
Да* - графикон ће бити додат.<бр>Не - графикон неће бити додат .| |^| Object: Прототип домаћина|<|<| |^| |Create enabled|Када је поље за потврду означено, појавиће се дугмад, која омогућавају да се замени оригинална подешавања прототипа домаћина:
Да - домаћин ће бити креиран у омогућеном стању.
Не - домаћин ће бити креиран у онемогућеном стању.| |^||* Discover|Када је поље за потврду означено, појавиће се дугмад која омогућавају да се замени оригинални прототип домаћина подешавања:
Да* - домаћин ће бити откривен.
Не - домаћин неће бити откривен.| |^||Link templates|Када је поље за потврду означено, поље за унос ће се појавити навођење шаблона. Почните да куцате име шаблона или кликните на Изабери поред поља и изаберите шаблоне са листе у искачућем прозору.
Сви шаблони повезани са прототипом домаћина биће замењени шаблонима из ове замене.| |^| |* Tags|Када је поље за потврду означено, појавиће се нови блок који омогућава да се наведу парови ознака-вредност.
Ове ознаке ће бити додане ознакама наведеним у прототип домаћина, чак и ако се имена ознака поклапају.| |^||Host inventory|Када је поље за потврду означено, појавиће се дугмад, која омогућавају да изаберете другачији инвентар режим за прототип домаћина:
Онемогућено* – не попуњавајте инвентар домаћина
Ручно – наведите детаље ручно
Аутоматизовано - аутоматско попуњавање података инвентара домаћина на основу прикупљених показатеља.|

Дугмад обрасца

Дугмад на дну обрасца омогућавају обављање неколико операција.

Откривени ентитети

Снимци екрана у наставку илуструју како су откривене ставке, покретачи и графикони изгледају као у конфигурацији хоста. Откривени ентитети су са префиксом наранџасте везе до правила откривања из којег потичу.

Имајте на уму да откривени ентитети неће бити креирани у случају да постоје већ постојеће ентитете са истим критеријумима јединствености, за на пример, ставка са истим кључем или графикон са истим именом. Грешка У овом случају се у фронтенду приказује порука да је ниско-ниво правило откривања није могло да створи одређене ентитете. Правило открића сам по себи, међутим, неће постати неподржан јер неки ентитет није могао бити створена и морала је бити прескочена. Правило откривања ће се наставити креирање/ажурирање других ентитета.

Ако откривени ентитет (домаћин, систем датотека, интерфејс, итд.) престане да се открива (или више не прође филтер), ентитети који су креирани на основу њега могу бити аутоматски онемогућени и на крају избрисани.

Изгубљени ресурси могу бити аутоматски онемогућени на основу вредности параметра Онемогући изгубљене ресурсе. Ово утиче на изгубљене домаћине, ставке и окидаче.

Изгубљени ресурси могу бити аутоматски избрисани на основу вредности параметра Избриши изгубљене ресурсе. Ово утиче на изгубљене домаћине, групе домаћина, ставке, покретаче и графиконе.

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

Ако су ентитети означени за брисање, али нису избрисани на очекивано време (онемогућено правило откривања или ставке домаћина), биће избрисано следећи пут када се обради правило откривања.

Ентитети који садрже друге ентитете, који су означени за брисање, ће не ажурира се ако се промени на нивоу правила откривања. на пример, Окидачи засновани на LLD-у се неће ажурирати ако садрже ставке које су означене за брисање.

Друге врсте открића

Више детаља и упутстава о другим врстама откривања ван кутије је доступно у следећим одељцима:

• откривање мреже интерфејси;
• откривање CPU-а и CPU-а језгра;
• откриће SNMP OIDs;
• откриће JMX објекат;
• откривање помоћу ODBC SQL упити;
• откриће indows услуге;
• откриће домаћина интерфејса у Zabbix-у.

За више детаља о JSON формату за ставке откривања и пример како да имплементирате сопствени откривач система датотека као Perl скрипту, погледајте креирање прилагођених LLD правила.