JBoss エージェントが JBoss サーバーの Web メトリックやその他のサブシステム・メトリックを収集できるようにするには、各サブシステムに対して統計の収集を有効にする必要があります。この手順は、JBoss EAP バージョン 7.x と WildFly バージョン 8.x、9.x、および 10.x 用です。
手順
各種 JBoss サブシステムの statistics-enabled 属性により、統計収集が制御されます。この設定は、JBoss コマンド・ライン・インターフェースを使用して表示および更新できます。
注: この手順は、JBoss EAP バージョン 7.x と WildFly バージョン 8.x、9.x、および 10.x 用です。
-
JBoss サーバーのインストール・ディレクトリーの下のバイナリー、つまり bin ディレクトリーに移動します。
-
JBoss コマンド・ライン・インターフェースを開始します。
./jboss-cli.sh
--connect
[--controller=IP:port]
jboss-cli.bat
--connect
[--controller=IP:port]
ここで IP は JBoss サーバーの IP アドレス、port は JBoss サーバーのポートです。例: 192.168.10.20:9990
ヒント: 接続試行の結果として次のエラーが生じる場合があります。「
Failed to connect to the controller: The controller is not available at localhost:9990: java.net.ConnectException: WFLYPRT0053: Could not connect to http-remoting://localhost:9990. The
connection failed: WFLYPRT0053: Could not connect to http-remoting://localhost:9990. The connection failed: Connection refused」。この場合、
--controller パラメーターを使用します。
このエラーは、管理サーバーが localhost の IP アドレス (127.0.0.1) を listen していないこと、およびコンピューターの IP アドレスを listen するように構成されていることを示します。
-
以下のコマンドを実行して、各サブシステムの statistics-enabled 属性の現在の状態を表示します。
注: JBoss をドメイン・モードで実行している場合は、各コマンドの先頭に、関連するプロファイルを指定する必要があります。また、これらのコマンドをモニター対象のプロファイルごとに実行する必要があります。例:
/profile=full/subsystem=ejb3:read-attribute(name=statistics-enabled)
/subsystem=ejb3:read-attribute(name=enable-statistics)
/subsystem=transactions:read-attribute(name=statistics-enabled)
/subsystem=undertow:read-attribute(name=statistics-enabled)
/subsystem=webservices:read-attribute(name=statistics-enabled)
/subsystem=datasources/data-source=Data_Source_Name:read-attribute(name=statistics-enabled)
/subsystem=datasources/data-source=Data_Source_Name/statistics=pool:read-attribute(name=statistics-enabled)
/subsystem=datasources/data-source=Data_Source_Name/statistics=jdbc:read-attribute(name=statistics-enabled)
ここで Data_Source_Name は JBoss で使用するように構成されているデータ・ソースの名前です。
注: コマンド /subsystem=datasources:read-resource を使用すると、データ・ソースをリストできます。
統計が有効ではないときの、結果例は次のとおりです。
{
"outcome" => "success",
"result" => false
}
-
以下のコマンドを実行して、各サブシステムの statistics-enabled 属性の値を true に変更します。
/subsystem=ejb3:write-attribute(name=enable-statistics, value=true)
/subsystem=transactions:write-attribute(name=statistics-enabled,value=true)
/subsystem=undertow:write-attribute(name=statistics-enabled,value=true)
/subsystem=webservices:write-attribute(name=statistics-enabled,value=true)
/subsystem=datasources/data-source=Data_Source_Name:write-attribute(name=statistics-enabled,value=true)
/subsystem=datasources/data-source=Data_Source_Name/statistics=pool:write-attribute(name=statistics-enabled,value=true)
/subsystem=datasources/data-source=Data_Source_Name/statistics=jdbc:write-attribute(name=statistics-enabled,value=true)
サブシステムの統計を有効にした場合、次の例のような結果になります。
{
"outcome" => "success",
"response-headers" => {
"operation-requires-reload" => true,
"process-state" => "reload-required"
}
}
- JBoss コマンド・ライン・インターフェースを終了します。
- JBoss サーバーを再始動します。
注: 現在実行中の、トランザクション・トラッキングが有効な JBoss エージェントは再始動する必要があります。