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

group-by

Specify grouping in a report.

GUI Equivalent

Bottom-up tab > Grouping drop-down menu

Syntax

-group-by <granularity1>,<granularity2>

Arguments

Argument

Description

<granularity>

Grouping level that depends on the report type.

Default

Varies by report; function is the most common default.

Actions Modified

report

Description

Use the group-by action-option to group data in your report by your specified criteria. For multiple grouping levels, add arguments separated by commas (no spaces).

Note

For some reports (for example, top-down report) you can specify only a single grouping level.

To display a list of available groupings for a particular report, type: amplxe-cl -report <report_name> -r <result_dir> group-by=?. If you do not specify a result directory, the latest result is used by default.

Note

The function value groups the result data both by function and by module. To group just by the function, use function-only.

Example

Output a hardware events report for the latest result with data grouped by module:

$ amplxe-cl -report hw-events -group-by module

Output a hotspots report for the latest result with data grouped by thread and function:

$ amplxe-cl -report hotspots -group-by thread,function

Display all available hw-events report groupings for a TSX Hotspots analysis result:

$ amplxe-cl -report hw-events -r /temp/test/r029ths/r029ths group-by=?
amplxe: Using result path '/temp/test/r029ths/r029ths'

Available values for '-group-by' option are:
basic-block 
basic-block-size 
frame 
frame-domain 
frame-type 
function (default) 
function-mangled 
outer-function-mangled 
module 
process 
source-file 
source-line 
task 
thread 
cpuid 
sync-obj 
address 
function-range 
source-function 
wake-up-reason 
wake-up-object 
package 

See Also