Documentation
Table of Contents
1 Konfiguracja ze źródeł
Przegląd
Jeśli zainstalowano ze źródeł, poniższe informacje pomogą Ci skonfigurować Zabbix Java Gateway.
Przegląd plików
Jeśli postawiłeś Java gateway ze źródeł, powinieneś otrzymać kolekcję skryptów powłoki, plików JAR i plików konfiguracyjnych w katalogu $PREFIX/sbin/zabbix_java. Rolę tych plików podsumowano poniżej.
Sam plik JAR Java gateway.
lib/logback-core-0.9.27.jar
lib/logback-classic-0.9.27.jar
lib/slf4j-api-1.6.1.jar
lib/android-json-4.3_r3.1.jarZależności Java gateway: Logback, SLF4J, i Android JSON library.
Pliki konfiguracyjne dla Logback.
Wygodne skrypty do uruchamiania i zatrzymywania Java gateway.
Plik konfiguracyjny, który jest załączany do powyższych skruptów uruchamiania i zatrzymywania.
Konfigurowanie i uruchamianie Java gateway
Domyślnie Java gateway nasłuchuje na porcie 10052. Jeśli planujesz uruchomić Java gateway na innym porcie, możesz to określić w skrypcie settings.sh. Zobacz opis pliku konfiguracyjnego Java gateway , aby dowiedzieć się, jak określić tę i inne opcje.
Port 10052 nie jest zarejestrowany w IANA.
Po zapoznaniu się z ustawieniami możesz uruchomić Java gateway uruchamiając skrypt startowy:
Podobnie, gdy Java gateway nie będzie już potrzebny, uruchom skrypt zamykający, aby ją zatrzymać:
Należy pamiętać, że w przeciwieństwie do serwera lub proxy, Java gateway jest lekka i nie wymaga bazy danych.
Konfigurowanie serwera do użytku z Java gateway
Gdy Java gateway jest już uruchomiona, musisz poinformować serwer Zabbix gdzie znajduje się Zabbix Java gateway. Odbywa się to poprzez określenie parametrów JavaGateway i JavaGatewayPort w pliku konfiguracyjnym serwera. Jeśli host, na którym działa aplikacja JMX, jest monitorowany przez proxy Zabbix, zamiast tego należy określić parametry połączenia w pliku konfiguracyjnym proxy.
Domyślnie serwer nie uruchamia żadnych procesów związanych z monitorowaniem JMX. Jeśli jednak chcesz z niego skorzystać, musisz określić wstępną liczbę podprocesów instancji pollerów Java. Robi się to w ten sam sposób, w jaki określa się zwykłe pollery and trappery.
Nie zapomnij zrestartować serwera lub proxy po zakończeniu ich konfiguracji.
Debugowanie Java gateway
W przypadku problemów z Java gateway ub jeśli komunikat o błędzie który istnieje na pozycji w frontendie nie jest wystarczająco dokładny, warto zajrzeć do pliku logu Java gateway.
Domyślnie Java rejestruje swoje działania w pliku /tmp/zabbix_java.log file z poziomem logowania "info". Czasami te informacje nie są wystarczające i potrzebne są informacje na poziomie "debug". Aby zwiększyć poziom logowania, zmodyfikuj plik lib/logback.xml i zmień atrybut poziomu znacznika <root> na "debug":
Należy pamiętać, że w przeciwieństwie do serwera Zabbix lub proxy Zabbix, nie ma potrzeby ponownego uruchamiania Zabbix Java gateway po zmianie pliku logback.xml - zmiany w pliku logback.xml zostaną pobrane automatycznie. Po zakończeniu debugowania możesz przywrócić poziom rejestrowania do "info".
Jeśli chcesz rejestrować logi do innego pliku lub zupełnie innego celu jak baza danych, dostosuj plik logback.xml do swoich potrzeb. Więcej szczegółów znajdziesz w instrukcji Logback.
Czasami do celów debugowania przydatne jest uruchomienie Java gateway as a jako aplikacji konsolowej, a nie demona. Aby to zrobić, zakomentuj zmienną PID_FILE w pliku settings.sh. Jeśli pominięto PID_FILE, skrypt startup.sh uruchamia Java gateway jako aplikację konsolową i powoduje, że Logback używa pliku lib/logback-console.xml, który nie tylko rejestruje logi do konsoli, ale także ma włączone logowanie na poziomie "debug".
Na koniec zauważ, że ponieważ Java gateway używa SLF4J do logowania, możesz zastąpić Logback innym wybranym frameworkiem, umieszczając odpowiedni plik JAR w katalogu. Więcej szczegółów znajdziesz w Instrukcji SLF4J.
Monitorowanie JMX
Zobacz stronę monitorowania JMX po więcej szczegółów.