Intel® VTune™ Amplifier XE and Intel® VTune™ Amplifier for Systems Help

Generating Command Line Reports

After performing an analysis via the command line, you can Viewing Command Line Results in the GUI to get full benefits of Intel® VTune™ Amplifier GUI tools, or you can view a report from the command line. A variety of report types, filtering and formatting options are available.

Limitations:

Report Command Syntax

Use the following syntax to generate a report from the command line:

$ amplxe-cl report <report_name> -result-dir <result_path> [report_options]

where:

Note

-R is the short form of the report action, and -r is the short form of the result-dir action-option. The command syntax for generating a report could also be written as: amplxe-cl -R <report_name> -r <result_path>

Report Types

The amplxe-cl command can generate the following types of reports:

Value
Description
summary
Report on the overall performance of your target.
hotspots
Display collected performance metrics according to the selected analysis type and identify program units that took the most CPU time (hotspots).
hw-events
Display the total number of hardware events.
callstacks
Report full stack data for each hotspot function; identify the impact of each stack on the function CPU or Wait time. You can use the group-by or filter options to sort the data by:
  • callstack

  • function

  • function-callstack

top-down
Report call sequences (stacks) detected during collection phase, starting from the application root (usually, the main() function). Use this report to see the impact of program units together with their callees.
gprof-cc
Report a call tree with the time (CPU and Wait time, if available) spent in each function and its children.
gpu-computing-tasks
Display a list of computing tasks (OpenCL™ kernels) or their instances annotated with total and average time, instance count and average values of GPU hardware metrics (if applicable). You can group or filter the report by computing-task (default) or computing-instance.

Example

This example displays a Hotspots report for the r001hs result, presenting CPU time for the functions of the target in descending order starting from the most time-consuming function.

$ amplxe-cl -report hotspots -r r001hs


Function         CPU Time CPU Time:Effective Time  CPU Time:Effective Time:Idle  CPU Time:Effective Time:Poor  CPU Time:Effective Time:Ok  CPU Time:Effective Time:Ideal  CPU Time:Effective Time:Over  
---------------- -------- -----------------------  ----------------------------  ----------------------------  --------------------------  -----------------------------  ---------------------------- 
grid_intersect     3.371s                  3.371s                            0s                        3.371s                          0s                             0s                            0s
sphere_intersect   2.673s                  2.673s                            0s                        2.673s                          0s                             0s                            0s
render_one_pixel   0.559s                  0.559s                            0s                        0.559s                          0s                             0s                            0s 
...

See Also