Класс EventSettings

java.lang.Object
- jdk.jfr.EventSettings

public abstract class EventSettings
extends Object

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

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

Следующий пример демонстрирует использование класса 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"));

Since:: 9

Методы

Модификатор и тип	Метод	Описание
`abstract EventSettings`	`with(String name, String value)`	Устанавливает значение настройки для события, связанного с этой настройкой события.
`EventSettings`	`withoutStackTrace()`	Отключает трассировку стека для события, связанного с этой настройкой события.
`EventSettings`	`withoutThreshold()`	Указывает, что порог не используется.
`EventSettings`	`withPeriod(Duration duration)`	Устанавливает интервал для события, связанного с этой настройкой события.
`EventSettings`	`withStackTrace()`	Включает трассировку стека для события, связанного с этой настройкой события.
`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