Класс Recording

public Recording(Map<String,String> settings)

Параметры:

settings — настройки в виде карты пар «имя — значение», не null

Исключения:

IllegalStateException — если не удается создать Flight Recorder (например, если в виртуальной машине Java (JVM) отсутствует поддержка Flight Recorder или невозможно создать либо получить доступ к файловому хранилищу)

Начиная с:

11

См. также:

• jdk.jfr

public Recording()

Исключения:

IllegalStateException — если не удается создать Flight Recorder (например, если в виртуальной машине Java (JVM) отсутствует поддержка Flight Recorder или невозможно создать либо получить доступ к файловому хранилищу)

public Recording(Configuration configuration)

Recording r = new Recording(Configuration.getConfiguration("default"));

Параметры:

configuration — конфигурация, содержащая настройки для использования, не null

Исключения:

IllegalStateException — если не удается создать Flight Recorder (например, если в виртуальной машине Java (JVM) отсутствует поддержка Flight Recorder или невозможно создать либо получить доступ к файловому хранилищу)

См. также:

• Configuration

public void start()

Исключения:

IllegalStateException — если запись уже запущена или находится в состоянии CLOSED

public void scheduleStart(Duration delay)

Параметры:

delay — время ожидания перед запуском этой записи, не null

Исключения:

IllegalStateException — если запись находится не в состоянии NEW

public boolean stop()

Возвращает:

true, если запись остановлена, иначе false

Исключения:

IllegalStateException — если запись не запущена или уже остановлена

См. также:

• setDestination(Path)

public Map<String,String> getSettings()

Возвращает:

настройки записи, не null

public long getSize()

Возвращает:

объем записанных данных в байтах или 0, если запись не сохраняется в дисковом хранилище

public Instant getStopTime()

Возвращает:

время или null, если эта запись не остановлена

public Instant getStartTime()

Возвращает:

время или null, если эта запись не запущена

public long getMaxSize()

Возвращает:

максимальный размер в байтах или 0, если максимальный размер не задан

public Duration getMaxAge()

Возвращает:

максимальное время хранения или null, если максимальное время хранения не задано

public String getName()

Возвращает:

имя записи, не null

public void setSettings(Map<String,String> settings)

    Map<String, String> settings = new HashMap<>();
    settings.putAll(EventSettings.enabled("jdk.CPUSample").withPeriod(Duration.ofSeconds(2)).toMap());
    settings.putAll(EventSettings.enabled(MyEvent.class).withThreshold(Duration.ofSeconds(2)).withoutStackTrace().toMap());
    settings.put("jdk.ExecutionSample#period", "10 ms");
    recording.setSettings(settings);

    Map<String, String> settings = recording.getSettings();
    settings.putAll(additionalSettings);
    recording.setSettings(settings);

Параметры:

settings — задаваемые настройки, не null

public RecordingState getState()

Возвращает:

состояние записи, не null

См. также:

• RecordingState

public void close()

Определено в:

close в интерфейсе AutoCloseable

Определено в:

close в интерфейсе Closeable

public Recording copy(boolean stop)

Параметры:

stop — true, если созданную копию следует немедленно остановить, иначе false

Возвращает:

копию записи, не null

public void dump(Path destination) throws IOException

Параметры:

destination — расположение для записи данных, не null

Исключения:

IOException — если не удается скопировать данные записи в указанное расположение, например, если запись закрыта или путь назначения недоступен для записи

См. также:

• getState()
• isToDisk()

public boolean isToDisk()

Возвращает:

true, если запись использует дисковое хранилище, и false в противном случае

public void setMaxSize(long maxSize)

Параметры:

maxSize — объем сохраняемых данных, 0 для неограниченного объема

Исключения:

IllegalArgumentException — если maxSize отрицательно

IllegalStateException — если запись находится в состоянии CLOSED

public void setMaxAge(Duration maxAge)

Параметры:

maxAge — время хранения данных или null для неограниченного времени

Исключения:

IllegalArgumentException — если maxAge отрицательно

IllegalStateException — если запись находится в состоянии CLOSED

public void setDestination(Path destination) throws IOException

Параметры:

destination — путь назначения или null, если запись не следует сохранять при остановке

Исключения:

IllegalStateException — если запись находится в состоянии STOPPED или CLOSED.

IOException — если путь недоступен для записи

public Path getDestination()

Возвращает:

файл назначения или null, если он не задан.

public long getId()

Возвращает:

идентификатор записи

public void setName(String name)

Параметры:

name — имя записи, не null

Исключения:

IllegalStateException — если запись находится в состоянии CLOSED

public void setDumpOnExit(boolean dumpOnExit)

Параметры:

dumpOnExit — следует ли сохранять эту запись при завершении работы JVM

public boolean getDumpOnExit()

Возвращает:

true, если запись сохраняется при завершении работы, иначе false.

public void setToDisk(boolean disk)

Параметры:

disk — true, если эта запись сохраняется на диск, false, если она хранится в памяти

public InputStream getStream(Instant start, Instant end) throws IOException

Параметры:

start — время начала потока или null, чтобы получить данные с момента начала записи

end — время окончания потока или null, чтобы получить данные до текущего момента.

Возвращает:

входной поток или null, если в этом интервале нет данных либо запись не сохранялась на диск

Исключения:

IllegalArgumentException — если end происходит раньше start

IOException — если не удается открыть поток

См. также:

• setToDisk(boolean)

public Duration getDuration()

Возвращает:

заданную продолжительность записи или null, если продолжительность не задана.

public void setDuration(Duration duration)

Параметры:

duration — продолжительность или null, если продолжительность не задана

Исключения:

IllegalStateException — если запись находится в состоянии STOPPED или CLOSED

public EventSettings enable(String name)

Параметры:

name — настройки события, не null

Возвращает:

параметр настройки события для дальнейшей конфигурации, не null

См. также:

• EventType

public EventSettings disable(String name)

Параметры:

name — настройки события, не null

Возвращает:

параметр настройки события для дальнейшей конфигурации, не null

public EventSettings enable(Class<? extends Event> eventClass)

Параметры:

eventClass — включаемое событие, не null

Возвращает:

параметр настройки события для дальнейшей конфигурации, не null

Исключения:

IllegalArgumentException — если eventClass является абстрактным классом или не является подклассом Event

public EventSettings disable(Class<? extends Event> eventClass)

Параметры:

eventClass — отключаемое событие, не null

Возвращает:

параметр настройки события для дальнейшей конфигурации, не null

Исключения:

IllegalArgumentException — если eventClass является абстрактным классом или не является подклассом Event