3 Einrichtung aus den Quellen

Übersicht

Wenn Sie aus den Quellen installiert haben, hilft Ihnen die folgende Information bei der Einrichtung des Zabbix Java gateway.

Übersicht der Dateien

Wenn Sie Java gateway aus den Quellen bezogen haben, sollten Sie unter $PREFIX/sbin/zabbix_java eine Sammlung von Shell-Skripten, JAR- und Konfigurationsdateien vorfinden. Die Rolle dieser Dateien ist unten zusammengefasst.

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

Die eigentliche JAR-Datei des 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

Abhängigkeiten des Java gateway: Logback, SLF4J und die Android JSON-Bibliothek.

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

Konfigurationsdateien für Logback.

shutdown.sh  
startup.sh

Hilfsskripte zum Starten und Stoppen des Java gateway.

settings.sh

Konfigurationsdatei, die von den oben genannten Startup- und Shutdown-Skripten eingelesen wird.

Konfigurieren und Starten von Java gateway

Standardmäßig lauscht Java gateway auf Port 10052. Wenn Sie Java gateway auf einem anderen Port ausführen möchten, können Sie dies im Skript settings.sh angeben. Siehe die Beschreibung der Java gateway-Konfigurationsdatei, um zu erfahren, wie Sie dies und andere Optionen festlegen.

Port 10052 ist nicht bei IANA registriert.

Sobald Sie mit den Einstellungen vertraut sind, können Sie Java gateway starten, indem Sie das Skript startup.sh ausführen:

./startup.sh

Ebenso können Sie, wenn Sie Java gateway nicht mehr benötigen, das Skript shutdown.sh ausführen, um es zu stoppen:

./shutdown.sh

Beachten Sie, dass Java gateway im Gegensatz zu Server oder Proxy leichtgewichtig ist und keine Datenbank benötigt.

Konfiguration des Servers für die Verwendung mit Java gateway

Wenn Java gateway läuft, müssen Sie dem Zabbix Server mitteilen, wo das Zabbix Java gateway zu finden ist. Dies geschieht durch Angabe der Parameter JavaGateway und JavaGatewayPort in der Server-Konfigurationsdatei. Wenn der Host, auf dem die JMX-Anwendung ausgeführt wird, von einem Zabbix Proxy überwacht wird, geben Sie die Verbindungsparameter stattdessen in der Proxy-Konfigurationsdatei an.

JavaGateway=192.168.3.14
JavaGatewayPort=10052

Standardmäßig startet der Server keine Prozesse, die mit der JMX-Überwachung zusammenhängen. Wenn Sie sie jedoch verwenden möchten, müssen Sie die Anzahl der vorab erzeugten Instanzen der Java-Poller angeben. Dies tun Sie auf dieselbe Weise, wie Sie reguläre Poller und Trapper angeben.

StartJavaPollers=5

Vergessen Sie nicht, den Server oder Proxy neu zu starten, sobald Sie mit der Konfiguration fertig sind.

Debugging Java gateway

Falls es Probleme mit Java gateway gibt oder eine Fehlermeldung, die Sie in Bezug auf einen Datenpunkt im Frontend sehen, nicht aussagekräftig genug ist, sollten Sie sich die Protokolldatei von Java gateway ansehen.

Standardmäßig protokolliert Java gateway seine Aktivitäten in die Datei /tmp/zabbix_java.log mit dem Protokollierungsgrad "info". Manchmal reicht diese Information nicht aus, und es werden Informationen auf dem Protokollierungsgrad "debug" benötigt. Um den Protokollierungsgrad zu erhöhen, ändern Sie die Datei lib/logback.xml und setzen Sie das Attribut level des <root>-Tags auf debug:

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

Beachten Sie, dass im Gegensatz zu Zabbix server oder Zabbix proxy kein Neustart von Zabbix Java gateway nach dem Ändern der Datei logback.xml erforderlich ist - Änderungen in logback.xml werden automatisch übernommen. Wenn Sie mit dem Debugging fertig sind, können Sie den Protokollierungsgrad wieder auf "info" zurücksetzen.

Wenn Sie in eine andere Datei oder in ein völlig anderes Medium wie eine Datenbank protokollieren möchten, passen Sie die Datei logback.xml entsprechend Ihren Anforderungen an. Weitere Details finden Sie im Logback Manual.

Manchmal ist es zu Debugging-Zwecken nützlich, Java gateway als Konsolenanwendung statt als Daemon zu starten. Dazu kommentieren Sie die Variable PID_FILE in settings.sh aus. Wenn PID_FILE weggelassen wird, startet das Skript startup.sh Java gateway als Konsolenanwendung und veranlasst Logback außerdem, die Datei lib/logback-console.xml zu verwenden, die nicht nur in die Konsole protokolliert, sondern auch den Protokollierungsgrad "debug" aktiviert.

Abschließend beachten Sie bitte, dass Java gateway für die Protokollierung SLF4J verwendet. Daher können Sie Logback durch ein Framework Ihrer Wahl ersetzen, indem Sie eine geeignete JAR-Datei im Verzeichnis lib ablegen. Weitere Details finden Sie im SLF4J Manual.

JMX-Überwachung

Weitere Details finden Sie auf der Seite JMX monitoring.