When using Intel® Trace Collector, you may want to customize various aspects of its operation and define filters for data tracing. It is achieved through setting up the appropriate configuration options.
You can set up these options in three ways:
In the corresponding environment variables.
In the command line when running your application.
Intel® Trace Collector configuration file is a plain ASCII file that contains a number of directives in each line and has the
For your convenience, Intel® Trace Analyzer and Collector provides a utility called
intended for creating and editing configuration files. However, you can create the configuration file manually using a text editor. For examples and details on syntax, see Configuration Reference
To run the Configuration Assistant, enter the command:
$ itcconfig <trace_file> [<configuration_file>]
Configuration Assistant requires a trace file to be passed, therefore you should first trace your application without any settings to use the utility.
If you do not specify the configuration file, the default settings will be used. Edit the file and save it with the
To apply the settings, do the following:
Set up the
environment variable to point to the full path to your configuration file. For example:
$ export VT_CONFIG=/<configuration_file_directory>/my_settings.conf
Set up the
environment variable to point to the process that reads and parses the configuration file (the default value is
Each option has an equivalent environment variable. To set the variables, use the option names, but prefix them with
and replace hyphens with underscores. For the
options you can also list multiple values in one variable (see Filtering Trace Data
for details). For example:
$ export VT_STATE=* OFF MPI:* ON
Environment variables are checked by the process that reads the configuration file after it has parsed the file, so the variables override the configuration file options.
Using Command-Line Options
To specify configuration options in the command line, at runtime use a string of the following syntax as an argument to your application:
--itc-args --<configuration_option> <value> --itc-args-end
For example, to generate a trace file of the
$ mpirun -n 4 ./MyApp --itc-args --logfile-format SINGLESTF --itc-args-end
Fortran programs are an exception, because Intel Trace Collector has limited access to command line parameters of Fortran programs.
After tracing your application, a protocol file
is created. The file lists all configuration options with their values used when your application was traced, and other useful information. You can use the protocol file of a particular run as a configuration file to trace the application with the same settings again. See Protocol File