Класс Recording

Новая запись находится в состоянии RecordingState.NEW. Чтобы начать запись, вызовите метод start().

Новая запись находится в состоянии RecordingState.NEW. Чтобы начать запись, вызовите метод start().

Следующий пример демонстрирует создание записи, использующей предопределённую конфигурацию.

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

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

После успешного вызова этого метода, эта запись находится в состоянии RUNNING.

После успешного вызова этого метода, эта запись находится в состоянии DELAYED.

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

После успешного вызова этого метода, эта запись будет в состоянии STOPPED.

Изменение возвращённых Map не изменит настройки этой записи.

Если для этой записи настройки не установлены, возвращается пустая Map.

Размер обновляется при сбросе буферов записи. Если запись не записывается в репозиторий диска, возвращаемый размер всегда 0.

По умолчанию имя совпадает с идентификатором записи.

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

    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);

После успешного вызова этого метода, эта запись находится в состоянии CLOSED.

Копии полезны для выгрузки данных без остановки записи. После создания копии объём копируемых данных ограничивается методами setMaxAge(Duration) и setMaxSize(long).

Для успешной выгрузки запись должна быть либо 1) запущенной, либо 2) остановленной и записанной на диск. Если запись находится в любом другом состоянии, выбрасывается IOException.

Если значение не задано, true возвращается.

Чтобы контролировать количество записываемых данных, хранящихся на диске, можно указать максимальный объём сохраняемых данных. При превышении максимального лимита виртуальная машина Java (JVM) удаляет старейший фрагмент, чтобы освободить место для более нового.

Если ни максимальный лимит, ни максимальный срок хранения не заданы, размер записи может неограниченно расти.

Чтобы контролировать объём данных, хранящихся на диске, можно указать максимальный срок хранения. Данные, хранящиеся на диске, которые старше указанного срока, удаляются виртуальной машиной Java (JVM).

Если ни максимальный лимит, ни максимальный срок хранения не заданы, размер записи может неограниченно расти.

Если место назначения установлено, данная запись автоматически закрывается после успешной копии данных в заданный путь назначения.

Если место назначения не установлено, Flight Recorder сохраняет данные записи до тех пор, пока эта запись не будет закрыта. Используйте метод dump(Path) для ручного записи данных в файл.

Если выгрузка при выходе не установлена, false возвращается.

Поток может содержать некоторые данные за пределами заданного диапазона.

Если запись не на диске, поток создать нельзя и null возвращается.

Продолжительность можно установить только когда запись находится в состоянии RecordingState.NEW.

По умолчанию у записи нет продолжительности (null).

Если несколько событий имеют одинаковое имя (например, один и тот же класс загружен в разных загрузчиках классов), то все события, соответствующие имени, включены. Чтобы включить определённый класс, используйте метод enable(Class) или String представление идентификатора типа события.

Если несколько событий с одинаковым именем (например, один и тот же класс загружен в разных загрузчиках классов), то все события, соответствующие имени, отключены. Чтобы отключить определённый класс, используйте метод disable(Class) или String представление идентификатора типа события.