Saving and Formatting Reports from the Command
Line
By default, a report is written to
stdout
in text format, but the
Intel Inspector
inspxe-cl
command provides a number of options you can
use when generating a report.
Saving a Report to a File
To save a report to a file, you must use the
report-output option
when generating a report, and specify a pathname for the output file. By
default, most reports are saved as a text file, but you can also choose CSV or
XML. Whichever file type you choose, filtering and sorting options are
available for formatting your report.
Example
Generate a status report from the most recent
result and save it as
status-report.txt
file in the current working
directory.
$ inspxe-cl -report status -report-output
status-report.txt
Generating a Report in CSV File Format
Use the
format
option with the
CSV
format.
If you choose the CSV format and want to use a
delimiter other than the default comma, you must use the
csv-delimiter option to
specify either a
comma
or
tab
delimiter.
CSV Report Example
Generate an observations report in CSV format using tab delimiters,
and save it as
observations.csv
.
$ inspxe-cl -report observations -format csv -csv-delimiter
tab -report-output ./out/observations.csv
Sorting Report Data
Data Sorting Example
Generate a problems report from the most recently collected result,
and display the problems by line number in ascending order.
$ inspxe-cl -report problem -sort-asc line
Filtering Report Data
You can filter a report by specifying columns and
values that should be included or excluded, and these can be used singly or in
combination.
Syntax
-filter |
-f <column_name> = <value>
To display data that equals the specified values
only, run the
amplxe-cl
command with the
report
action and
filter
option as
follows:
$ inspxe-cl -report
<report_type>
-filter
<column_name>
=
<value>
where
- <column_name>is the column name (module,function, and so on)
- <value>is the value to include
Specify multiple filter items by using multiple
-filter
option
attributes.
- Multiple values for the same column are combined with 'OR'.
- Values for different columns are combined with 'AND'.
Report Filtering Examples
Generate a Problems report that only includes problems in the source
file combine.cpp that have not yet been investigated.
$ inspxe-cl -report problems -filter source=combine.cpp
-filter investigated=not_investigated
Generate a Problems report, filtering it so that only critical
problems are reported.
$ inspxe-cl -report problems -user-data-dir "My Inspector
Results - myProjectName" -f severity=critical