java.lang.Object
jdk.jfr.EventSettings
public abstract class EventSettings extends Object
レコーディングにイベント設定を適用するための簡易クラスです。
メソッド・チェーンを使用して構成されたRecording.enable(String)
メソッドを呼び出すと、レコーディングのEventSettings
オブジェクトを取得できます。
次の例は、EventSettings
クラスの使用方法を示しています。
Recording r = new Recording();
r.enable("jdk.CPULoad")
.withPeriod(Duration.ofSeconds(1));
r.enable("jdk.FileWrite")
.withoutStackTrace()
.withThreshold(Duration.ofNanos(10));
r.start();
Thread.sleep(10_000);
r.stop();
r.dump(Files.createTempFile("recording", ".jfr"));
- 導入されたバージョン:
- 9
-
メソッドのサマリー
修飾子と型メソッド説明abstract EventSettings
このイベント設定に関連付けられているイベントの設定値を設定します。final EventSettings
このイベント設定に関連付けられているイベントのスタック・トレースを無効にします。final EventSettings
しきい値が使用されないことを指定します。final EventSettings
withPeriod
(Duration duration) このイベント設定に関連付けられているイベントの間隔を設定します。final EventSettings
このイベント設定に関連付けられているイベントのスタック・トレースを有効にします。final EventSettings
withThreshold
(Duration duration) このイベント設定に関連付けられているイベントのしきい値を設定します。
-
メソッドの詳細
-
withStackTrace
public final EventSettings withStackTrace()このイベント設定に関連付けられているイベントのスタック・トレースを有効にします。with("stackTrace", "true")
メソッドの呼出しと同じです。- 戻り値:
null
ではなく、さらなる構成のためのイベント設定オブジェクト
-
withoutStackTrace
public final EventSettings withoutStackTrace()このイベント設定に関連付けられているイベントのスタック・トレースを無効にします。with("stackTrace", "false")
メソッドの呼出しと同じです。- 戻り値:
null
ではなく、さらなる構成のためのイベント設定オブジェクト
-
withoutThreshold
public final EventSettings withoutThreshold()しきい値が使用されないことを指定します。これは、
with("threshold", "0 s")
メソッドの呼出しに相当する便利な方法です。- 戻り値:
null
ではなく、さらなる構成のためのイベント設定オブジェクト
-
withPeriod
public final EventSettings withPeriod(Duration duration) このイベント設定に関連付けられているイベントの間隔を設定します。- パラメータ:
duration
-null
ではなく、期間- 戻り値:
null
ではなく、さらなる構成のためのイベント設定オブジェクト
-
withThreshold
public final EventSettings withThreshold(Duration duration) このイベント設定に関連付けられているイベントのしきい値を設定します。- パラメータ:
duration
- 継続時間が使用されない場合は、その時間(null
)- 戻り値:
null
ではなく、さらなる構成のためのイベント設定オブジェクト
-
with
public abstract EventSettings with(String name, String value) このイベント設定に関連付けられているイベントの設定値を設定します。- パラメータ:
name
- (たとえば、"threshold"
)設定の名前value
- (たとえば、"20 ms"
はnull
ではありません)を設定する値- 戻り値:
null
ではなく、さらなる構成のためのイベント設定オブジェクト
-