Documentation
Table of Contents
3 Кориснички макрои са контекстом
Преглед
Опциони контекст се може користити у кориснички макрои, омогућавајући да се замени подразумевану вредност са контекстно-специфичним.
Контекст се додаје имену макроа; синтакса зависи од тога да ли контекст је статична текстуална вредност:
или регуларни израз:
Имајте на уму да макро са контекстом регуларног израза може бити дефинисан само у конфигурација макроа корисника. Ако се префикс regex: користи негде другде као кориснички макро контекст, као у изразу окидача, биће третиран као статички контекст.
Цитирање контекста је опционо (погледајте такође важно белешке).
Примери макро контекста:
| Example | Description |
|---|---|
{$LOW_SPACE_LIMIT} |
Кориснички макро без контекста. |
{$LOW_SPACE_LIMIT:/tmp} |
Кориснички макро са контекстом (статички стринг). |
{$LOW_SPACE_LIMIT:regex:"^/tmp$"} |
Кориснички макро са контекстом (регуларни израз). Исто као {$LOW_SPACE_LIMIT:/tmp}. |
{$LOW_SPACE_LIMIT:regex:"^/var/log/.*$"} |
Кориснички макро са контекстом (регуларни израз). Одговара свим стринговима са префиксом /var/log/. |
Случајеви употребе
Кориснички макрои са контекстом се могу дефинисати да би се постигли флексибилнији прагови у изразима окидача (на основу вредности које је преузео откриће ниског нивоа). На пример, можете дефинисати следеће макрое:
- {$LOW_SPACE_LIMIT} = 10
- {$LOW_SPACE_LIMIT:/home} = 20
- {$LOW_SPACE_LIMIT:regex:"^/[a-z]+$"} = 30
Тада се макро за откривање ниског нивоа може користити као макро контекст у а покренути прототип за откривање монтираног система датотека:
Након открића, примењиваће се различити прагови малог простора окидачи у зависности од откривених тачака монтирања или типова система датотека. Проблемски догађаји ће се генерисати ако:
- /home фолдер има мање од 20% слободног простора на диску
- фолдери који одговарају шаблону редовног израза (као што су /etc, /tmp или /var) имају мање од 30% слободног простора на диску
- фолдери који се не подударају са шаблоном редовног израза и нису /home имају мање од 10% слободног простора на диску
Важне напомене
- Ако постоји више од једног корисничког макроа са контекстом, Zabbix ће покушати прво упарите једноставне макрое контекста, а затим макрое контекста са регуларни изрази у недефинисаном редоследу.
Немојте креирати различите контекстне макрое који одговарају исти стринг да би се избегло недефинисано понашање.
- Ако макро са својим контекстом није пронађен на домаћину, повезаним шаблонима или глобално, онда се тражи макро без контекста.
- У контексту су подржани само макрои за откривање ниског нивоа. Било који остали макрои се игноришу и третирају као обичан текст.
Технички, контекст макроа је специфициран помоћу правила сличних ставка кључа параметри, осим што је контекст макроа није рашчлањено као неколико параметара ако постоји знак ,:
- Контекст макроа мора бити наведен са
"ако контекст садржи}знак или почиње знаком". Наводници унутар наводника контекст мора бити избачен знаком\. - Сам знак
\није уклоњен, што значи да је немогуће да има цитирани контекст који се завршава знаком\- макро {$MACRO:"a:\b\c\"} је неважећи. - Водећи размаци у контексту се игноришу, а размаци на крају се игноришу не:
- На пример, {$MACRO:A} је исто што и {$MACRO: A}, али није {$MACRO:A }.
- Сви размаци пре водећих наводника и после навода на крају су игнорисано, али сви размаци унутар наводника нису:
- Макрои {$MACRO:"A"}, {$MACRO: "A"}, {$MACRO:"A" } и {$MACRO: "A" } су исти, али макрои {$MACRO:"A"} и {$MACRO:" A"} нису.
Сви следећи макрои су еквивалентни, јер имају исте контекст: {$MACRO:A}, {$MACRO: A} и {$MACRO:"A"}. Ово је у супротности са кључевима ставки, где су 'key[a]', 'key[ a] и 'key["a"]' исто семантички, али различито у сврху јединствености.