Using CLI to Profile - Using CLI to Profile - 57368

uProf User Guide

Document_ID
57368
Release_Date
2025-06-09
Revision
5.1 English

Use the AMDuProfCLI timechart command to collect the system metrics and write them into a text file or comma-separated-value (CSV) file. Complete the following procedure to collect power profile counter values:

  1. Run the command with --list option to get the list of supported counter categories.
  2. Use the command to specify the required counters with -e or --event option to collect and report the required counters.

    The timechart run to list the supported counter categories is given here:

    Figure 1. --list Command Output
    The timechart run to collect the profile samples and write into a file is given here:
    Figure 2. Timechart Run

The run will collect the power and frequency counters on all the devices on which these counters are supported and writes them in the output file specified with the -o option. Before the profiling begins, the given application will be launched and the data will be collected till the application terminates.

Examples

Windows

Collect all the power counter values for a duration of 10 seconds with a sampling interval of 100 milliseconds.
C:\> AMDuProfCLI.exe timechart --event power --interval 100 --duration 10
Collect all frequency counter values for 10 seconds, sampling them every 500 milliseconds and adding the results to a csv file.
C:\> AMDuProfCLI.exe timechart --event frequency -o C:\Temp\Poweroutput --interval 500 -- duration 10
Collect all the frequency counter values at core 0 to 3 for 10 seconds, sampling them every 500 milliseconds and adding the results to a text file.
C:\> AMDuProfCLI.exe timechart --event core=0-3,frequency -o C:\Temp\Poweroutput
--interval 500 --duration 10 --format txt
Collect socket temperature when workload is running, set the sampling interval to 500 milliseconds.
C:\> AMDuProfCLI timechart --event socket,temperature --interval 500 <command to execute workload>

Linux

Collect all the power counter values for a duration of 10 seconds with a sampling interval of 100 milliseconds.
$ ./AMDuProfCLI timechart --event power --interval 100 --duration 10
Collect all the frequency counter values for 10 seconds, sampling them every 500 milliseconds and adding the results to a csv file.
$ ./AMDuProfCLI timechart --event frequency -o /tmp/PowerOutput --interval 500 --duration 10
Collect all the frequency counter values at core 0 to 3 for 10 seconds, sampling them every 500 milliseconds and adding the results to a text file.
$ ./AMDuProfCLI timechart --event core=0-3,frequency -o /tmp/PowerOutput --interval 500 --duration 10 --format txt