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

クラスEventSettings

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

  • メソッドの詳細

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