public abstract class EventSettings
extends java.lang.Object
An EventSettings object for a recording can be obtained by invoking
the Recording.enable(String) method which is configured using method
chaining.
The following example shows how to use the EventSettings class.
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"));
| Modifier and Type | Method and Description |
|---|---|
abstract EventSettings |
with(java.lang.String name,
java.lang.String value)
Sets a setting value for the event that is associated with this event setting.
|
EventSettings |
withoutStackTrace()
Disables stack traces for the event that is associated with this event setting.
|
EventSettings |
withoutThreshold()
Specifies that a threshold is not used.
|
EventSettings |
withPeriod(java.time.Duration duration)
Sets the interval for the event that is associated with this event setting.
|
EventSettings |
withStackTrace()
Enables stack traces for the event that is associated with this event setting.
|
EventSettings |
withThreshold(java.time.Duration duration)
Sets the threshold for the event that is associated with this event setting.
|
public final EventSettings withStackTrace()
Equivalent to invoking the with("stackTrace", "true") method.
nullpublic final EventSettings withoutStackTrace()
Equivalent to invoking the with("stackTrace", "false") method.
nullpublic final EventSettings withoutThreshold()
This is a convenience method, equivalent to invoking the
with("threshold", "0 s") method.
nullpublic final EventSettings withPeriod(java.time.Duration duration)
duration - the duration, not nullnullpublic final EventSettings withThreshold(java.time.Duration duration)
duration - the duration, or null if no duration is usednullpublic abstract EventSettings with(java.lang.String name, java.lang.String value)
name - the name of the setting (for example, "threshold")value - the value to set (for example "20 ms" not
null)null