11 Kontrole zewnętrzne

Przegląd

Sprawdzenie zewnętrzne to sprawdzenie wykonywane przez serwer Zabbix poprzez uruchomienie skryptu powłoki lub pliku binarnego. Jednak gdy hosty są monitorowane przez proxy Zabbix, sprawdzenia zewnętrzne są wykonywane przez proxy.

Sprawdzenia zewnętrzne nie wymagają uruchomionego agenta na monitorowanym hoście.

Składnia klucza pozycji jest następująca:

script[<parameter1>,<parameter2>,...]

Gdzie:

ARGUMENT DEFINITION
script Nazwa skryptu powłoki lub pliku binarnego.
parameter(s) Opcjonalne parametry wiersza poleceń.

Jeśli nie chcesz przekazywać żadnych parametrów do skryptu, możesz użyć:

script[] or
script

serwer Zabbix lub proxy wyszuka katalog określony dla skryptów zewnętrznych i wykona polecenie (zobacz parametr ExternalScripts w pliku konfiguracyjnym Zabbix server/proxy). Polecenie zostanie wykonane z uprawnieniami tego samego użytkownika co serwer/proxy Zabbix, dlatego wszelkie uprawnienia dostępu lub zmienne środowiskowe powinny być w razie potrzeby obsłużone w skrypcie opakowującym. Uprawnienia do polecenia również muszą pozwalać temu użytkownikowi na jego wykonanie. Do wykonania dostępne są tylko polecenia znajdujące się w określonym katalogu.

Nie należy nadużywać sprawdzeń zewnętrznych, ponieważ każdy skrypt wymaga uruchomienia procesu fork przez serwer/proxy Zabbix, a uruchamianie wielu skryptów może znacząco obniżyć wydajność Zabbix.

Przykład użycia

Wykonanie skryptu check_oracle.sh z pierwszym parametrem '-h'. Drugi parametr zostanie zastąpiony adresem IP lub nazwą DNS, w zależności od wyboru we właściwościach hosta.

check_oracle.sh["-h","{HOST.CONN}"]

Zakładając, że host jest skonfigurowany do używania adresu IP, serwer/proxy Zabbix wykona:

check_oracle.sh '-h' '192.168.1.4'

Wynik kontroli zewnętrznej

Wartością zwracaną kontroli zewnętrznej jest standardowe wyjście wraz ze standardowym wyjściem błędów generowanym przez kontrolę.

Pozycja zwracająca tekst (informacja typu znakowego, log lub tekst) nie stanie się nieobsługiwana w przypadku standardowego wyjścia błędów.

Wartość zwracana jest ograniczona do 16 MB (włącznie z końcowymi białymi znakami, które są obcinane); obowiązują również ograniczenia bazy danych.

Jeśli żądany skrypt nie zostanie znaleziony lub serwer/proxy Zabbix nie ma uprawnień do jego wykonania, pozycja stanie się nieobsługiwana i zostanie wyświetlony odpowiedni komunikat o błędzie.

W przypadku przekroczenia limitu czasu pozycja stanie się nieobsługiwana, zostanie wyświetlony odpowiedni komunikat o błędzie, a proces utworzony dla skryptu zostanie zakończony.