|
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.
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.
For the stand-alone, add the startup parameter -Dcom.sun.management.jmxremote to setenv.sh or setenv.bat. See instructions for the Windows Service - enter it in the same place as PermGen Memory.
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.
ユーザーは、JConsole のバイナリファイルのロケーションをパス環境変数に追加する必要があります。JConsole は、Java ディレクトリ下の 'bin' (バイナリ) フォルダーにあるため、パスは次のような形式になります。
JDK_HOME/bin/ |
この例では、 'JDK_HOME' をご使用の Java ディレクトリへの完全システムパスに置き換えます。
JConsole の設定手順
新しい接続を作成するようプロンプトが出されます。リモートプロセスを選択して、Confluence インスタンスのホスト名と選択するポートを入力します。
簡単に接続するには、以下のスタートアップ パラメーターを setenv.bat または setenv.sh に追加します。 |
JConsole などの JMX クライアントは同じユーザーによって所有されていないアプリケーションを認識しません。たとえば、Windows 環境では、アプリケーションがサービスとして起動される場合、そのプロセスを所有するのは現在のユーザーではなく、システムユーザーです。 |
注意: JConsole 以外の他の JMX クライアントは、Confluence から JMX 情報を読み取ることができます。
JMX インターフェイスを使用することで、Confluence インスタンスの現時点の内部情報を以下の MBean を介して表示することができます。
この MBean は検索インデックス作成に関連する情報を表示します。
プロパティ名 | 機能 | 値 |
|---|---|---|
Flushing | キャッシュの状態 (フラッシュの有無) を表示。 | True/False |
LastElapsedMilliseconds | 最後のインデックス作成の所要時間。 | ミリ秒 |
LastElapsedReindexing | 最後の再インデックス作成の所要時間。 | ミリ秒 |
TaskQueueLength | キューにあるタスクの数を表示。 | 整数 |
This MBean shows information related to database latency. It also contains most of the information presented on the System Information page.
プロパティ名 | 機能 | 値 |
|---|---|---|
DatabaseExampleLatency | データベース対して実行されたクエリ例の待ち時間を表示。 | ミリ秒 |
この MBean はシステム負荷と表示されたエラーページに関連する情報を表示します。
プロパティ名 | 機能 | 値 |
|---|---|---|
AverageExecutionTimeForLastTenRequests | 最新 10 件の要求の平均実行時間。 | ミリ秒 |
CurrentNumberOfRequestsBeingServed | この時点で提供されている要求の数。 | 整数 |
ErrorCount | Confluence エラーページが提供された回数。 | 整数 |
NumberOfRequestsInLastTenSeconds | 言うまでもなく、最近 10 秒間の要求数。 | 整数 |
この MBean は、メールディスパッチの試行と失敗に関連する情報を表示します。Confluence インスタンスで設定された SMTP メールサーバーごとに MBean があります。
プロパティ名 | 機能 | 値 |
|---|---|---|
EmailsAttempted | Confluence が送信しようとしたメールメッセージの数。 | 整数 |
EmailsSent | 正常に送信されたメールメッセージの数。 | 整数 |
この MBean は、メールワークロードに関連する情報を示します。
プロパティ名 | 機能 | 値 |
|---|---|---|
ErrorQueueSize | キュー内のエラー数。 | 整数 |
Flushing | 状態 (フラッシュの有無) を表示。 | True/False |
FlushStarted | 稼働を開始した時間。 | 時間 |
RetryCount | 実行された再試行の回数。 | 整数 |
TaskSize | ディスパッチのためにキューに入れられたメールメッセージの数。 | 整数 |
この MBean は現在のジョブ、スケジュール済みタスク、およびそれらが最後に実行された時間に関連する情報を表示します。
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 でのみ有効ですが、サーバーがこれより下のバージョンを実行している場合は、リモートマシン上で使用できます。
本番環境のインスタンスにライブ モニタリングを追加すると、パフォーマンスに影響を与える可能性があります。 |