モジュール jdk.jfr
パッケージ jdk.jfr

クラスEventSettings


  • public abstract class EventSettings
extends Object
    記録にイベント設定を適用するための簡易クラスです。

    メソッド連鎖を使用して構成できるRecording.enable(String)を呼び出すことによって、記録のイベント設定オブジェクトを取得できます。

    例, 

     
 Recording r = new Recording();
 r.enable("com.oracle.jdk.CPULoad")
    .withPeriod(Duration.ofSeconds(1));
 r.enable("com.oracle.jdk.FileWrite")
    .withoutStackTrace()
    .withThreshold(Duration.ofNanos(10));
 r.start();
 Thread.sleep(10_000);
 r.stop();
 r.dump(Files.createTempFile("recording", ".jfr"));
    導入されたバージョン:
    9

    • メソッドの詳細

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