Command-Line Options To Control Sampler

[jisedlac]

It would be handy to have a possibility to ask the running VisualVM instance to start sampling a Java process from terminal/external tool and immediately open it in the GUI.

[jisedlac]

Implemented in master.

[jisedlac]

Usage:

visualvm --start-cpu-sampler <pid> to start CPU sampling with the default settings or
visualvm --start-cpu-sampler <pid>@include-classes=<classes_to_include>,sampling-rate=<sampling_rate> or
visualvm --start-cpu-sampler <pid>@exclude-classes=<classes_to_exclude>,sampling-rate=<sampling_rate>
where the sampling_rate (in ms) can be one of these values: 20, 50, 100, 200, 500, 1000, 2000, 5000, 10000, or
visualvm --start-cpu-sampler <pid>@settings-file=<path_to_file>
where the path_to_file is path to a readable settings file created using the Properties.store(Writer, String) method, containing at least one of these properties: include-classes, exclude-classes, sampling-rate with the values described above.

visualvm --start-memory-sampler <pid> to start memory sampling with the default settings or
visualvm --start-memory-sampler <pid>@sampling-rate=<sampling_rate>
where the sampling_rate (in ms) can be one of these values: 100, 200, 500, 1000, 2000, 5000, 10000, or
visualvm --start-memory-sampler <pid>@settings-file=<path_to_file>
where the path_to_file is path to a readable settings file created using the Properties.store(Writer, String) method, containing property sampling-rate with a value described above.

visualvm --snapshot-sampler <pid> to take snapshot of the sampling data collected so far
visualvm --stop-sampler <pid> to stop the current sampler session

The values cannot contain space, quote, double quote, and comma. Use the following encoding for these characters:
space -> %20
quote -> %27
double quote -> %22
comma -> %2C