Go to main content
Oracle® Developer Studio 12.6: Performance Analyzer

Exit Print View

Updated: June 2017

Starting Performance Analyzer

To start Performance Analyzer , type the following command in a terminal window:

% analyzer [control-options] [experiment | experiment-list]

You can specify an experiment name or a list. The experiment-list command argument is a space-separated list of experiment names, experiment group names, or both. If you do not provide an experiment list, Performance Analyzer starts and opens the Welcome page.

You can specify multiple experiments or experiment groups on the command line. If you specify an experiment that has descendant experiments inside it, all descendant experiments are automatically loaded and the data is aggregated. To load individual descendant experiments, you must specify each experiment explicitly or create an experiment group.

In reading experiments with descendants, any sub-experiments that contain little or no performance data are ignored by Performance Analyzer and er_print.

To create an experiment group, you can use the –g argument to the collect utility. To manually create an experiment group, create a plain text file whose first line is as follows:

#analyzer experiment group

Then add the names of the experiments on subsequent lines. The file extension must be erg.

When Performance Analyzer displays multiple experiments, data from all the experiments is aggregated by default. The data is combined and viewed as if the data is from one experiment. However, you can also choose to compare the experiments instead of aggregating the data if you specify the –c option. See Comparing Experiments.

You can preview an experiment or experiment group by clicking its name in the Open Experiment dialog box.

You can also start Performance Analyzer from the command line to record an experiment as follows:

% analyzer [Java-options] [control-options] target [target-arguments]

Performance Analyzer starts up with the Profile Application window showing the named target and its arguments and settings for profiling an application and collecting an experiment. See Profiling Applications From Performance Analyzer for details.

You can also open a “live” experiment – an experiment that is still being collected. When you open a live experiment, you see only the data that had already been collected when you opened the experiment. The experiment is not automatically updated as new data comes in. To update, you can open the experiment again.

analyzer Command Options

    These analyzer command options control the behavior of Performance Analyzer and are divided into the following groups:

  • Experiment options

  • Java options

  • Control options

  • Information options

Experiment Options

These options specify how to handle experiments that you specify on the command line.

-c base-group compare-group

Start Performance Analyzer and compare the specified experiments.

The base-group is either a single experiment or a groupname.erg file which specifies multiple experiments. The compare-group is one or more experiments that you want to compare to the base group.

To specify multiple experiments in the compare group, separate the experiment names with spaces. You can also specify a groupname.erg file which specifies multiple experiments in the compare group.

Example 4  Sample Commands for Opening Experiments in Comparison Mode

Open the experiment test.1.er and compare it to test.4.er:

% analyzer -c test.1.er test.4.er

Open the experiment group demotest.erg and compare it to test.4.er:

% analyzer -c demotest.erg test.4.er

Java Options for analyzer Command

These options specify settings for the JVM that runs Performance Analyzer.

-j | --jdkhome jvm-path

Specify the path to the Java software for running Performance Analyzer. When the –j option is not specified, the default path is taken first by examining environment variables for a path to the JVM, in the order JDK_HOME and then JAVA_PATH. If neither environment variable is set, the JVM found on your PATH is used. Use the –j option to override all the default paths.

-J jvm-option

    Specify the JVM options. You can specify multiple options. For example:

  • To run the 64–bit Performance Analyzer, type:

    analyzer -J-d64
  • To run Performance Analyzer with a maximum of JVM memory of 2 Gbytes, type:

    analyzer -J-Xmx2G
  • To run the 64–bit Performance Analyzer with a maximum JVM memory of 8 Gbytes, type:

    analyzer -J-d64 -J-Xmx8G

Control Options for analyzer Command

These analyzer command options control the location of the user directory where your settings are stored, set the font size of the user interface. and display the version and runtime information before starting Performance Analyzer.

-f | --fontsize size

Specify the font size to be used in the Performance Analyzer user interface..

To start Performance Analyzer and display the menus in 14-point font, type the following:

analyzer -f 14
-v | --verbose

Display version information and Java runtime arguments and then start Performance Analyzer.

Information Options for analyzer Command

These options print information about analyzer to standard output. The individual options below are stand-alone options. They cannot be combined with other analyzer options nor combined with target or experiment-list arguments.

-V | --version

Display version information only and do not start Performance Analyzer.

-? | -h | --help

Print usage information and exit.