モジュール jdk.jfr
パッケージ 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

    • メソッドの詳細

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