模块  jdk.jfr
软件包  jdk.jfr

Class 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" not null ）
        结果
        事件设置对象用于进一步配置，而不是 null