2.5. JMC Agent プラグイン属性

JMC コンソールは、ボタン、ドロップダウンリスト、テキストフィールドなどの形式で多くの属性をサポートします。特定の JMC Agent 属性を使用してエージェントを設定できます。

以下の表は、JMC Agent の設定に使用できる属性のカテゴリーの概要を示しており、Agent を使用してニーズに合わせて JFR データを監視できます。

表2.1 JMC Agent で使用する設定属性の一覧。

属性説明

<allowconverter>

JMC Agent がコンバーターを使用できるかどうかを決定します。コンバーターを有効にすると、カスタムデータタイプまたはオブジェクトを JFR コンテンツタイプに変換できます。JFR は、これらのタイプをカスタムイベントと共に記録できます。

<allowtostring>

JMC Agent が配列とオブジェクトパラメーターを文字列として記録できるかどうかを決定します。

注記: toString メソッドが JMC Agent 配列要素およびオブジェクトをサポートしていることを確認します。それ以外の場合は、toString メソッドの動作により、JMC Agent で問題が発生する可能性があります。

<classPrefix>

挿入されたイベントの接頭辞接頭辞を決定します。例: __JFR_EVENT

<config>

JMC Agent の設定オプションが含まれます。

<jfragent>

イベント定義を開始します。<jfragent> 属性は、その他すべての設定属性の親属性です。

表2.2 JMC Agent で使用するイベントタイプ属性のリスト。

属性説明

<class>

メソッドからイベントタイプを受け取るクラスを定義します。

<description>

イベントタイプを記述します。

<events>

エージェントが定義済みメソッドに挿入するイベントセットを一覧表示します。イベントタグには ID が必要です。JFR は、カスタムイベントのイベントタグを使用します。

<label>

イベントタイプの名前を定義します。

<location>

挿入されたイベントを受信するメソッドの場所を決定します。たとえば、ENTRYEXITWRAP などです。

<path>

カスタムイベントを保存する場所を指すパス。このパスは、JMC コンソールのJVM Browser ナビゲーションパネルに一覧表示されているイベントに関連します。

<method>

挿入されたイベントを受信するメソッドを定義します。method 属性では、以下の 2 つの値を定義する必要があります。

  • name: メソッドの名前
  • descriptor: 正式なメソッド記述子。(ParameterDescriptors)ReturnDescriptor の形式を取ります。

<stacktrace>

イベントタイプがスタックトレースを記録するかどうかを決定します。

表2.3 JMC Agent で使用するカスタムキャプション属性の一覧。

属性説明

<converter>

属性を JFR データタイプに変換するコンバータークラスの修飾名。

<contenttype>

コンバーター属性が受信する JFR コンテンツタイプを定義します。

<description>

カスタムキャプション属性の記述。

<parameters>

任意の属性です。パラメータータグに割り当てられたインデックス値に基づくメソッドパラメーターを一覧表示します。

<name>

カスタムキャプション属性の名前。

表2.4 JMC Agent で使用するフィールドキャプチャー属性の一覧。

属性説明

<description>

取得するフィールドの記述。

<expression>

エージェントが分析して定義済みフィールドを見つける式を定義します。

<fields>

JMC Agent が定義済みイベントタイプでキャプチャーおよび出力するクラスフィールド値を決定します。

<name>

クラスフィールドキャプチャー属性の名前。