Troubleshooting - Troubleshooting - 57368

uProf User Guide

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

Enable Logging

Scenario: To report any issues observed in the uProf, it might be helpful to generate the logs and pass the log files to uProf team to analyze the issue.

Suggestion/Solution: Follow the steps below to enable logging in uProf before running the use case.

Table 1. Enable Logging
uProfCLI Option Description
--log-path <path-to-log-dir>
Specify the path to where log file should be created. If this option is not provided, by default the log file will be created either in path set by AMDUPROF_LOGDIR environment variable or default path.
Note:
  1. If AMDUPROF_LOGDIR is set, its value is used as the path to create the log file.
  2. Refer the table Log File Path for OS specific log file names.
--log-level <level>

Specify the verbosity of log messages generated. Valid values are 1 to 5.

  • 1 - ERROR
  • 2 - ERROR + WARNING (default level)
  • 3 - ERROR + WARNING + INFO
  • 4 - ERROR + WARNING + INFO + DEBUG
  • 5 - ERROR + WARNING + INFO + DEBUG + TRACE
Note: Levels are accumulated, for example selecting level 4 means enabling all the levels 1 to 4.
--log <level>,ts,<path>
This is a shorthand option for all relevant log settings
  • <level> - verbosity of log messages, same as --log-level option.
  • ts - capture timestamp of log messages.
  • <path> - path where log files will be generated.
--enable-logts Use this option to capture the timestamps of the log records. This is same as --log ts.
The default location of the generated log files:
Table 2. Default Log File Paths
Platform Interface Default Path
Windows GUI %userprofile%\.AMDuProf\http\logs\<pid>.log
CLI %TEMP%\%USERNAME%-AMDuProfCLI.log
Linux GUI ${HOME}/.AMDuProf/http/logs/<pid>.log
CLI /tmp/${USER}-AMDuProfCLI.log
FreeBSD CLI /tmp/${USER}-AMDuProfCLI.log

After enabling logging, run the use case to generate the log. The log file can be shared with the uProf team to analyze any issue observed.

AMDuProfPcm option --verbose prints logs to standard output stream. Only available for Perf mode.