JFR Command Line Options

Specifies the settings file to be used. In case of a custom configuration file, use the full path to the .jfc file. Otherwise, use one of the following presets:

Controls whether to create a temporary recording file under the path set in the repository option. Temporary recording means that a file is written to the system temporary directory during the time of the recording and is deleted afterwards. This recording file is populated gradually, unlike the file generated using the filename option, which is only populated once the recording finishes.

Specifies the path for a temporary recording if the disk option is enabled.

Specifies the file name of the generated recording. You can add a path to the recording filename to change the file location. The recording file stays empty and only gets populated once the recording finishes.

Specifies the recording length. Used time units: ns/ms/s/m/h/d. For example, 1800s or 30m.

Specifies the amount of time that the recorder must wait before starting to record. Used time units: ns/ms/s/m/h/d. For example, 1800s or 30m.

Controls whether to generate a recording file (dump a recording) if the JVM shuts down and the filename option has not been specified. The dumped recording filename is hotspot-pid-%p-%t.jfr

Specifies a name identifier for the recording. This is useful when working from jcmd and operating multiple recordings running at the same time.

Controls the maximum number of days the recording should be available on the disk, only when the disk parameter is set to true. Used time units: s/m/h/d.

Controls the maximum size of disk data to keep for the recording, only when the disk parameter is set to true. Used size units: m or M (megabytes) / g or G (gigabytes).

Controls whether to collect the path to the Garbage Collection (GC) roots at the end of a recording.

The path to the GC roots are useful when you want to debug memory leaks, but should only be enabled when you suspect there is such a memory leak in your application.