3 Скрипте

Преглед

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

Глобалне скрипте, у зависности од конфигурисаног опсега и корисничких дозвола, доступне су за извршење:

• из менија домаћина на различитим локацијама корисничког интерфејса (Контролна табла, Проблеми, Најновији подаци, Мапе, итд.)
• из менија догађаја
• може се покренути као операција у оквиру акције

Скрипте се извршавају само на Zabbix агенту, Zabbix серверу (прокси) или Zabbix серверу. Такође погледајте Извршавање команде.

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

• За удаљене команде које се извршавају на Zabbix агенту:
  • додавање параметра AllowKey=system.run[<command>,*] за сваку дозвољену команду у конфигурацији агента, * означава режим wait и nowait;
• За удаљене команде које се извршавају на Zabbix проксију:
  • Упозорење: Није потребно омогућити удаљене команде на Zabbix проксију ако се извршавају удаљене команде на Zabbix агенту који надгледа Zabbix прокси. Ако је, међутим, потребно извршити даљинске команде на Zabbix проксију, подесите параметар * EnableRemoteCommands* на '1' у конфигурацији проксија.

Глобално извршавање скрипте на Zabbix серверу се може онемогућити постављањем EnableGlobalScripts =0 у конфигурацији сервера. За нове инсталације, од Zabbix-а 7.0, глобално извршавање скрипте на Zabbix серверу је подразумевано онемогућено.

Приказује се листа постојећих скрипти са њиховим детаљима.

Приказани подаци:

Да бисте конфигурисали нову скрипту, кликните на дугме Креирај скрипту у горњем десном углу.

Опције масовног уређивања

Дугме испод листе нуди једну опцију масовног уређивања:

• Избриши - брисање скрипте

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

Коришћење филтера

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

Веза Филтер доступна је изнад листе скрипти. Ако кликнете на њу, постаје доступан филтер где можете да филтрирате скрипте по имену и обиму.

Конфигурисање глобалне скрипте

Атрибути скрипте:

Напредна конфигурација

Напредне опције конфигурације доступне су у склопивој секцији Напредна конфигурација:

|Parameter|Description| |------------------------------------ --| |Омогући кориснички унос|Означите поље за потврду да бисте омогућили ручни унос корисника пре извршавања скрипте.
Ручни кориснички унос ће заменити вредност макроа {MANUALINPUT} у скрипти.
Погледајте такође: Ручни унос корисника.| |Порука за унос|Унесите прилагођени текстуални упит за прилагођени кориснички унос. Овај текст ће бити приказан изнад поља за унос у искачућем прозору Ручни унос.
Да бисте видели преглед искачућег прозора Ручни унос, кликните на Тестирај кориснички унос. Преглед такође омогућава да се тестира да ли је улазни стринг у складу са правилом валидације уноса (погледајте параметре испод).
Подршка макроа и корисничких макроа зависи од обима скрипте (погледајте Опсег у општим параметрима конфигурације скрипте).| |Тип уноса|Изаберите тип ручног уноса:
String - један низ;
Dropdown - вредност се бира из више опција падајућег менија.| |Опције падајућег менија|Унесите јединствене вредности за падајући мени за кориснички унос у листу раздвојену зарезима.
Да бисте укључили празну опцију у падајући мени, додајте додатни зарез на почетку, средини или крају листе.
Ово поље се приказује само ако је 'Dropdown' изабрано као Тип уноса.| |Подразумевани стринг за унос|Унесите подразумевани стринг за кориснички унос (или ниједан).
Ово поље ће бити потврђено у односу на регуларни израз који је наведен у пољу Правило за валидацију уноса.
Овде унета вредност ће бити подразумевано приказана у искачућем прозору Ручни унос.
Ово поље се приказује само ако је 'String' изабран као Тип уноса.| |Правило валидације уноса|Унесите регуларни израз да бисте потврдили кориснички унос.
Глобални регуларни изрази су подржани.
Ово поље се приказује само ако је 'String' изабран као Тип уноса.| |Омогући потврду|Означите поље за потврду да бисте приказали поруку за потврду пре извршавања скрипте. Ова функција може бити посебно корисна са потенцијално опасним операцијама (као што је скрипта за поновно покретање) или онима које могу потрајати дуго.| |Текст потврде|Унесите прилагођени текст потврде за искачући прозор за потврду омогућен помоћу поља за потврду изнад (на пример, Удаљени систем ће бити поново покренут. Јесте ли сигурни?). Да бисте видели како ће текст изгледати, кликните на Потврда теста поред поља.
Макрои и прилагођени кориснички макрои су подржани.
Напомена: макрои неће бити проширени приликом тестирања поруке потврде.|

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

Ручни унос корисника

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

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

Да бисте омогућили ручни унос корисника:

• користите макро {MANUALINPUT} у скрипти (команде, скрипта, параметар скрипте) где је потребно; или у URL пољу URL скрипти;
• у [напредној конфигурацији скрипте] (#advanced-configuration), омогућите ручни кориснички унос и конфигуришите опције уноса.

Када је кориснички унос омогућен, пре извршења скрипте, искачући прозор Ручни унос ће се појавити кориснику који тражи да унесе прилагођену вредност. Унета вредност ће заменити {MANUALINPUT} у скрипти.

У зависности од конфигурације, од корисника ће се тражити да унесе вредност низа:

Или изаберите вредност из падајућег менија унапред одређених опција:

Ручни унос корисника је доступан само за скрипте чији је опсег подешен на 'Manual host action' или 'Manual event action'.

Извршење скрипте и резултат

Скрипте које покреће Zabbix сервер се извршавају редоследом описаним на страници Извршавање команде (укључујући проверу излазног кода). Резултат скрипте ће бити приказан у искачућем прозору који ће се појавити након извршавања скрипте.

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

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

Погледајте пример скрипте и прозор са резултатом испод:

uname -v
       /tmp/non_existing_script.sh
       echo "This script was started by {USER.USERNAME}"

Резултат скрипте не приказује саму скрипту.

Време истека скрипте

Zabbix агент

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

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

sleep 5
       df -h

Порука о грешци, у овом случају, је следећа:

Timeout while executing a shell script.

Да бисте избегли такве ситуације, саветује се да оптимизујете саму скрипту (у примеру изнад, "5") уместо прилагођавања параметра Timeout у Конфигурацији Zabbix агента and Конфигурацији Zabbix сервера. Међутим, за Zabbix агента у активном режиму, параметар Timeout у Конфигурацији Zabbix сервера треба да буде најмање неколико секунди дужи од параметра RefreshActiveChecks у Конфигурацији Zabbix агента. Ово осигурава да сервер има довољно времена да прими резултате активне провере од агента. Имајте на уму да је извршавање скрипте на активном агенту подржано од Zabbix агента 7.0.

У случају да је параметар Timeout промењен у Конфигурацији Zabbix агента, појавиће се следећа порука о грешци:

Get value from agent failed: ZBX_TCP_READ() timed out.

То значи да је модификација направљена у Конфигурацији Zabbix агента, али је потребно изменити параметар Timeout у Конфигурацији Zabbix сервера такође.

Zabbix сервер/прокси

Погледајте пример скрипте која ради на Zabbix серверу и прозор са резултатом испод:

sleep 11
       df -h

Такође се саветује да оптимизујете саму скрипту (уместо прилагођавања параметра TrapperTimeout на одговарајућу вредност (у нашем случају, > ‘11’) изменом конфигурације Zabbix сервера).