次のコマンドを使用してJConsoleを起動します。

% jconsole

JConsoleが起動したら、JConsoleが接続可能なロカールで実行しているJavaアプリケーションのうち、必要なものを選択します。

特定のアプリケーションをモニターする場合、そのアプリケーションのプロセスIDがわかっていれば、JConsoleを起動して、そのアプリケーションに接続できます。この場合、アプリケーションはJConsoleと同じユーザーIDで実行する必要があります。次のコマンド構文を使用して、特定アプリケーションのローカル・モニタリングのためにJConsoleを起動します。

% jconsole processID

processIDは、アプリケーションのプロセスID (PID)です。アプリケーションのPIDを調べるには、次の手順を実行します。

• LinuxまたはmacOSシステムの場合、psコマンドを使用して、実行中のjavaインスタンスのPIDを見つけることができます。

• Windowsシステムの場合、タスク・マネージャを使用して、javaまたはjavawのPIDを見つけます。

• jpsコマンド行ユーティリティを使用してPIDを調べることもできます。Java Development Kitツール仕様のjpsに関する項を参照してください。

たとえば、NotepadアプリケーションのプロセスIDが2956である場合は、次のコマンドでJConsoleを起動します。

% jconsole 2956

JConsoleとアプリケーションは同じユーザーが実行する必要があります。管理およびモニタリング・システムは、オペレーティング・システムのファイル・アクセス権を使用します。プロセスIDを指定しない場合、JConsoleによってローカルのJavaアプリケーションがすべて自動的に検出され、モニターするアプリケーションを選択するためのダイアログ・ボックスが表示されます(「JMXエージェントへの接続」を参照)。

ローカル・モニタリングおよび管理を参照してください。

リモート・モニタリングのためにJConsoleを起動するには、次のコマンド構文を使用します。

% jconsole hostName:portNum

hostNameはアプリケーションを実行するシステムの名前、portNumは、Java VMを起動してJMXエージェントを有効にしたときに指定したポート番号です。リモート・モニタリングおよび管理を参照してください。

ホスト名/ポート番号の組み合わせを指定しない場合、JConsoleには、ホスト名とポート番号が入力可能な接続ダイアログ・ボックス(JMXエージェントへの接続)が表示されます。

Secure Sockets Layer (SSL)でセキュリティ保護された接続によりモニタリングを実行するよう、JConsoleを起動することもできます。セキュアな接続を使用してJConsoleを起動するコマンドは、JConsoleによるリモート・モニタリング(SSLが有効な場合)を参照してください。

接続するJMXエージェントを設定せずにJConsoleを起動すると、次のダイアログ・ボックスが表示されます。

図 3-1ローカル・プロセスへの接続の作成

ローカル・プロセス・オプションには、JConsoleと同じユーザーIDで起動され、ローカル・システム上で実行中のJava VMが、そのプロセスIDとクラス、または引数の情報とともに一覧表示されます。JConsoleをアプリケーションに接続するには、モニターするアプリケーションを選択して「接続」をクリックします。ローカル・プロセスのリストには、次のタイプのJava VMで実行中のアプリケーションが含まれます。

• 管理エージェントが有効なアプリケーション: Java SEプラットフォーム上のアプリケーションのうち、-Dcom.sun.management.jmxremoteオプションを使用して起動したもの、または-Dcom.sun.management.jmxremote.portオプションを指定して起動したものが含まれます。また、Java SEプラットフォーム上で管理プロパティなしで起動したアプリケーションのうち、あとからJConsoleによって接続が行われ、実行時に管理エージェントを有効になったものも含まれます。

• 接続可能で、管理エージェントが無効なアプリケーション: 実行時に管理エージェントのロードをサポートしている、接続可能なアプリケーションが含まれます。接続可能なアプリケーションには、Attach APIをサポートする、Java SEプラットフォーム上で起動したアプリケーションが含まれます。動的接続をサポートするアプリケーションについては、コマンド行でcom.sun.management.jmxremoteまたはcom.sun.management.jmxremote.portオプションを指定して管理エージェントを起動する必要ありません。JConsoleは、アプリケーションの起動前に管理エージェントに接続する必要はありません。このアプリケーションを選択すると、接続確立時に管理エージェントが有効になるという通知が画面上に表示されます。図3-1の接続ダイアログ・ボックスの例では、NetBeans IDEとJConsoleはJava SEプラットフォームVM内で起動しています。両方とも標準テキストで表示され、JConsoleが接続可能であることを示しています。図3-1では、JConsoleが選択され、通知が表示されています。

• 接続不可能で、管理エージェントが無効なアプリケーション: Java SEプラットフォームで、-Dcom.sun.management.jmxremoteまたはcom.sun.management.jmxremote.portオプションなしで起動したアプリケーションが含まれます。これらのアプリケーションは、表にグレー表示され、JConsoleは接続できません。図3-1の接続ダイアログ・ボックスの例では、Anagramsアプリケーションは、管理プロパティでJMXエージェントを有効にせずにJava SEプラットフォームVMで起動されたため、グレー表示され選択不可になっています。

図3-2 管理エージェントを有効にせずに試行するアプリケーションへの接続

図3-2の接続ダイアログ・ボックスの例では、Anagramsアプリケーションが選択されていますが、「接続」はグレー表示のままで、このプロセスでは管理エージェントが有効でないという通知が表示されています。JConsoleは、起動時に正しいJava VMまたは正しいオプションを使用しなかったため、Anagramsに接続できません。

接続ダイアログ・ボックスが開くと、リモート・プロセスへの接続オプションも表示されます。

図 3-3リモート・プロセスへの接続の作成

リモートJava VM上で実行中のプロセスをモニターするには、次の情報を入力する必要があります。

• ホスト名: Java VMが動作しているマシンの名前。

• ポート番号: Java VMの起動時に指定したJMXエージェントのポート番号。

• ユーザー名とパスワード: ユーザー名と使用するパスワード(パスワード認証の必要なJMXエージェントでJava VMをモニタリングする場合のみ必要)。

JMXエージェントのポート番号を設定するには、すぐに使用できる管理の有効化.を参照してください。

パスワードとアクセス・ファイルの使用を参照してください。

JConsoleを実行しているJava VMをモニターするには、「接続」をクリックし、ホストをlocalhost、ポートを0と指定します。

リモート・プロセス・オプションを使用してほかのJMXエージェントに接続するには、そのエージェントのJMXサービスURL、ユーザー名、およびパスワードを指定します。JMXサービスURLの構文には、接続に使用するトランスポート・プロトコルとサービス・アクセス・ポイントを指定する必要があります。JMXサービスURLの全構文は、javax.management.remote.JMXServiceURLのAPIドキュメントに記載されています。

図 3-4 JMXサービスURLによるJMXエージェントへの接続

JMXエージェントがJavaプラットフォームに含まれていないコネクタを使用する場合は、jconsoleコマンドを実行するときに、次のようにコネクタ・クラスをクラス・パスに追加する必要があります。

% jconsole -J-Djava.class.path=JAVA_HOME/lib/jconsole.jar:JAVA_HOME/lib/tools.jar:connector-path

connector-pathは、JDKには含まれていないがJConsoleで使用するコネクタ・クラスがあるディレクトリまたはJavaアーカイブ(JAR)ファイルです。

「概要」タブには、CPU使用状況、メモリー使用量、スレッド数、Java VMにロードされたクラスについての、グラフィカルなモニタリング情報がすべて1つの画面に表示されます。

図3-5 「概要」タブ

「概要」タブを使用すれば、以前は複数のタブを切り替えることでしか利用できなかった情報の関連付けが簡単にできます。

JConsoleでは、図表データをカンマ区切り値(CSV)ファイルに保存できます。図表のデータを保存するには、図表を右クリックして「別名で保存」を選択し、データの保存先のファイルを指定します。どの図表のデータでも、JConsoleのタブに表示されたものであれば、同様に保存できます。

CSV形式は、スプレッドシート・アプリケーションのデータ交換に一般的に使用されています。CSVファイルは、スプレッドシート・アプリケーションにインポートして、そのアプリケーションで図を作成する場合に使用できます。このデータは、2つ以上の名前付き列(カラム)として表示されます。最初の列はタイムスタンプを示します。ファイルをスプレッドシート・アプリケーションにインポートした後、通常は最初の列を選択し、その書式を必要に応じて「日付」または「日付/時間」に変更する必要があります。

「メモリー」タブには、メモリー消費とメモリー・プールに関する情報が表示されます。

図3-6 「メモリー」タブ

「メモリー」タブの「GCの実行」をクリックすると、いつでもガベージ・コレクションを実行できます。この図は、ヒープ・メモリーと非ヒープ・メモリー、および特定のメモリー・プールについて、Java VMのメモリー使用量の経時的推移を示しています。利用できるメモリー・プールは、使用しているJava VMのバージョンによって異なります。HotSpot Java VMの場合、シリアル・ガベージ・コレクションのメモリー・プールは次のとおりです。

• Eden領域(ヒープ): ほとんどのオブジェクトにメモリーが最初に割り当てられるプール。

• Survivor領域(ヒープ): Eden領域のガベージ・コレクションで残ったオブジェクトを含むプール。

• Tenured世代(ヒープ): Survivor領域である程度の期間存続したオブジェクトを含むプール。

• Permanent世代(非ヒープ): クラスやメソッド・オブジェクトなど、仮想マシン自体を反映したデータをすべて保持するプール。Java VMでクラス・データ共有を使用する場合、この世代は読取り専用領域と読取り/書込み領域に分割されています。

• コード・キャッシュ(非ヒープ): HotSpot Java VMには、ネイティブ・コードのコンパイルとストレージに使用するメモリーを含むコード・キャッシュも含まれます。

これらのメモリー・プールの消費を示す別の図表を表示させるには、「図」ドロップ・ダウン・メニューから必要なオプションを選択します。また、右下隅の「ヒープ」または「非ヒープ」の棒グラフをクリックすると、図表の表示が切り替わります。最後に、メモリー使用量を追跡する時間の範囲指定は、「時間範囲」ドロップ・ダウン・メニューから必要なオプションを選択します。

ガベージ・コレクションを参照してください。

「詳細」領域には、現在のメモリーに関するメトリックスがいくつか表示されます。

• 使用済: 現在使用中のメモリー容量。使用中のメモリーには、すべてのオブジェクト(アクセス可能なものも不能なものも含む)によって使用されているメモリーが含まれます。

• コミット済: Java VMで利用できることが保証されたメモリー容量。確定メモリーの容量は経時的に変わる可能性があります。Java仮想マシンがメモリーをシステムに解放した場合、確定メモリーの容量は、起動時に割り当てられた最初の容量よりも少なくなる可能性があります。確定メモリーの容量は必ず使用中のメモリー容量以上になります。

• 最大: メモリー管理に使用できる最大メモリー容量。この値は変化する場合や定義されていない場合があります。Java VMで使用メモリー容量を確定メモリー容量より大きくしようとすると、使用量が最大以下の場合(たとえば、システムの仮想メモリーが少ない場合)でも、メモリー割当てに失敗することがあります。

• GC時間: ガベージ・コレクションに要した累積時間とその呼出しの総数。複数行に及ぶ場合もあります。各行はJava VMで使用するガベージ・コレクタの1つのアルゴリズムを示します。

右下の棒グラフは、メモリー・プールによって、ヒープおよび非ヒープ・メモリーで使用されるメモリーを示しています。使用メモリーがメモリー使用量しきい値を超えると、棒の色が赤に変わります。メモリー使用量しきい値は、MemoryMXBeanの属性で設定できます。

「クラス」タブには、クラス・ローディングの情報が表示されます。

図3-10 「クラス」タブ

この図は、ロードされたクラス数の経時的推移を示しています。

• 赤いラインは、ロードされたクラスの総数(そのあとアンロードされたクラスを含む)を表します。

• 青いラインは、現在ロードされているクラスの数を表します。

タブの下の「詳細」セクションには、Java VMの起動後にロードされたクラスの総数、および現在ロードされている数とアンロードされた数が表示されます。クラス・ローディングのトレースを冗長出力に設定するには、右上隅のチェック・ボックスにチェック・マークを入れます。

「VMの概要」タブには、Java VMに関する情報が表示されます。

図 3-11「VMの概要」タブ

このタブには次のような情報が表示されます。

• 概要

  • アップタイム: Java VMの合計起動時間。

  • プロセスCPU時間: Java VMが起動してからCPUを使用した合計時間。

  • コンパイルの総時間: JITコンパイルに要した累積時間。Java VMの実装方法によって、JITコンパイルのタイミングが決まります。Hotspot VMは、適応型コンパイルを採用しています。適応型コンパイルでは、VMは標準のインタプリタを使用してアプリケーションを起動しますが、コードの実行中にコードを分析して、パフォーマンスのボトルネック、つまり「ホット・スポット」を検出します。

• スレッド

  • ライブ・スレッド: ライブ・デーモン・スレッドおよびデーモンでないライブ・スレッドの現在数。

  • ピーク: Java VM起動後のライブ・スレッドの最大数。

  • デーモン・スレッド: デーモンのライブ・スレッドの現在数。

  • 開始したスレッドの総数: Java VMの起動後に起動されたスレッドの合計数(デーモンおよびデーモン以外のスレッドと終了したスレッドを含む)。

• クラス

  • 現在ロードされているクラス: 現在メモリーにロードされているクラスの数。

  • ロードされたクラスの総数: Java VMの起動後にメモリーにロードされたクラスの合計数(そのあとアンロードされたものを含む)。

  • アンロードされたクラスの総数: Java VMの起動後にメモリーからアンロードされたクラスの数。

• メモリー

  • 現在のヒープ・サイズ: 現在、ヒープ単位で占めているKバイト数。

  • 確定メモリー: ヒープ用に割り当てられたメモリーの合計容量。

  • 最大ヒープ・サイズ: ヒープ単位で占めている最大Kバイト数。

  • ファイナライズを保留中のオブジェクト: ファイナライズを待機しているオブジェクト数。

  • ガベージ・コレクタ: GCに関する情報(ガベージ・コレクタ名、GCの実行回数、GCの実行に要した合計時間など)。

• オペレーティング・システム

  • 総物理メモリー: オペレーティング・システムが保持するランダム・アクセス・メモリー(RAM)の容量。

  • 空物理メモリー: オペレーティング・システムが使用可能なRAMの空き容量。

  • 確定仮想メモリー: 実行プロセスに使用できることが保証された仮想メモリーの量。

• その他の情報

  • VMの引数: アプリケーションがJava VMに渡した入力引数(mainメソッドの引数は含まない)。

  • クラス・パス: システム・クラス・ローダーがクラス・ファイルを検索するために使用するクラス・パス。

  • ライブラリ・パス: ライブラリをロードするときに検索するパスのリスト。

  • ブート・クラスパス: ブートストラップ・クラス・ローダーがクラス・ファイルを検索するために使用するパス。

「MBean」タブには、プラットフォームMBeanサーバーに通常の方法で登録されているすべてのMBeanに関する情報が表示されます。「MBean」タブから、フル・セットのプラットフォームMXBeanインストゥルメンテーション(他のタブには表示されないものも含む)にアクセスできます。そのほか、「MBean」タブを使用すれば、アプリケーションのMBeanのモニターと管理もできます。

図3-12 「MBean」タブ

左のツリーは、現在稼動中のすべてのMBeanを示しています。ツリーでMBeanを選択すると、そのMBeanInfoとMBean記述子の両方が右に表示され、その下のツリーには属性、操作、または通知が表示されます。

プラットフォームMXBeanとその各種操作および属性はすべて、JConsoleの「MBean」タブからアクセスできます。

既存の標準タブのほか、独自のカスタム・タブをJConsoleに追加して、独自のモニタリング・アクティビティを行うこともできます。JConsoleプラグインAPIには、たとえば、独自のアプリケーションのMBeanにアクセスするタブを追加するメカニズムがあります。JConsoleプラグインAPIは、独自のカスタム・プラグインを作成するために拡張可能なabstractクラスであるcom.sun.tools.jconsole.JConsolePluginを定義しています。

前述のように、独自のプラグインは、JConsolePluginを拡張し、JConsolePlugingetTabsおよびnewSwingWorkerメソッドを実装する必要があります。getTabsメソッドは、JConsoleに追加するタブのリストと空リストのどちらかを返します。newSwingWorkerメソッドは、そのプラグインのGUIを更新するSwingWorkerを返します。

独自のプラグインはJavaアーカイブ(JAR)ファイルで提供され、それにはMETA-INF/services/com.sun.tools.jconsole.JConsolePluginというファイルが入っている必要があります。このJConsolePluginファイル自体には、新しいJConsoleタブとして追加するプラグインの完全修飾クラス名のリストが含まれています。JConsoleは、サービス・プロバイダのロード機能を使用して、プラグインの検索とロードを実行します。JConsolePluginでは、プラグインごとのエントリを1つにして、複数のプラグインをもつこともできます。

新しいカスタム・プラグインをJConsoleにロードするには、JConsoleを次のコマンドで起動します。

%  jconsole -pluginpath plugin-path

前のコマンドで、plugin-pathは、検索するJConsoleプラグインへのパスを指定しています。これらのパスではディレクトリ名またはJARファイルを指定し、プラットフォームの標準区切り文字を使用して複数のパスを指定することもできます。

Java SE 13プラットフォームにはJConsoleプラグインのサンプルが付属します。JTopアプリケーションは、このアプリケーションで実行されるすべてのスレッドのCPU使用状況を示すJDKデモ・アプリケーションです。このデモはCPU消費が多いスレッドの識別に便利で、JConsoleプラグインやスタンドアロンのGUIとして使用できるように更新されています。JTopは、デモ・アプリケーションとしてJava SE 13プラットフォームにバンドルされています。JTopプラグインを使用してJConsoleを起動するには、次のコマンドを実行します。

% JDK_HOME/bin/jconsole -pluginpath JDK_HOME/demo/management/JTop/JTop.jar

このJConsoleのインスタンスに接続すると、「JTop」タブが追加され、実行中の各種スレッドのCPU使用状況が表示されます。

図 3-25カスタム・プラグイン・タブの表示