Класс 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"));
}

Since:: 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)`	Устанавливает порог для события, связанного с этой настройкой события.

Методы, унаследованные от класса java.lang.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://download.java.net/java/early_access/jdk24/docs/api/jdk.jfr/jdk/jfr/EventSettings.html