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

С момента:: 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, 2021, 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/17/docs/api/jdk.jfr/jdk/jfr/EventSettings.html