Collecting Traces Inside the Flow Graph Analyzer GUI
To run an existing
Intel® oneAPI Threading Building Blocks
(oneTBB
) application and collect execution trace information for analysis, you can launch the
TBB trace collector
feature from the Flow Graph Analyzer GUI as follows, assuming the paths for the
oneTBB
libraries are set up (see Release Notes and Known Issues for limitations):
- Run the trace collector using one of the following options:
- Go to themenu option.
- Click theRun and Collect Traces
icon on the toolbar.
The collectorPreferenceswindow opens, which lets you specify the application to run: - In the collectorPreferenceswindow:
- Specify an application to run in theApplicationfield.
- Optional: Change theWorking Directoryvalue if required. The default is the Flow Graph Analyzer directory.
- View and set other environment variables, includingINTEL_LIBITTNOTIFY32andINTEL_LIBITTNOTIFY64, using theEnvironment Variablespane of the dialog box.The environment variables for running trace collection have default settings if you did not change their values in the environment from which the Flow Graph Analyzer is launched. The inherited values are used if the environment variables are set in the environment.OSEnvironment VariableDefault ValueDescriptionWindows*INTEL_LIBITTNOTIFY32..\fgt\windows\bin\ia32\vc14.1\fgt.dll32-bit collector libraryINTEL_LIBITTNOTIFY64..\fgt \windows\bin\intel64\vc14.1\fgt.dll64-bit collector libraryINTEL_ITTNOTIFY_GROUPSall;Trace events from all groupsLinux*INTEL_LIBITTNOTIFY32../fgt/linux/lib/ia32/cc4.8_libc2.19_kernel3.13.0/libfgt.so32-bit collector libraryINTEL_LIBITTNOTIFY64../fgt/linux/lib/intel64/cc4.8_libc2.19_kernel3.13.0/libfgt.so64-bit collector libraryINTEL_ITTNOTIFY_GROUPSall;Trace events from all groupsmacOS*INTEL_LIBITTNOTIFY32../fgt/macos/lib/ia32/osx10.12.6_kernel16.7.0/libfgt.dylib32-bit collector libraryINTEL_LIBITTNOTIFY64../fgt/macos/lib/intel64/osx10.12.6_kernel16.7.0/libfgt.dylib64-bit collector libraryINTEL_ITTNOTIFY_GROUPSall;Trace events from all groups
- Click theAccept Run collectionbutton. If the application is executed correctly, the trace files are converted to a GraphML* format. The output file is stored in the working directory with a name based on the executable name and the time of the trace collection run.
- To examine the trace file, load the GraphML* file into the Flow Graph Analyzer GUI manually.