Konfiguracja ze źródeł

Przegląd

Jeśli zainstalowano ze źródeł, poniższe informacje pomogą w konfiguracji Zabbix Java gateway.

Przegląd plików

Jeśli uzyskano Java gateway ze źródeł, powinien powstać zestaw skryptów powłoki, plików JAR i plików konfiguracyjnych w katalogu $PREFIX/sbin/zabbix_java. Rola tych plików została podsumowana poniżej.

bin/zabbix-java-gateway-$VERSION.jar

Sam plik JAR Java gateway.

lib/logback-core-1.5.16.jar
lib/logback-classic-1.5.16.jar
lib/slf4j-api-2.0.16.jar
lib/android-json-4.3_r3.1.jar

Zależności Java gateway: Logback, SLF4J oraz biblioteka Android JSON.

lib/logback.xml  
lib/logback-console.xml

Pliki konfiguracyjne dla Logback.

shutdown.sh  
startup.sh

Pomocnicze skrypty do uruchamiania i zatrzymywania Java gateway.

settings.sh

Plik konfiguracyjny wczytywany przez powyższe skrypty startup i shutdown.

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 określić to w skrypcie settings.sh. Zobacz opis pliku konfiguracyjnego Java gateway, aby dowiedzieć się, jak określić tę i inne opcje.

Gdy ustawienia będą już odpowiednie, możesz uruchomić Java gateway, wykonując skrypt startowy:

./startup.sh

Podobnie, gdy Java gateway nie będzie już potrzebny, uruchom skrypt zatrzymania, aby go wyłączyć:

./shutdown.sh

Zwróć uwagę, że w przeciwieństwie do serwer lub proxy, Java gateway jest lekki i nie wymaga bazy danych.

Konfigurowanie serwera do użycia z Java gateway

Gdy Java gateway jest uruchomiony i działa, należy poinformować serwer Zabbix, gdzie znajduje się Zabbix Java gateway. Odbywa się to przez określenie parametrów JavaGateway oraz JavaGatewayPort w pliku konfiguracyjnym serwera. Jeśli host, na którym działa aplikacja JMX, jest monitorowany przez Zabbix proxy, należy zamiast tego określić parametry połączenia w pliku konfiguracyjnym proxy.

JavaGateway=192.168.3.14
JavaGatewayPort=10052

Domyślnie serwer nie uruchamia żadnych procesów związanych z monitorowaniem JMX. Jeśli jednak chcesz z niego korzystać, musisz określić liczbę wstępnie utworzonych instancji procesów Java poller. Robi się to w taki sam sposób, jak w przypadku zwykłych pollerów i trapperów.

StartJavaPollers=5

Nie zapomnij zrestartować serwera lub proxy po zakończeniu ich konfiguracji.

Debugowanie Java gateway

W przypadku jakichkolwiek problemów z Java gateway lub gdy komunikat o błędzie, który widzisz dla pozycji we frontend, nie jest wystarczająco opisowy, warto zajrzeć do pliku dziennika Java gateway.

Domyślnie Java gateway zapisuje swoją aktywność do pliku /tmp/zabbix_java.log z poziomem logowania „info”. Czasami te informacje nie są wystarczające i potrzebne są informacje z poziomu logowania „debug”. Aby zwiększyć poziom logowania, zmodyfikuj plik lib/logback.xml i zmień atrybut level znacznika <root> na „debug”:

<root level="debug">
  <appender-ref ref="FILE" />
</root>

Zwróć uwagę, że w przeciwieństwie do Zabbix server lub Zabbix proxy, nie ma potrzeby ponownego uruchamiania Zabbix Java gateway po zmianie pliku logback.xml — zmiany w logback.xml zostaną wykryte automatycznie. Po zakończeniu debugowania możesz przywrócić poziom logowania do „info”.

Jeśli chcesz zapisywać logi do innego pliku lub do całkowicie innego medium, takiego jak baza danych, dostosuj plik logback.xml do swoich potrzeb. Więcej szczegółów znajdziesz w podręczniku Logback.

Czasami na potrzeby debugowania przydatne jest uruchomienie Java gateway jako aplikacji konsolowej zamiast jako demona. Aby to zrobić, zakomentuj zmienną PID_FILE w settings.sh. Jeśli PID_FILE zostanie pominięte, skrypt startup.sh uruchomi Java gateway jako aplikację konsolową i sprawi, że Logback będzie używać pliku lib/logback-console.xml, który nie tylko zapisuje logi do konsoli, ale ma również włączony poziom logowania „debug”.

Na koniec zwróć uwagę, że ponieważ Java gateway używa SLF4J do logowania, możesz zastąpić Logback frameworkiem według własnego wyboru, umieszczając odpowiedni plik JAR w katalogu lib. Więcej szczegółów znajdziesz w podręczniku SLF4J.

Monitorowanie JMX

Więcej szczegółów znajduje się na stronie Monitorowanie JMX.