Класс FlightRecorder

public List<Recording> getRecordings()

Возвращает неизменяемый список доступных записей.

Запись становится доступной при ее создании. Она становится недоступной, когда находится в состоянии CLOSED, обычно после вызова Recording.close().

public Recording takeSnapshot()

Создаёт снимок всех доступных данных записи.

Снимок — это синтетическая запись в состоянии STOPPED. Если данные недоступны, возвращается запись с размером 0.

Снимок предоставляет стабильный доступ к данным для последующих операций (например, операций изменения интервала или уменьшения размера данных).

Пример ниже демонстрирует создание снимка и запись подмножества данных в файл.

 try (Recording snapshot = FlightRecorder.getFlightRecorder().takeSnapshot()) {
   if (snapshot.getSize() > 0) {
     snapshot.setMaxSize(100_000_000);
     snapshot.setMaxAge(Duration.ofMinutes(5));
     snapshot.dump(Paths.get("snapshot.jfr"));
   }
 }
 

Вызывающий метод должен закрыть запись, когда доступ к данным больше не нужен.

public static void register(Class<? extends Event> eventClass)

Регистрирует класс события.

Если класс события уже зарегистрирован, вызов этого метода игнорируется.

public static void unregister(Class<? extends Event> eventClass)

Отменяет регистрацию класса события.

Если класс события не зарегистрирован, вызов этого метода игнорируется.

public static FlightRecorder getFlightRecorder() throws IllegalStateException, SecurityException

Возвращает Flight Recorder для платформы.

public static void addPeriodicEvent(Class<? extends Event> eventClass, Runnable hook) throws SecurityException

Добавляет обработчик для периодического события.

Реализация обработчика должна возвращать результат как можно быстрее, чтобы избежать блокировки других операций Flight Recorder. Обработчик должен генерировать одно или несколько событий указанного типа. При добавлении обработчика интервал его вызова настраивается с помощью параметра "period".

public static boolean removePeriodicEvent(Runnable hook) throws SecurityException

Удаляет обработчик для периодического события.

public List<EventType> getEventTypes()

Возвращает неизменяемый список, содержащий все текущие зарегистрированные события.

По умолчанию события регистрируются при первом использовании, обычно при выделении объекта события. Чтобы убедиться, что событие становится видимым как можно раньше, регистрацию можно инициировать, вызвав метод register(Class).

public static void addListener(FlightRecorderListener changeListener)

Добавляет слушателя записи и получает AccessControlContext для вызова слушателя.

Если Flight Recorder уже инициализирован при добавлении слушателя, то метод FlightRecorderListener.recorderInitialized(FlightRecorder) вызывается перед возвратом из этого метода.

public static boolean removeListener(FlightRecorderListener changeListener)

Удаляет слушателя записи.

Если тот же слушатель добавляется несколько раз, удаляется только один экземпляр.

public static boolean isAvailable()

Возвращает true если у виртуальной машины Java (JVM) есть возможности Flight Recorder.

Этот метод может быстро проверить, может ли Flight Recorder быть инициализирован, не выполняя фактической работы по инициализации. Значение может меняться во время выполнения, и кэшировать его небезопасно.

public static boolean isInitialized()

Возвращает true если Flight Recorder инициализирован.