Windows - Windows - 57368

uProf User Guide
Document ID
57368
Release Date
2025-06-09
Revision
5.1 English

Core Metrics

Table 1. Core Metrics: Tasks and Related Commands
Task Description Command
Get the list of supported metrics C:\> AMDuProfPcm.exe -h
Collect IPC data from core 0 for the duration of 30 seconds C:\> AMDuProfPcm.exe -m ipc -c core=0 -d 30 -O C:\tmp
Collect IPC/L2 metrics for all the core in CCX=0 for the duration of 30 seconds C:\> AMDuProfPcm.exe -m ipc,l2 -c ccx=0 -d 30 -O C:\tmp
Collect IPC data for 30 seconds from all the cores in the system C:\> AMDuProfPcm.exe -m ipc -a -d 30 -O C:\tmp
Collect IPC data from core 0 and run the program C:\> AMDuProfPcm.exe -m ipc -c core=0 -O C:\tmp myapp.exe
Collect IPC and data l2 data from all the cores and report the aggregated data at the system and package level C:\> AMDuProfPcm.exe -m ipc,l2 -a -O C:\tmp -d 30 -A system,package
Collect IPC and data l2 data from all the cores in CCX=0 and report the cumulative (not timeseries) C:\> AMDuProfPcm.exe -m ipc,l2 -c ccx=0 -O C:\tmp -C -d 30
Collect IPC and data l2 data from all the cores and report the cumulative (not timeseries) C:\> AMDuProfPcm.exe -m ipc,l2 -a -O C:\tmp -C -d 30
Collect IPC and data l2 data from all the cores and report the cumulative (not timeseries) and aggregate at system and package level C:\> AMDuProfPcm.exe -m ipc,l2 -a -O C:\tmp -C -A system,package -d 30

L3 Metrics

Table 2. L3 Metrics: Tasks and Related Commands
Task Description Command
Collect L3 data from ccx=0 for the duration of 30 seconds C:\> AMDuProfPcm.exe -m l3 -c ccx=0 -d 30 -O C:\tmp
Collect L3 data from all the CCXs and report for the duration of 30 seconds C:\> AMDuProfPcm.exe -m l3 -a -d 30 -O C:\tmp
Collect L3 data from all the CCXs and aggregate at system and package level and report for the duration of 30 seconds C:\> AMDuProfPcm.exe -m l3 -a -d 30 -A system,package -O C:\tmp
Collect L3 data from all the CCXs and aggregate at system and package level and report for the duration of 30 seconds; also report for the individual CCXs C:\> AMDuProfPcm.exe -m l3 -a -d 30 -A system,package,ccx -O C:\tmp
Collect L3 data from all the CCXs for the duration of 30 seconds and report the cumulative data (no timeseries data) C:\> AMDuProfPcm.exe -m l3 -a -d 30 -C -O C:\tmp
Collect L3 data from all the CCXs and aggregate at system and package level and report cumulative data (no timeseries data) C:\> AMDuProfPcm.exe -m l3 -a -d 30 -A system,package -C -O C:\tmp
Collect IPC data from core 0 for the duration of 30 seconds C:\> AMDuProfPcm.exe -m ipc -c core=0 -d 30 -O C:\tmp

Memory Bandwidth

Table 3. Memory Bandwidth: Tasks and Related Commands
Task Description Command
Report memory bandwidth for all the memory channels for the duration of 60 seconds and save the output in c:\tmp\pcmdata.csv file C:\> AMDuProfPcm.exe -m memory -a -d 60 -O C:\tmp
Report total memory bandwidth aggregated at the system level for the duration of 60 seconds and save the output in c:\tmp\pcmdata.csv file C:\> AMDuProfPcm.exe -m memory -a -d 60 -O C:\tmp -A system
Report total memory bandwidth aggregated at the system level and also report for every memory channel C:\> AMDuProfPcm.exe -m memory -a -d 60 -O C:\tmp -A system,package
Report total memory bandwidth aggregated at the system level and also report for all the available memory channels. To report cumulative metric value instead of the timeseries data C:\> AMDuProfPcm.exe -m memory -a -d 60 -O C:\tmp S -C -A system,package

Raw Event Count Dump

Table 4. Raw Event Count Dump: Tasks and Related Commands
Task Description Command
Monitor events from core 0 and dump the raw event counts for every sample in timeseries manner, no metrics report will be generated C:\> AMDuProfPcm.exe -m ipc -d 60 c:\tmp\pcmdata_dump.csv
Monitor events from all the cores and dump the raw event counts for every sample in timeseries manner, no metrics report will be generated C:\> AMDuProfPcm.exe -m ipc -a -d 60 c:\tmp\pcmdata_dump.csv

Custom Config File

Config files are available for supported processors at <uprof-install-dir>\bin\Data\Config\. Default config file name for a specific processor, identified by family and model number, has the format <Family>_<Model Range>.conf. Example: 0x19_0x1.conf is used for all the processors with family value as 0x19 family and model number between 0x10 to 0x1f. Config files with RL_ prefix are used for roofline command.

Files can be copied and modified to certain user-specific interesting events and formula to compute metrics. All the metrics defined in that file will be monitored and reported.

C:\> AMDuProfPcm.exe -i <custom config file> -a -d 60 -O C:\tmp

Miscellaneous

Table 5. Miscellaneous: Tasks and Related Commands
Task Description Command
List the supported raw Core PMC events C:\> AMDuProfPcm.exe -l
Print the name, description, and the available unit masks for the specified event C:\> AMDuProfPcm.exe -z pmcx03