3 Instalacja z kodu źródłowego

Przegląd

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

Przegląd plików

Jeśli pobrano Java gateway ze źródeł, powinien zostać utworzony 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: biblioteka Logback, SLF4J oraz 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, który jest 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 uruchamiać 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.

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

./startup.sh

Analogicznie, gdy Java gateway nie będzie już potrzebny, uruchom skrypt shutdown.sh, aby go zatrzymać:

./shutdown.sh

Należy pamiętać, ż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 wskazać serwerowi Zabbix, gdzie ma znaleźć Zabbix Java gateway. W tym celu należy określić parametry JavaGateway i JavaGatewayPort w pliku konfiguracyjnym serwera. Jeśli host, na którym działa aplikacja JMX, jest monitorowany przez proxy Zabbix, parametry połączenia należy określić zamiast tego 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 rozwidlonych instancji pollerów Java. Robi się to w taki sam sposób, jak określa się zwykłe pollery i trappers.

StartJavaPollers=5

Nie zapomnij ponownie uruchomić serwera lub proxy po zakończeniu konfiguracji.

Debugowanie Java gateway

W przypadku problemów z Java gateway lub gdy komunikat o błędzie dotyczący pozycja w frontendzie nie jest wystarczająco opisowy, warto zajrzeć do pliku dziennika Java gateway.

Domyślnie Java gateway zapisuje swoje działania do pliku /tmp/zabbix_java.log z poziomem logowania "info". Czasami te informacje nie są wystarczające i potrzebne są dane na poziomie 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>

Należy pamiętać, że w przeciwieństwie do serwer lub proxy Zabbix, po zmianie pliku logback.xml nie ma potrzeby ponownego uruchamiania Java gateway Zabbix - zmiany w logback.xml zostaną automatycznie uwzględnione. Po zakończeniu debugowania możesz przywrócić poziom logowania do "info".

Jeśli chcesz zapisywać logi do innego pliku lub całkowicie innego medium, na przykład bazy danych, dostosuj plik logback.xml do swoich potrzeb. Więcej informacji znajdziesz w Logback Manual.

Czasami w celach debugowania przydatne jest uruchomienie Java gateway jako aplikacji konsolowej zamiast demona. Aby to zrobić, zakomentuj zmienną PID_FILE w settings.sh. Jeśli PID_FILE zostanie pominięta, 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 należy pamiętać, że ponieważ Java gateway używa SLF4J do logowania, możesz zastąpić Logback wybranym przez siebie frameworkiem, umieszczając odpowiedni plik JAR w katalogu lib. Więcej informacji znajdziesz w SLF4J Manual.

Monitorowanie JMX

Zobacz stronę Monitorowanie JMX, aby uzyskać więcej informacji.