-R, -report=<string> Generate a report with the specified name.
Generate a formatted data report with the specified name and action options.
Action Options:
-call-stack-mode=all | user-only | user-plus-one (user-only)
Choose how to show system functions in the stack.
-csv-delimiter=<string> Specify delimiter character for CSV output.
Possible values are any character or the words:
comma, semicolon, colon, or tab.
-cumulative-threshold-percent=<string>
Show top percent of data output.
-discard-raw-data | -no-discard-raw-data (default)
Discard raw collector data from the result upon
finalization.
-filter=<string> Specify items to include or exclude as follows:
<column name> [= | !=] <value>
-format=text | csv Specify output format for report.
-group-by=<string> Specify a grouping level for displaying results.
Default value is function. Use -help report
<report name> to get a list of available
groupings.
-inline-mode=on | off (on) Choose to show or hide inline functions in the
stack.
-limit=<integer> Show top number of items in output.
-report-output=<string> Write report output to a file.
-r, -result-dir=<string> (r@@@{at})
Specify result directory path.
-search-dir=<string> <all | bin | src | sym[:<p | r>]>=<directory>.
<directory> is the name of the search directory
for binaries (bin), sources (src), symbols (sym),
or all these file types (all). Use ':r' to
perform a recursive search of all subdirectories.
Use ':p' to indicate highest priority search
directories (directories that should be searched
prior to others, including environment paths and
absolute paths). You can use these options
together as ':rp'.
-show-as=samples | events | percent (events)
Specify report values as events, samples, or
percent.
-s, -sort-asc=<string> Sort data in ascending order by the given column
name.
-S, -sort-desc=<string> Sort data in descending order by the given column
name.
Global Options:
-q, -quiet Suppress non-essential messages
-user-data-dir=<string> Specify the base directory for result paths
provided by --result-dir option. By default, the
current working directory is used.
-v, -verbose Print additional information
Examples:
1) Generate the 'hotspots' report for the result directory 'r000hs'.
amplxe-cl -report hotspots -r r000hs
2) Group the data by module.
amplxe-cl -report hotspots -r r000hs -group-by module
3) Filter the output by the specified module.
amplxe-cl -report hotspots -r r000hs -filter module=libexample.so
4) Report the difference of two result directories.
amplxe-cl -report hotspots -r r001hs -r r002hs
Use '-help report <report name>' for more information about each report.
Available Reports:
callstacks Display CPU or wait time for callstacks.
frequency-analysis
gprof-cc Display CPU or wait time in the gprof-like format.
hotspots Display CPU time.
hw-events Display hardware events.
perf Display CPU or wait time for each module.
perf-detail Display CPU time for each function or synchronization object.
sfdump Specialized report to display hardware events.
sleep-analysis
summary Display data about overall performance.
top-down Display a call tree for your target application and provide CPU and wait time for each function.
wait-time Display wait time.
Generate a formatted data report with the specified name and action options.
Action Options:
-call-stack-mode=all | user-only | user-plus-one (user-only)
Choose how to show system functions in the stack.
-csv-delimiter=<string> Specify delimiter character for CSV output.
Possible values are any character or the words:
comma, semicolon, colon, or tab.
-cumulative-threshold-percent=<string>
Show top percent of data output.
-discard-raw-data | -no-discard-raw-data (default)
Discard raw collector data from the result upon
finalization.
-filter=<string> Specify items to include or exclude as follows:
<column name> [= | !=] <value>
-format=text | csv Specify output format for report.
-group-by=<string> Specify a grouping level for displaying results.
Default value is function. Use -help report
<report name> to get a list of available
groupings.
-inline-mode=on | off (on) Choose to show or hide inline functions in the
stack.
-limit=<integer> Show top number of items in output.
-report-output=<string> Write report output to a file.
-r, -result-dir=<string> (r@@@{at})
Specify result directory path.
-search-dir=<string> <all | bin | src | sym[:<p | r>]>=<directory>.
<directory> is the name of the search directory
for binaries (bin), sources (src), symbols (sym),
or all these file types (all). Use ':r' to
perform a recursive search of all subdirectories.
Use ':p' to indicate highest priority search
directories (directories that should be searched
prior to others, including environment paths and
absolute paths). You can use these options
together as ':rp'.
-show-as=samples | events | percent (events)
Specify report values as events, samples, or
percent.
-s, -sort-asc=<string> Sort data in ascending order by the given column
name.
-S, -sort-desc=<string> Sort data in descending order by the given column
name.
Global Options:
-q, -quiet Suppress non-essential messages
-user-data-dir=<string> Specify the base directory for result paths
provided by --result-dir option. By default, the
current working directory is used.
-v, -verbose Print additional information
Examples:
1) Generate the 'hotspots' report for the result directory 'r000hs'.
amplxe-cl -report hotspots -r r000hs
2) Group the data by module.
amplxe-cl -report hotspots -r r000hs -group-by module
3) Filter the output by the specified module.
amplxe-cl -report hotspots -r r000hs -filter module=libexample.so
4) Report the difference of two result directories.
amplxe-cl -report hotspots -r r001hs -r r002hs
Use '-help report <report name>' for more information about each report.
Available Reports:
callstacks Display CPU or wait time for callstacks.
frequency-analysis
gprof-cc Display CPU or wait time in the gprof-like format.
hotspots Display CPU time.
hw-events Display hardware events.
perf Display CPU or wait time for each module.
perf-detail Display CPU time for each function or synchronization object.
sfdump Specialized report to display hardware events.
sleep-analysis
summary Display data about overall performance.
top-down Display a call tree for your target application and provide CPU and wait time for each function.
wait-time Display wait time.