手順

1. オペレーティングシステムに応じて、以下のいずれかの方法を選択して JMC コンソールを起動します。

   1. Red Hat Enterprise Linux で、実行可能ファイルが含まれるディレクトリーに移動し、./jmc コマンドを実行します。

   2. Microsoft Windows で、jmc.exe ファイルが含まれるディレクトリーに移動し、jmc コマンドを実行します。

      注記

      システムのファイルエクスプローラーアプリケーションを使用して、いずれかのオペレーティングシステムで JMC アプリケーションを起動し、JDK Mission Control ディレクトリーに移動してから JMC 実行可能ファイルをダブルクリックします。

2. JVM Browser ナビゲーションパネルに移動します。このパネルで、利用可能な JVM 接続を表示できます。
3. JVM Browser パネルで、[11.0.13] The JVM Running Mission Control などのターゲット JVM インスタンスをデプロイメントします。対象の JVM インスタンスの下にアイテムリストが表示されます。

4. ナビゲーションパネルで JMC Agent アイテムをダブルクリックします。JMC コンソールで、Start JMC Agent ウィンドウが開きます。

   図2.1 JMC Agent ウィンドウの起動

   

5. Browse ボタンを使用して、JMC Agent の JAR ファイルを Agent JAR フィールドに追加します。Agent XML フィールドはオプションです。

   注記

   JMC は選択したターゲット JVM インスタンスに基づいて値を自動的に追加するため、Target JVM フィールドに値を入力する必要はありません。

6. Start ボタンをクリックします。

   JMC は、JVM Browser navigation パネルで、ターゲット JVM インスタンスの下に Agent Plugin アイテムを追加します。JMC コンソールが自動的に Agent Live Config ペインを開きます。

   図2.2 Agent Live Config ペイン

   

   JMC Agent の設定や、JMC Agent と JFR データ間の対話の管理が可能になりました。XML 設定を生成して JMC コンソールにアップロードすると、Agent Live Config ペインにその XML ファイルに関連付けられたメタデータが表示されます。

   図2.3 JMC コンソールに追加された XML 設定ファイルの例

   

手順

1. メニューバーから Window をクリックし、JMC Agent Preset Manager メニュー項目をクリックすると、新しい事前設定を作成できます。JMC コンソールで JMC Agent Configuration Preset Manager ウィザードが開きます。

2. Add ボタンをクリックして、Edit Preset Global Configurations ウィンドウにアクセスします。

   図2.4 Edit Preset Global Configurations ウィンドウ

   

   このウィンドウで、事前に設定した名前を入力できます。オプションで、ターゲット JVM に挿入するイベントのクラス接頭辞を入力できます。AllowtoString チェックボックスと Allow Converter チェックボックスも選択できます。

3. Next ボタンをクリックします。Add or Remove Preset Events ウィンドウが開きます。このウィンドウから、事前設定した新規イベントの追加、編集、削除を行うことができます。

   図2.5 事前設定イベントの追加または削除

   

4. ウィザードの手順に従い、以下を実行できます。

   1. イベント設定の編集
   2. パラメーターまたは戻り値手順の編集

   3. パラメーターまたは戻り値取得の編集

      ヒント

      各ウィザード手順で利用可能なボタンのいずれかを選択し、Add、Remove など、希望の設定を完了できます。任意の段階で Back ボタンをクリックして、直前のウィザードステップを編集できます。

5. Finish ボタンをクリックして Add または Remove Preset Events ウィンドウに戻ります。
6. Next をクリックします。Preview Preset Output ウィンドウが開きます。

7. 生成された XML データを確認してから Finish ボタンをクリックします。

   図2.6 事前設定出力のプレビュー

   
8. JMC コンソールウィンドウの右上にある Load Preset ボタンをクリックし、事前設定を JMC アプリケーションにアップロードします。

9. JMC Agent Configuration Preset Manager ウィンドウで、OK ボタンをクリックしてターゲット JVM に事前設定を読み込みます。JMC コンソールの Agent Live Present パネルには、アクティブなエージェント設定と、挿入されたイベントが表示されます。以下に例を示します。

   図2.7 Agent Live Present ペインの出力例

   

手順

1. JVM ブラウザーを開きます。

   $ JAVA_HOME/bin/jmc

2. JVM ブラウザービューで JVM を右クリックし、Start Flight Recording を選択します。

   フライトレコーウィザードが開きます。

   図3.1 JMC JFR ウィザード

   

   JDK Flight Recording Wizard には 3 つのページがあります。

   • ウィザードの最初のページには、以下を含む移動記録の一般的な設定が含まれています。

     • 記録の名前
     • 記録の保存先のパスおよびファイル名
     • 録画が固定された時間または継続的な録画であるか。イベントテンプレートが使用されます。
     • 録画の説明
   • 2 番目のページには、フライトレコーのイベントオプションが含まれます。Garbage Collections、Memory Profiling、および Method Sampling およびその他のイベントレコードの詳細レベルを設定できます。
   • 3 番目のページには、イベントの詳細の設定が含まれます。イベントをオンにまたはオフにし、スタックトレースの記録を有効にし、イベントの記録に必要な時間しきい値を変更できます。
3. 記録の設定を編集します。

4. Finish をクリックします。

   ウィザードは終了し、移動の記録が開始されます。

手順

1. カスタムイベントタイプの Event クラスで、@name アノテーションを使用してカスタムイベントに名前を付けます。この名前は、JMC グラフィカルユーザーインターフェイス (GUI) に表示されます。

   Event クラスでカスタムイベントタイプ名を定義する例

   @Name(“SampleCustomEvent”)
   public class SampleCustomEvent extends Event {...}

2. Event クラスのメタデータと、名前、カテゴリー、ラベルなどの属性を定義します。ラベルには、JMC などのクライアントのイベントタイプが表示されます。

   注記

   大きな記録ファイルはパフォーマンスの問題を引き起こす可能性があり、これはファイルの操作方法に影響を与える可能性があります。必要なイベント記録アノテーションの数を正しく定義していることを確認してください。不要なアノテーションを定義すると、記録ファイルのサイズが大きくなる可能性があります。

   サンプルの Event クラスのアノテーションを定義する例

   @Name(“SampleCustomEvent”)  1
   @Label("Sample Custom Event")
   @Category("Sample events")
   @Description("Custom Event to demonstrate the Custom Events API")
   @StackTrace(false) 2
   public class SampleCustomEvent extends Event {
   
   
       @Label("Method") 3
       public String method;
   
   
       @Label("Generated Number")
       public int number;
   
   
       @Label("Size")
       @DataAmount 4
       public int size;
   }

   1

   JMC GUI でのカスタムイベントの表示方法のメタデータを定義する @Name などのアノテーションを記述します。

   2

   @StackTrace アノテーションは、フライト記録のサイズを増やします。デフォルトでは、JFR にはイベントが作成された場所の stackTrace は含まれていません。

   3

   @Label アノテーションは、HTTP リクエストのリソースメソッドなど、各メソッドのパラメーターを定義します。

   4

   @DataAmount アノテーションには、データ量をバイト単位で定義する属性が含まれています。JMC は、データ量をメガバイト (MB) などの他の単位で自動的にレンダリングします。

3. Event クラスでコンテキスト情報を定義します。この情報は、カスタムイベントタイプの要求処理動作を設定するため、特定の JFR データを収集するようにイベントタイプを指定します。

   単純な main クラスとイベントループの定義例

   public class Main {
   
   	private static int requestsSent;
   
   	public static void main(String[] args) {
       	// Register the custom event
       	FlightRecorder.register(SampleCustomEvent.class);
       	// Do some work to generate the events
       	while (requestsSent <= 1000) {
           	try {
               	eventLoopBody();
               	Thread.sleep(100);
           	} catch (Exception e) {
               	e.printStackTrace();
           	}
       	}
       }
   
   	private static void eventLoopBody() {
       	// Create and begin the event
       	SampleCustomEvent event = new SampleCustomEvent();
       	event.begin();
       	// Generate some data for the event
       	Random r = new Random();
       	int someData = r.nextInt(1000000);
       	// Set the event fields
       	event.method = "eventLoopBody";
       	event.number = someData;
       	event.size = 4;
       	// End the event
       	event.end();
       	event.commit();
       	requestsSent++;
       }

   前の例では、単純な main クラスがイベントを登録し、イベントループがイベントフィールドにデータを入力してから、カスタムイベントを発生させます。

4. JMC や JFR ツールなど、選択したアプリケーションのイベントタイプを調べます。

   図3.2 JMC でイベントタイプを調べる例

   

   JFR 記録には、さまざまなイベントタイプを含めることができます。アプリケーションで各イベントタイプを調べることができます。