Класс FlightRecorder

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

Снимок — это синтезированная запись в состоянии 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"));
    }
}

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

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

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

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

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

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

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