モジュール jdk.jfr

パッケージ jdk.jfr

クラスEventSettings

java.lang.Object

jdk.jfr.EventSettings

public abstract class EventSettings extends Object

レコーディングにイベント設定を適用するための簡易クラスです。

メソッド・チェーンを使用して構成されたRecording.enable(String)メソッドを呼び出すと、レコーディングのEventSettingsオブジェクトを取得できます。

次の例は、EventSettingsクラスの使用方法を示しています。

try (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	with(String name, String value)	このイベント設定に関連付けられているイベントの設定値を設定します。
final EventSettings	withoutStackTrace()	このイベント設定に関連付けられているイベントのスタック・トレースを無効にします。
final EventSettings	withoutThreshold()	しきい値が使用されないことを指定します。
final EventSettings	withPeriod(Duration duration)	このイベント設定に関連付けられているイベントの間隔を設定します。
final EventSettings	withStackTrace()	このイベント設定に関連付けられているイベントのスタック・トレースを有効にします。
final EventSettings	withThreshold(Duration duration)	このイベント設定に関連付けられているイベントのしきい値を設定します。

クラスjava.lang.Objectで宣言されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

メソッドの詳細

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ではなく、さらなる構成のためのイベント構成オブジェクト