JMX インターフェイスを使用したライブ モニタリング

JMX インターフェイス (Confluence 2.8 で導入) を使用すると、Confluence インスタンスのステータスをリアルタイムで監視できます。これにより、ご使用のインスタンスのリソース使用率やデータベース待ち時間など有益なデータを得られ、問題やパフォーマンス問題を診断することができます。JMX データを読み取るには、JMX クライアントを使用する必要があります。

JMX の無効化

JMX とは何か

JMX (Java Management eXtensions) is a technology for monitoring and managing Java applications. JMX uses objects called MBeans (Managed Beans) to expose data and resources from your application.

1. Tomcat で JMX リモートを有効化する

By default, Confluence uses the Apache Tomcat web server. To use JMX, you must enable it on your Tomcat server, by carrying out the steps under the Apache Tomcat documentation, entitled Enabling JMX Remote. With those steps completed, restart your Tomcat server.

スタンドアロン型の場合、スタートアップ パラメーター Dcom.sun.management.jmxremote を setenv.sh またはsetenv.bat に追加します。「JIRA のアプリケーションメモリ容量を増やす」の説明を参照して、PermGen メモリと同じ場所に入れます。

2. JMX クライアントを選択する

You need to use a JMX client in order to view the JMX output from Confluence. JConsole is a readily available JMX client that is included with the supported Java Developer Kit (version 5 onwards). The full name is the 'Java Monitoring and Management Console', but we will refer to it as JConsole for the purposes of this document.

3. JMX クライアントをパスに追加する

ユーザーは、JConsole のバイナリファイルのロケーションをパス環境変数に追加する必要があります。JConsole は、Java ディレクトリ下の 'bin' (バイナリ) フォルダーにあるため、パスは次のような形式になります。

JDK_HOME/bin/

この例では、 'JDK_HOME' をご使用の Java ディレクトリへの完全システムパスに置き換えます。

4. JConsole を設定する

JConsole の設定手順

1. JConsole アプリケーションを実行します。

2. 新しい接続を作成するようプロンプトが出されます。リモートプロセスを選択して、Confluence インスタンスのホスト名と選択するポートを入力します。

   簡単に接続するには、以下のスタートアップ パラメーターを setenv.bat または setenv.sh に追加します。
   -Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port=8086 -Dcom.sun.management.jmxremote.authenticate=false
   ポート 8086 が使用される可能性はほとんどありません。したがって、ポート 8086 を使用してリモートで接続します。

   JConsole などの JMX クライアントは同じユーザーによって所有されていないアプリケーションを認識しません。たとえば、Windows 環境では、アプリケーションがサービスとして起動される場合、そのプロセスを所有するのは現在のユーザーではなく、システムユーザーです。

3. Click Connect.

注意: JConsole 以外の他の JMX クライアントは、Confluence から JMX 情報を読み取ることができます。

JMX を使用して何を監視できますか?

JMX インターフェイスを使用することで、Confluence インスタンスの現時点の内部情報を以下の MBean を介して表示することができます。

IndexingStatistics

この MBean は検索インデックス作成に関連する情報を表示します。

システム情報

This MBean shows information related to database latency. It also contains most of the information presented on the System Information page.

RequestMetrics

この MBean はシステム負荷と表示されたエラーページに関連する情報を表示します。

MailServer-SMTPServer

この MBean は、メールディスパッチの試行と失敗に関連する情報を表示します。Confluence インスタンスで設定された SMTP メールサーバーごとに MBean があります。

MailTaskQueue

この MBean は、メールワークロードに関連する情報を示します。

SchedulingStatistics

この MBean は現在のジョブ、スケジュール済みタスク、およびそれらが最後に実行された時間に関連する情報を表示します。

CPU 消費が高いスレッド

For Java 1.6, add the Top Threads Plugin to monitor whether CPU is spiking. Download it to a directory and run JConsole like this:
JConsole -pluginpath /pathto/topthreads.jar

これは、JDK 1.6 でのみ有効ですが、サーバーがこれより下のバージョンを実行している場合は、リモートマシン上で使用できます。