Key Features - Key Features - 57368

uProf User Guide

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

AMDuProfPcm can collect and report the data in the following modes:

  • Timeseries Mode: Profiling data is collected and reported periodically, and the logging interval can be specified with -I option. This is the default mode of data collection.
  • Cumulative Mode: Profiling data is collected and accumulated over the profile run and is reported for the entire profile duration. Use -C option to select this mode.
  • Live Mode: Profiling data is collected and printed on the console periodically. Use the top command to select this mode.

AMDuProfPcm can report data in the following formats:

  • HTML: The HTML report features graphical representations of the monitored metrics, aiding users in visualizing the data. It includes several tabs that organize relevant metrics by PMC type and significance. The report presents a variety of plots and graphs, including time series plots, heatmaps, sunburst charts, and radar graphs. To generate the HTML report, use the --html option in the command.
  • CSV: Profiling data is printed in comma separated value (csv) format, which can be viewed using MS Excel or other similar applications or be used as input for custom scripts for further processing the data.
  • JSON: The JSON report serves as an intermediate format for generating the final HTML report from the CSV report. It organizes performance data into several key sections: hierarchy, metadata, metric-groups, metrics, and sections.
    • The hierarchy section defines the structural relationship between different performance metrics.
    • The metadata section captures environment and system details relevant to the report.
    • The metric-groups section logically groups related metrics together.
    • The metrics section records the actual performance metrics collected during the observation period.
    • The sections section contains configuration for graph plotting based on the collected metrics.

    The JSON report is automatically generated when the --html option is specified in the command.

Process Tracking (Only available in Perf mode)

AMDuProfPcm can profile a specific process, collecting data exclusively for the attached process (designated with the -p option) or application (specified via command). Other background processes running concurrently are excluded from data collection. This feature is only available in Perf mode, when gathering Core PMC metrics, and only supported with system-wide aggregation (using the -A system option).

Table 1. Feature Support Matrix For AMD Zen Family Processors
Feature / AMD Zen Family Zen2 Zen3 Zen4 Zen5
HTML Report No Yes Yes Yes
Virtualization No Yes Yes Yes
CSV Report Yes Yes Yes Yes
Roofline Yes Yes Yes Yes