- ソースからのセットアップ

概要

ソースからインストールした場合、次の情報はZabbix Javaゲートウェイのセットアップに役立ちます。

ファイルの概要

ソースからJavaゲートウェイを取得した場合、シェル スクリプト、JAR、および設定ファイルのコレクションが$PREFIX/sbin/zabbix_javaの下にあるはずです。 これらのファイルの役割を以下にまとめます。

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

JavaゲートウェイJARファイル本体

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

Javaゲートウェイの依存関係: Logback、SLF4J、および [Android JSON](https://android.googlesource .com/platform/libcore/+/master/json)ライブラリ。

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

Logbackの構成ファイル。

shutdown.sh  
startup.sh

Javaゲートウェイを開始および停止するための便利なスクリプト。

settings.sh

上記の起動スクリプトとシャットダウンスクリプトによって提供される設定ファイル。

Javaゲートウェイの設定と実行

デフォルトでは、Javaゲートウェイはポート10052でリッスンします。別のポートでJavaゲートウェイを実行したい場合は、settings.shスクリプトで指定できます。このオプションやその他のオプションの指定方法については、Javaゲートウェイ設定ファイルの説明を参照してください。

ポート10052はIANA登録済みではありません。

設定完了後、起動スクリプトを実行してJavaゲートウェイを起動できます。

./startup.sh

同様にJavaゲートウェイが不要になったら、シャットダウンスクリプトを実行して停止できます。

./shutdown.sh

サーバーやプロキシとは異なり、Javaゲートウェイは軽量でありデータベースを必要としません。

Javaゲートウェイを使用するためのサーバー設定

Javaゲートウェイが稼働している状態で、ZabbixサーバーにZabbix Javaゲートウェイの場所を伝える必要があります。これはサーバー設定ファイルでJavaGatewayおよびJavaGatewayPortパラメーターを指定することによって行われます。JMXアプリケーションが実行されているホストがZabbixプロキシによって監視されている場合は、代わりにプロキシ設定ファイルで接続パラメーターを指定します。

JavaGateway=192.168.3.14
JavaGatewayPort=10052

デフォルトでは、サーバーはJMX監視に関連するプロセスを開始しません。使用する場合は、事前にフォークされたJavaポーラーのインスタンスの数を指定する必要があります。これは通常のポーラーとトラッパーを指定するのと同じ方法で行います。

StartJavaPollers=5

設定が完了したら、サーバーまたはプロキシを再起動してください。

Javaゲートウェイのデバッグ

Javaゲートウェイに問題がある場合、またはフロントエンドのアイテムについて表示されるエラーメッセージが十分でない場合は、Javaゲートウェイのログファイルを確認することをお勧めします。

デフォルトでは、Javaゲートウェイはそのアクティビティを/tmp/zabbix_java.logファイルにログレベル"info"で記録します。その情報だけでは不十分な場合、ログレベル"debug"の情報を取得する必要があります。ログレベルを上げるには、lib/logback.xmlファイルを変更し、<root>タグのlevel属性を"debug"に変更します。

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

ZabbixサーバーやZabbixプロキシとは異なり、logback.xmlファイルを変更した後にZabbix Javaゲートウェイを再起動する必要はありません。logback.xmlの変更は自動的に取得されます。デバッグが完了したら、ログレベルを"info"に戻すことができます。

別のファイルまたはデータベースのようなまったく別のメディアにログを記録する場合は、必要に応じてlogback.xmlファイルを調整します。 詳細については、Logback Manualを参照してください。

デバッグ目的の場合、デーモンではなくコンソールアプリケーションとしてJavaゲートウェイを起動すると便利な場合があります。これを行うには、settings.shでPID_FILE変数をコメントアウトします。PID_FILEを省略した場合、startup.shスクリプトはJavaゲートウェイをコンソールアプリケーションとして起動し、代わりにLogbackにlib/logback-console.xmlファイルを使用させます。これにより、コンソールにログが記録されるだけでなく、ログ レベル"debug"も有効になります。

最後に、JavaゲートウェイはロギングにSLF4Jを使用するため、適切なJARファイルをlibディレクトリに配置することで、Logbackを選択したフレームワークに置き換えることができます。詳細については、SLF4J Manualを参照してください。

JMX監視

詳しくはJMX監視ページをご覧ください。