Z menu hosta w różnych miejscach frontendu (Pulpit nawigacyjny, Problemy, Najnowsze dane, Mapy itd.).
Z menu zdarzenia.
Mogą być uruchamiane jako operacja akcji.

Skrypty są wykonywane wyłącznie przez Zabbix agent, Zabbix serwer (proxy) lub Zabbix serwer. Zobacz także Wykonywanie poleceń.

Polecenia zdalne są domyślnie wyłączone zarówno w Zabbix agent, jak i w Zabbix proxy. Można je włączyć w następujący sposób:

W przypadku poleceń zdalnych wykonywanych przez Zabbix agent dodaj parametr AllowKey=system.run[<command>,*] dla każdego dozwolonego polecenia w konfiguracji agenta, gdzie * oznacza dowolny tryb wykonywania (wait lub nowait).
W przypadku poleceń zdalnych wykonywanych przez Zabbix proxy ustaw parametr EnableRemoteCommands na 1 w konfiguracji proxy. Pamiętaj, że nie trzeba włączać poleceń zdalnych w Zabbix proxy, gdy są one wykonywane przez Zabbix agent na hoście monitorowanym przez proxy.

Nie używaj AllowKey=system.run[*], chyba że jest to konieczne, ponieważ umożliwia to wykonywanie dowolnych poleceń na hoście. Ze względów bezpieczeństwa zaleca się zezwalanie wyłącznie na dokładnie określone polecenia, natomiast system.run[*] jest domyślnie blokowane (DenyKey=system.run[*]).

Wykonywanie skryptów globalnych na Zabbix serwer można wyłączyć, ustawiając EnableGlobalScripts=0 w konfiguracji serwera. W przypadku nowych instalacji rozpoczynających pracę z Zabbix 7.0 wykonywanie skryptów globalnych na Zabbix serwer jest domyślnie wyłączone.

Wyświetlana jest lista istniejących skryptów wraz ze szczegółami.

Wyświetlane dane:

Column	Description
Name	Nazwa skryptu. Kliknięcie nazwy skryptu otwiera formularz konfiguracji skryptu.
Scope	Zakres skryptu - operacja akcji, ręczna akcja hosta lub ręczna akcja zdarzenia. To ustawienie określa, gdzie skrypt jest dostępny - w poleceniach zdalnych operacji akcji, z menu hosta lub z menu zdarzenia.
Used in actions	Wyświetlane są wszystkie akcje, w których używany jest skrypt, (od Zabbix 7.0.4) poprzedzone łączną liczbą tych akcji. Kliknięcie nazwy akcji otwiera formularz konfiguracji akcji. Jeśli użytkownik nie ma uprawnień do akcji, nazwa nie jest klikalna.
Type	Wyświetlany jest typ skryptu - polecenie URL, Webhook, Script, SSH, Telnet lub IPMI.
Execute on	Wyświetlana jest informacja, czy skrypt będzie wykonywany na Zabbix agent, Zabbix proxy lub serwerze, czy wyłącznie na Zabbix serwer.
Commands	Wyświetlane są wszystkie polecenia, które zostaną wykonane w ramach skryptu. W przypadku webhooków nie jest tutaj wyświetlana żadna informacja.
User group	Wyświetlana jest grupa użytkowników, dla której skrypt jest dostępny (lub All dla wszystkich grup użytkowników).
Host group	Wyświetlana jest grupa hostów, dla której skrypt jest dostępny (lub All dla wszystkich grup hostów).
Host access	Wyświetlany jest poziom uprawnień do grupy hostów - Read lub Write. Dostęp do wykonywania skryptu będą mieli tylko użytkownicy z wymaganym poziomem uprawnień.

Aby skonfigurować nowy skrypt, kliknij przycisk Create script w prawym górnym rogu.

Opcje masowej edycji

Przycisk poniżej listy oferuje jedną opcję masowej edycji:

Delete - usuń skrypty

Aby użyć tej opcji, zaznacz pola wyboru przed odpowiednimi skryptami i kliknij Delete.

Korzystanie z filtra

Możesz użyć filtra, aby wyświetlić tylko interesujące Cię skrypty. Aby poprawić wydajność wyszukiwania, dane są przeszukiwane z nierozwiązanymi makrami.

Link Filter jest dostępny nad listą skryptów. Po kliknięciu go pojawi się filtr, za pomocą którego można filtrować skrypty według nazwy i zakresu.

Konfigurowanie skryptu globalnego

Zaleca się używanie funkcji makr zamiast zwykłych makr w skryptach globalnych w celu zwiększenia bezpieczeństwa, ponieważ makra nie są automatycznie zabezpieczane.

Atrybuty skryptu:

Parametr		Opis
Nazwa		Unikalna nazwa skryptu. Na przykład `Clear /tmp filesystem`
Zakres		Zakres skryptu - operacja działania, ręczna akcja hosta lub ręczna akcja zdarzenia. To ustawienie określa, gdzie można używać skryptu - odpowiednio w zdalnych poleceniach operacji działania, z menu hosta lub z menu zdarzenia. Ustawienie zakresu na „Action operation” udostępnia skrypt wszystkim użytkownikom mającym dostęp do Alerts > Actions. Jeśli skrypt jest używany w działaniu, jego zakresu nie można zmienić z „action operation”. Obsługa makr Zakres wpływa na zestaw dostępnych makr. Na przykład makra związane z użytkownikiem (`{USER.*}`) są obsługiwane w skryptach, aby umożliwić przekazywanie informacji o użytkowniku, który uruchomił skrypt. Nie są jednak obsługiwane, jeśli zakresem skryptu jest operacja działania, ponieważ operacje działań są wykonywane automatycznie. Makro {MANUALINPUT} umożliwia określenie danych wejściowych podczas wykonywania skryptu. Jest obsługiwane w skryptach ręcznych akcji hosta i ręcznych akcji zdarzenia. Aby sprawdzić, które inne makra są obsługiwane, wyszukaj „Trigger-based notifications and commands/Trigger-based commands”, „Manual host action scripts” oraz „Manual event action scripts” w tabeli obsługiwanych makr. Pamiętaj, że jeśli makro może zostać rozwinięte do wartości zawierającej spacje (na przykład nazwy hosta), należy je odpowiednio ująć w cudzysłowy.
Ścieżka menu		Żądana ścieżka menu skryptu. Na przykład `Default` lub `Default/` spowoduje wyświetlenie skryptu w odpowiednim katalogu. Menu mogą być zagnieżdżane, np. `Main menu/Sub menu1/Sub menu2`. Podczas uzyskiwania dostępu do skryptów przez menu hosta/zdarzenia w sekcjach monitorowania zostaną one uporządkowane zgodnie z podanymi katalogami. To pole jest wyświetlane tylko wtedy, gdy jako Zakres wybrano „Manual host action” lub „Manual event action”.
Typ		Kliknij odpowiedni przycisk, aby wybrać typ skryptu: polecenie URL, Webhook, Script, SSH, Telnet lub IPMI. Typ URL jest dostępny tylko wtedy, gdy jako Zakres wybrano „Manual host action” lub „Manual event action”.
	Typ skryptu: URL
	URL	Określ adres URL umożliwiający szybki dostęp z menu hosta lub menu zdarzenia. Obsługiwane są makra i niestandardowe makra użytkownika. Obsługa makr zależy od zakresu skryptu (zobacz powyżej Zakres). Użyj makra {MANUALINPUT} w tym polu, aby móc określić dane wejściowe podczas wykonywania skryptu, na przykład: `http://{MANUALINPUT}/zabbix/zabbix.php?action=dashboard.view` Wartości makr nie mogą być kodowane w adresie URL.
	Otwórz w nowym oknie	Określa, czy adres URL ma zostać otwarty w nowej, czy w tej samej karcie przeglądarki.
	Typ skryptu: Webhook
	Parametry	Określ zmienne webhooka jako pary atrybut-wartość. Zobacz także: konfiguracja nośnika Webhook. W wartościach parametrów obsługiwane są makra i niestandardowe makra użytkownika. Obsługa makr zależy od zakresu skryptu (zobacz powyżej Zakres).
	Skrypt	Wprowadź kod JavaScript w edytorze modalnym, który otwiera się po kliknięciu pola parametru lub ikony ołówka obok niego. Obsługa makr zależy od zakresu skryptu (zobacz powyżej Zakres). Zobacz także: konfiguracja nośnika Webhook, Dodatkowe obiekty JavaScript.
	Limit czasu	Limit czasu wykonywania JavaScript (1-60 s, domyślnie 30 s). Obsługiwane są przyrostki czasu (np. `30s`, `1m`).
	Typ skryptu: Script
	Wykonaj na	Kliknij odpowiedni przycisk, aby wykonać skrypt powłoki na: Zabbix agent - skrypt zostanie wykonany przez Zabbix agent (jeśli pozycja system.run jest dozwolona) na hoście Zabbix proxy lub serwer - skrypt zostanie wykonany przez Zabbix proxy lub serwer - w zależności od tego, czy host jest monitorowany przez proxy, czy przez serwer. Zostanie wykonany na proxy, jeśli włączono tę funkcję za pomocą EnableRemoteCommands. Zostanie wykonany na serwerze, jeśli skrypty globalne są włączone za pomocą parametru serwera EnableGlobalScripts. Zabbix server - skrypt zostanie wykonany wyłącznie przez Zabbix server. Ta opcja nie będzie dostępna, jeśli skrypty globalne są wyłączone za pomocą parametru serwera EnableGlobalScripts.
	Polecenia	Wprowadź pełną ścieżkę do poleceń, które mają zostać wykonane w ramach skryptu. Obsługa makr zależy od zakresu skryptu (zobacz powyżej Zakres). Obsługiwane są niestandardowe makra użytkownika.
	Typ skryptu: SSH
	Metoda uwierzytelniania	Wybierz metodę uwierzytelniania - hasło lub klucz publiczny.
	Nazwa użytkownika	Wprowadź nazwę użytkownika.
	Hasło	Wprowadź hasło. To pole jest dostępne, jeśli jako metodę uwierzytelniania wybrano „Password”.
	Plik klucza publicznego	Wprowadź ścieżkę do pliku klucza publicznego. To pole jest dostępne, jeśli jako metodę uwierzytelniania wybrano „Public key”.
	Plik klucza prywatnego	Wprowadź ścieżkę do pliku klucza prywatnego. To pole jest dostępne, jeśli jako metodę uwierzytelniania wybrano „Public key”.
	Hasło klucza	Wprowadź hasło klucza. To pole jest dostępne, jeśli jako metodę uwierzytelniania wybrano „Public key”.
	Port	Wprowadź port zdalnej usługi SSH na docelowym hoście, z którym Zabbix nawiąże połączenie.
	Polecenia	Wprowadź polecenia. Obsługa makr zależy od zakresu skryptu (zobacz powyżej Zakres). Obsługiwane są niestandardowe makra użytkownika.
	Typ skryptu: Telnet
	Nazwa użytkownika	Wprowadź nazwę użytkownika.
	Hasło	Wprowadź hasło.
	Port	Wprowadź port zdalnej usługi Telnet na docelowym hoście, z którym Zabbix nawiąże połączenie.
	Polecenia	Wprowadź polecenia. Obsługa makr zależy od zakresu skryptu (zobacz powyżej Zakres). Obsługiwane są niestandardowe makra użytkownika.
	Typ skryptu: IPMI
	Polecenie	Wprowadź polecenie IPMI. Obsługa makr zależy od zakresu skryptu (zobacz powyżej Zakres). Obsługiwane są niestandardowe makra użytkownika.
Opis		Wprowadź opis skryptu.
Grupa hostów		Wybierz grupę hostów, dla której skrypt będzie dostępny (lub All dla wszystkich grup hostów).
Grupa użytkowników		Wybierz grupę użytkowników, dla której skrypt będzie dostępny (lub All dla wszystkich grup użytkowników). To pole jest wyświetlane tylko wtedy, gdy jako Zakres wybrano „Manual host action” lub „Manual event action”.
Wymagane uprawnienia do hosta		Wybierz poziom uprawnień dla grupy hostów - Read lub Write. Tylko użytkownicy z wymaganym poziomem uprawnień będą mogli wykonywać skrypt. To pole jest wyświetlane tylko wtedy, gdy jako Zakres wybrano „Manual host action” lub „Manual event action”.
Konfiguracja zaawansowana		Kliknij nagłówek Advanced configuration, aby wyświetlić opcje konfiguracji zaawansowanej. To pole jest wyświetlane tylko wtedy, gdy jako Zakres wybrano „Manual host action” lub „Manual event action”.

Zaawansowana konfiguracja

Opcje zaawansowanej konfiguracji są dostępne w zwijanej sekcji Zaawansowana konfiguracja:

Parameter	Description
Włącz dane wejściowe użytkownika	Zaznacz pole wyboru, aby włączyć ręczne dane wejściowe użytkownika przed wykonaniem skryptu. Ręczne dane wejściowe użytkownika zastąpią wartość makra {MANUALINPUT} w skrypcie. Zobacz także: Ręczne dane wejściowe użytkownika.
Monit wejściowy	Wprowadź własny tekst z prośbą o podanie niestandardowych danych wejściowych użytkownika. Ten tekst będzie wyświetlany nad polem wejściowym w oknie podręcznym Ręczne dane wejściowe. Aby zobaczyć podgląd okna podręcznego Ręczne dane wejściowe, kliknij Testuj dane wejściowe użytkownika. Podgląd umożliwia również sprawdzenie, czy ciąg wejściowy jest zgodny z regułą walidacji danych wejściowych (zobacz parametry poniżej). Obsługa makr i makr użytkownika zależy od zakresu skryptu (zobacz Zakres w ogólnych parametrach konfiguracji skryptu).
Typ danych wejściowych	Wybierz typ ręcznych danych wejściowych: String - pojedynczy ciąg; Dropdown - wartość jest wybierana z wielu opcji listy rozwijanej.
Opcje listy rozwijanej	Wprowadź unikalne wartości dla listy rozwijanej danych wejściowych użytkownika jako listę rozdzielaną przecinkami. Aby uwzględnić pustą opcję na liście rozwijanej, dodaj dodatkowy przecinek na początku, w środku lub na końcu listy. To pole jest wyświetlane tylko wtedy, gdy jako Typ danych wejściowych wybrano 'Dropdown'.
Domyślny ciąg danych wejściowych	Wprowadź domyślny ciąg dla danych wejściowych użytkownika (lub brak). To pole będzie sprawdzane względem wyrażenia regularnego podanego w polu Reguła walidacji danych wejściowych. Wprowadzona tutaj wartość będzie domyślnie wyświetlana w oknie podręcznym Ręczne dane wejściowe. To pole jest wyświetlane tylko wtedy, gdy jako Typ danych wejściowych wybrano 'String'.
Reguła walidacji danych wejściowych	Wprowadź wyrażenie regularne do walidacji ciągu danych wejściowych użytkownika. Obsługiwane są globalne wyrażenia regularne. To pole jest wyświetlane tylko wtedy, gdy jako Typ danych wejściowych wybrano 'String'.
Włącz potwierdzenie	Zaznacz pole wyboru, aby wyświetlić komunikat potwierdzenia przed wykonaniem skryptu. Ta funkcja może być szczególnie przydatna w przypadku potencjalnie niebezpiecznych operacji (takich jak skrypt restartu) lub operacji, które mogą trwać długo.
Tekst potwierdzenia	Wprowadź własny tekst potwierdzenia dla okna podręcznego potwierdzenia włączonego za pomocą powyższego pola wyboru (na przykład Zdalny system zostanie uruchomiony ponownie. Czy na pewno?). Aby zobaczyć, jak będzie wyglądał tekst, kliknij Testuj potwierdzenie obok pola. Obsługiwane są makra i niestandardowe makra użytkownika. Uwaga: makra nie zostaną rozwinięte podczas testowania komunikatu potwierdzenia.

Jeśli skonfigurowano zarówno ręczne dane wejściowe użytkownika, jak i komunikat potwierdzenia, zostaną one wyświetlone w kolejnych oknach podręcznych.

Ręczne dane wejściowe użytkownika

Ręczne dane wejściowe użytkownika pozwalają podać własny parametr przy każdym uruchomieniu skryptu. Eliminuje to konieczność tworzenia wielu podobnych skryptów użytkownika różniących się tylko jednym parametrem.

Na przykład podczas uruchamiania skryptu można chcieć podać inną liczbę całkowitą lub inny adres URL.

Aby włączyć ręczne dane wejściowe użytkownika:

użyj makra {MANUALINPUT} w skrypcie (polecenia, skrypt, parametr skryptu) tam, gdzie jest to wymagane; lub w polu URL w skryptach URL;
w zaawansowanej konfiguracji skryptu włącz ręczne dane wejściowe użytkownika i skonfiguruj opcje wejściowe.

Po włączeniu danych wejściowych użytkownika, przed wykonaniem skryptu użytkownikowi zostanie wyświetlone wyskakujące okno Ręczne dane wejściowe z prośbą o podanie własnej wartości. Podana wartość zastąpi {MANUALINPUT} w skrypcie.

W zależności od konfiguracji użytkownik zostanie poproszony o wprowadzenie wartości tekstowej:

Lub o wybranie wartości z listy rozwijanej wcześniej zdefiniowanych opcji:

Ręczne dane wejściowe użytkownika są dostępne tylko dla skryptów, w których zakres to „Ręczna akcja hosta” lub „Ręczna akcja zdarzenia”.

Wykonywanie skryptu i wynik

Skrypty uruchamiane przez serwer Zabbix są wykonywane w kolejności opisanej na stronie dotyczącej wykonywania poleceń.

Wynik skryptu jest wyświetlany w wyskakującym oknie, które pojawia się po uruchomieniu skryptu. Wartość zwracana przez skrypt jest standardowym wyjściem:

Jeśli skrypt zakończy się pomyślnie (kod wyjścia 0), wartość zwracana jest ograniczona do 16 MB (w tym końcowe białe znaki, które są obcinane).
Jeśli skrypt zakończy się błędem (niezerowy kod wyjścia), wartość zwracana jest standardowym wyjściem błędów ograniczonym do 2 KB.

Zabbix domyślnie nie przechowuje rozszerzonego wyjścia skryptu. Aby zachować pełne szczegóły wyjścia, można zaimplementować rejestrowanie w samym skrypcie (np. przekierować wyjście do lokalnego pliku dziennika).

Należy pamiętać, że w przypadku skryptów wykonywanych przez serwer Zabbix lub proxy Zabbix obowiązują również ograniczenia bazy danych.

Poniżej przedstawiono przykład skryptu i okna wyników:

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

Wynik skryptu nie wyświetla samego skryptu.

Przekroczenie czasu skryptu w agent

Możesz napotkać sytuację, w której podczas wykonywania skryptu występuje przekroczenie czasu.

Poniżej znajduje się przykład skryptu uruchamianego na agent oraz okno z wynikiem:

sleep 5
df -h

Komunikat błędu w tym przypadku jest następujący:

Timeout while executing a shell script.

Aby uniknąć takich sytuacji, zaleca się optymalizację samego skryptu (w powyższym przykładzie, "5") zamiast dostosowywania parametru Timeout w konfiguracji agenta Zabbix oraz konfiguracji serwera Zabbix.

Jeśli parametr Timeout został zmieniony w konfiguracji agenta Zabbix, pojawi się następujący komunikat błędu:

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

Oznacza to, że zmiana została wprowadzona w konfiguracji agenta Zabbix, ale konieczna jest również modyfikacja parametru Timeout w konfiguracji serwera Zabbix.

Limit czasu skryptu dla agentów aktywnych

Skrypty można wykonywać na agentach działających w trybie aktywnym (od wersji Zabbix 7.0). Po wyzwoleniu wykonania skryptu przez operację akcji lub ręczne wykonanie skryptu polecenie jest uwzględniane w konfiguracji aktywnych kontroli i wykonywane, gdy aktywny agent je otrzyma.

Skrypty uruchamiane ręcznie są wysyłane do aktywnego agenta wraz z limitem czasu serwera/proxy na wykonanie skryptu. Zwiększ domyślny limit czasu serwera/proxy na wykonanie skryptu. Limit czasu musi być większy niż częstotliwość odświeżania aktywnych kontroli. W przeciwnym razie limit czasu zostanie przekroczony, zanim aktywny agent otrzyma skrypt i będzie mógł zwrócić wynik.

Limit czasu skryptu na serwerze/proxy Zabbix

Poniżej przedstawiono przykład skryptu uruchamianego na serwerze Zabbix oraz okno wyniku:

sleep 11
df -h

Zaleca się również zoptymalizowanie samego skryptu (zamiast dostosowywania parametru TrapperTimeout do odpowiedniej wartości (w naszym przypadku > 11) poprzez modyfikację konfiguracji serwera Zabbix).

Co dalej?

8 Użytkownicy

Docs

3 Skrypty

Przegląd