Класс EventSettings

java.lang.Object

jdk.jfr.EventSettings

public abstract class EventSettings extends Object

Вспомогательный класс для применения настроек событий к записи.

Объект EventSettings для записи можно получить, вызвав метод Recording.enable(String), настройка которого выполняется с помощью цепочки вызовов методов.

В следующем примере показано, как использовать класс 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)`	Задает пороговое значение для события, связанного с этой настройкой события.

Методы, объявленные в классе 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

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/25/docs/api/jdk.jfr/jdk/jfr/EventSettings.html