Интерфейс FlightRecorderMXBean

static final String MXBEAN_NAME

См. также:

• Значения константных полей

long newRecording() throws IllegalStateException

Возвращает:

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

Вызывает исключение:

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

См. также:

• Recording

long takeSnapshot()

Возвращает:

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

См. также:

• Recording

long cloneRecording(long recordingId, boolean stop) throws IllegalArgumentException

Параметры:

recordingId — идентификатор записи, на основе которой создается клон

stop — следует ли остановить только что созданный клон перед возвратом.

Возвращает:

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

Вызывает исключение:

IllegalArgumentException — если запись с указанным идентификатором не существует

См. также:

• Recording

void startRecording(long recordingId) throws IllegalStateException

Параметры:

recordingId — идентификатор записи, которую нужно запустить

Вызывает исключение:

IllegalArgumentException — если запись с указанным идентификатором не существует

IllegalStateException

См. также:

• Recording

boolean stopRecording(long recordingId) throws IllegalArgumentException, IllegalStateException

Параметры:

recordingId — идентификатор записи, которую нужно остановить

Возвращает:

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

Вызывает исключение:

IllegalArgumentException — если запись с указанным идентификатором не существует

IllegalStateException — если запись не выполняется

См. также:

• newRecording()

void closeRecording(long recordingId) throws IOException

Параметры:

recordingId — идентификатор записи, которую нужно закрыть

Вызывает исключение:

IllegalArgumentException — если запись с указанным идентификатором не существует

IOException — если возникает ошибка ввода-вывода

См. также:

• newRecording()

long openStream(long recordingId, Map<String,String> streamOptions) throws IOException

Параметры:

recordingId — идентификатор записи, для которой нужно открыть поток

streamOptions — карта, содержащая параметры, управляющие объемом данных и способом их чтения, или null, чтобы получить все данные записи с размером блока по умолчанию

Возвращает:

уникальный идентификатор потока.

Вызывает исключение:

IllegalArgumentException — если запись с указанным идентификатором не существует или options содержит недопустимые значения

IOException — если запись закрыта, возникает ошибка ввода-вывода или для указанной записи либо интервала нет данных

void closeStream(long streamId) throws IOException

Параметры:

streamId — идентификатор потока

Вызывает исключение:

IllegalArgumentException — если поток с указанным идентификатором не существует

IOException — если при попытке закрыть поток возникает ошибка ввода-вывода

См. также:

• openStream(long, Map)

byte[] readStream(long streamId) throws IOException

Параметры:

streamId — идентификатор потока

Возвращает:

массив байтов, содержащий данные записи, или null, если данные закончились

Вызывает исключение:

IOException — если поток закрыт или при попытке чтения потока произошла ошибка ввода-вывода

IllegalArgumentException — если записи с таким идентификатором потока не существует

Map<String,String> getRecordingOptions(long recordingId) throws IllegalArgumentException

Параметры:

recordingId — идентификатор записи, параметры которой нужно получить

Возвращает:

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

Вызывает исключение:

IllegalArgumentException — если запись с указанным идентификатором не существует

Map<String,String> getRecordingSettings(long recordingId) throws IllegalArgumentException

Параметры:

recordingId — идентификатор записи, настройки которой нужно получить

Возвращает:

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

Вызывает исключение:

IllegalArgumentException — если запись с указанным идентификатором не существует

void setConfiguration(long recordingId, String contents) throws IllegalArgumentException

Параметры:

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

contents — строковое представление используемого файла конфигурации, не null

Вызывает исключение:

IllegalArgumentException — если запись с указанным идентификатором не существует или конфигурацию не удалось разобрать.

См. также:

• Configuration.getContents()

void setPredefinedConfiguration(long recordingId, String configurationName) throws IllegalArgumentException

Параметры:

recordingId — идентификатор записи, для которой нужно задать конфигурацию

configurationName — имя конфигурации (например, "profile" или "default"), не null

Вызывает исключение:

IllegalArgumentException — если запись с указанным идентификатором не существует

См. также:

• getConfigurations()

void setRecordingSettings(long recordingId, Map<String,String> settings) throws IllegalArgumentException

Параметры:

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

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

Вызывает исключение:

IllegalArgumentException — если запись с указанным идентификатором не существует

См. также:

• Recording.getId()

void setRecordingOptions(long recordingId, Map<String,String> options) throws IllegalArgumentException

Параметры:

recordingId — идентификатор записи, параметры которой нужно задать

options — карта имен и значений задаваемых параметров, не null

Вызывает исключение:

IllegalArgumentException — если запись с указанным идентификатором не существует

См. также:

• Recording.getId()

List<RecordingInfo> getRecordings()

Возвращает:

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

См. также:

• RecordingInfo
• Recording

List<ConfigurationInfo> getConfigurations()

Возвращает:

список предварительно определенных конфигураций, не null

См. также:

• ConfigurationInfo
• Configuration

List<EventTypeInfo> getEventTypes()

Возвращает:

список зарегистрированных типов событий, не null

См. также:

• EventTypeInfo
• EventType

void copyTo(long recordingId, String outputFile) throws IOException

Параметры:

recordingId — идентификатор записи, данные которой нужно выгрузить

outputFile — зависящее от системы имя файла, в который записываются данные, не null

Вызывает исключение:

IOException — если запись не удается выгрузить из-за ошибки ввода-вывода (например, из-за недопустимого пути)

IllegalArgumentException — если запись с указанным идентификатором не существует

IllegalStateException — если запись еще не запущена или уже закрыта

См. также:

• Path.toString()
• Recording.dump(java.nio.file.Path)