Einrichtung aus den Quellen

Übersicht

Wenn Zabbix Java gateway aus den Quellen installiert wurde, helfen Ihnen die folgenden Informationen bei der Einrichtung.

Ü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 Funktion dieser Dateien wird nachstehend zusammengefasst.

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

Die JAR-Datei von Java gateway selbst.

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 von Java gateway: die Bibliotheken Logback, SLF4J und Android JSON.

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

Konfigurationsdateien für Logback.

shutdown.sh  
startup.sh

Hilfsskripte zum Starten und Stoppen von Java gateway.

settings.sh

Konfigurationsdatei, die von den oben genannten Start- und Stoppskripten eingelesen wird.

Konfiguration und Ausführung von Java gateway

Standardmäßig lauscht Java gateway auf Port 10052. Wenn Sie planen, Java gateway auf einem anderen Port auszuführen, können Sie dies im Skript settings.sh angeben. In der Beschreibung der Java gateway-Konfigurationsdatei finden Sie Informationen dazu, wie Sie diese und andere Optionen festlegen.

Port 10052 ist nicht bei IANA registriert.

Sobald Sie mit den Einstellungen zufrieden sind, können Sie Java gateway durch Ausführen des Startskripts starten:

./startup.sh

Ebenso können Sie, wenn Sie Java gateway nicht mehr benötigen, das Shutdown-Skript ausführen, um ihn zu stoppen:

./shutdown.sh

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

Konfigurieren des Servers für die Verwendung mit Java gateway

Wenn Java gateway läuft, müssen Sie dem Zabbix Server mitteilen, wo 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 läuft, 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 für die JMX-Überwachung. Wenn Sie diese jedoch verwenden möchten, müssen Sie die Anzahl der vorab gestarteten Instanzen von Java-Pollern angeben. Dies erfolgt auf dieselbe Weise wie bei der Angabe regulärer Poller und Trapper.

StartJavaPollers=5

Vergessen Sie nicht, den Server oder Proxy neu zu starten, sobald Sie die Konfiguration abgeschlossen haben.

Debugging des Java gateway

Falls es Probleme mit dem Java gateway gibt oder eine Fehlermeldung, die Sie zu einem Datenpunkt im Frontend sehen, nicht aussagekräftig genug ist, sollten Sie einen Blick in die Protokolldatei des Java gateway werfen.

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

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

Beachten Sie, dass im Gegensatz zu Zabbix Server oder Zabbix Proxy kein Neustart des 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 die Protokollierungsstufe 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 Ihren Anforderungen entsprechend an. Weitere Details finden Sie im Logback Manual.

Manchmal ist es zu Debugging-Zwecken nützlich, das Java gateway als Konsolenanwendung statt als Daemon zu starten. Kommentieren Sie dazu die Variable PID_FILE in settings.sh aus. Wenn PID_FILE weggelassen wird, startet das Skript startup.sh das Java gateway als Konsolenanwendung und veranlasst Logback, stattdessen die Datei lib/logback-console.xml zu verwenden, die nicht nur auf der Konsole protokolliert, sondern auch die Protokollierungsstufe "debug" aktiviert hat.

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

JMX-Überwachung

Siehe die Seite JMX monitoring für weitere Details.