Data Collection Using CLI - Data Collection Using CLI - 57368

uProf User Guide
Document ID
57368
Release Date
2025-06-09
Revision
5.1 English
  • Overview collection
    AMDuProfCLI collect --config overview -o <output-dir> <application>
  • Overview with timer interval of 100 msec
    AMDuProfCLI collect --config overview --timer-interval 100 -o <output-dir> <application>
  • Overview with profiling signal as SIGRTMIN
    AMDuProfCLI collect --config overview --profiling-signal 34 -o <output-dir> <application>
  • Overview with function tracing threshold of 1000000 nsec
    AMDuProfCLI collect --config overview --osrt-threshold function:1000000 -o <output-dir> <application>
  • Overview to trace the functions of size 32 bytes
    AMDuProfCLI collect --config overview --func-size 32 -o <output-dir> <application>

Once profile data collection completes, session directory will be generated. Use session directory to generate the csv report (or) to import the session in GUI.

Refer Table 1 for all supported options.

Example 

[amd@uprof-ethanolx5 bin]$ ./AMDuProfCLI collect --config overview -o /tmp/ /tmp/ScimarkStable Profiling started
…
Profiling (data collection) completed
Generated data files path: /tmp/AMDuProf-ScimarkStable-Overview_Sep-05-2024_21-59-08

Here, the generated session directory is /tmp/AMDuProf-ScimarkStable-Overview_Sep-05-2024_21-59-08.

Options

Table 1. Overview Analysis options
CLI option GUI option Description
--timer-interval <interval> Predefined Configs > Overview > Timer Interval Provide per thread OS timer interval in msec. Default timer interval is 10 ms.
--profiling-signal <signal> Predefined Configs > Overview > Profiling Signal If application has signal handler for SIGPROF, then use this option to provide unused signal from SIGRTMIN to SIGRTMAX.
--func-size <size> NA By default, overview analysis traces the functions of size more than or equals to 128 bytes, if you want to trace functions of custom size, use this option to set the function size.