Intel® VTune™ Amplifier

Filter and Group Command Line Reports

You can manage amplxe-cl reports from command line by using the following options:

Group Report Data

Use the group-by option to group data in your report by some value, such as function. For multiple grouping levels, add arguments separated by commas (no spaces). Grouping columns show up first in the view.

Note

To display a list of available groupings for a particular report, use -help report <report_name> .

Examples:

Sort Report Data

There are a pair of options that you can use to sort report data: sort-asc and sort-desc. Use the sort-asc action-option to organize a report in ascending order of the specified field(s), or use sort-desc to sort it in descending order. You can specify up to three different fields.

Example:

Generate a report from the Microarchitecture Exploration r001ue result, and sort data in ascending order by the event columns INST_RETIRED.ANY and CPU_CLK_UNHALTED.CORE.

$ amplxe-cl -report hw-events -r r001ue -sort-asc INST_RETIRED.ANY,CPU_CLK_UNHALTED.CORE

Filter Reports by Program Unit

You can narrow down your report to display performance data for a particular program unit by using this option:

filter <program_unit> [= | != ] <name>

where:

Note

  • To display a list of available filters for a particular report, use -report <report_name> -result <result_dir> -filter=? .
  • To specify multiple filter items, use multiple -filter option attributes. Multiple values for the same column are combined with 'OR'. Values for different columns are combined with 'AND'.

Examples:

Filter by Call Stack Mode

You can filter the report by call stack display mode to set whether system functions display in the call stack data in your report call-stack-mode

Possible values: all, user-only, user-plus-one.

Example:

Generate a Hotspots report from the most recent compatible result, group the result data by function, and only display user functions and system functions called directly from user functions:

> amplxe-cl -report hotspots -group-by function -call-stack-mode user-plus-one

Filter by Column Name

To display only particular columns providing Reference/event data, use the column option and specify a full name of the required column(s) or its substring.

Note

To display a list of columns available for a particular report, type: amplxe-cl -report <report_name> -r <result_dir> column=?

Examples:

Filter by Time Interval

To view data for a specific time range only, use the time-filter <begin_time>:<end_time> option, where:

Examples:

Related information
Save and Format Command Line Reports
Manage Data Views
group-by action-option
sort-asc action-option
sort-desc action-option
filter action-option
column action-option