rocm-6.2.1

ROCm release v6.2.1

rocm-6.2.0

ROCm release v6.2.0

rocm-6.1.2

ROCm release v6.1.2

Added

• ATT: Continuous mode. The input file now has a DISPATCH_RANGE=begin,end that specifies continuous ATT collection during the application run.
• ATT: Ability to dump raw codeobjects as .out files with ISA_CAPTURE_MODE=[0,1,2]
• Updated README and CMakeLists.txt for rocm-llvm-dev dependency.

Removed

• ATT: Network mode, since it was redundant with file mode.
• ATT: Generated isa.s file, since the functionality was moved from collection to parsing time.

rocm-6.1.1

ROCm release v6.1.1

rocm-6.1.0

ROCm release v6.1.0

rocm-6.0.2

ROCm release v6.0.2

rocm-6.0.0

ROCm release v6.0.0

rocm-5.7.1

Navi support

Rocprofiler for ROCm 5.7 added support for counter collection (PMC) and advanced thread tracing (ATT) for Navi21 and Navi31 GPUs.

• On Navi3x, counter collection requires the GPU to be in a stable power state. See README.md for instructions. HIP RT in ATT not yet supported.

Changed

• ATT analysis will not run by default. For ATT to have the same behaviour as 5.5, use --plugin att <as.s> --mode network
• Kernel Names are now removed from HIP API records, users of the API can get the kernel names from the corresponding HIP Dispatch OPS using the correlation ID, this change was done to optimize and to manage the data copied.
• Removing Replay modes as we discovered that some of them will corrupt the applications' behavior, we will re-add them once we implement the fix for them.

Optimized

• Improved ATT parser performance and filesizes.
• Now profiler autocorrects user input errors for pmc and throws exception for wrong input with this message:"Bad input metric. usage --> pmc: [counter1] [counter2]"

Added

• Every API trace in V2 reported synchronously will have two records, one for Enter phase and for Exit phase
• File Plugin now reports the HSA OPS operation kind as part of the output text
• MI300 counters support for rocprof v1 and v2.
• Support for MI300 XCC modes for rocprof v2.
• MI300 individual XCC counters dumped per-xcc as separate records but with same record-id and kernel dispatch info
• Naming for MPI ranks. Filenames containing "%rank" are replaced by variables "MPI_RANK", "OMPI_COMM_WORLD_RANK" or "MV2_COMM_WORLD_RANK".
• MPI Rank will appear in perfetto track names.
• File plugin is splitted to File & CLI plugins, CLI plugin is responsible for showing results on the terminal screen and will be automatically the choice if no -d option given in rocprof, File plugin on the other hand is responsible for writing the output results in files if -d option is given.
• Structure of the results is different for both CLI & File plugin; File plugin will make sure every type of result is in a separate file, starting by specifying the header; CLI plugin will have the records in the old way.
  Example for file plugin output:

  Dispatch_ID,GPU_ID,Queue_ID,Queue_Index,PID,TID,GRD,WGR,LDS,SCR,Arch_VGPR,ACCUM_VGPR,SGPR,Wave_Size,SIG,OBJ,Kernel_Name,Start_Timestamp,End_Timestamp,Correlation_ID,GRBM_COUNT
  
  1,4,1,1,1584730,1584730,10,10,0,0,8,0,16,64,140464978048000,1,"helloworld(char*, char*) (.kd)",0,140469300947216,33,12637.000000
  

  Domain,Function,Kernel_Name,Start_Timestamp,End_Timestamp,Correlation_ID
  
  HIP_API_DOMAIN,hipGetDeviceProperties,,316678074094190,316678074098929,1
  HIP_API_DOMAIN,hipMalloc,,316678074105702,316678074130851,2
  HIP_API_DOMAIN,hipMalloc,,316678074131382,316678074136111,3
  

• Removing Record IDs from tracer records in CLI plugin.
• Added Flush Interval and Trace Period functionality, where --flush-interval <time_in_ms>, for flushing the buffers every given interval by the user, and --trace-period :<trace_time>:, where delay is the time to wait before starting session, trace_time is the time between every start and stop session and interval the time between two consecutive sessions (ommiting interval = infinite). For more details please refer to the ROCProfV2 tool usage document.
• Added requirements.txt to be used to install all the necessary python3 packages.
• ATT plugin:
  • Added --mode, --mpi and --depth parameters.
  • Limiting file name sizes for large kernels.
  • SE_MASK parameter for input.txt, a binary mask specifying for which shader engines to collect from.
    On GFX9, SEs are masked out completely. On Navi only part of the data is masked.
    The use of SE_MASK=0x1 is heavily encouraged to avoid packet lost events.
  • "ROCPROFILER_MAX_ATT_PROFILES" environment variable can be set. Previously fixed at 16, now the default is 1.
  • Increased default ATT buffer size per collection to 1GB. Added "BUFFER_SIZE=size" (in MB) parameter to set buffer size.
  • Added "DISPATCH=id" or "DISPATCH=id,rank" to set which dispatch ids to profile for which MPI rank.

Fixed

• Samples are fixed to show the new usage of phases.
• Plugin option validates the plugin names.
• Fixing rocsys, for rocsys options, rocsys -h can be called
• "--output-file" option ignored when no output folder was specified.
• Perfetto crash when using ROCTX and/or no output file specified.
• Parsing of the getpc, setpc and swappc instructions with registers loaded from scratch space.
• Some browsers caching ATT data from older kernels.
• Navi2x GPUs required the first counter to be GRBM. This is fixed in 5.7.
• If ROCPROFILER_METRICS_PATH environment variable is not set, the counters xml path will be taken from the following path (../libexec/rocprofiler/counters/derived_counters.xml) which is relative to librocprofiler64.so.2.0.0
• Repeated base metrics were not being properly reused by derived counters.
• Fixed wrong dispatch ID on kernel.txt

rocm-5.7.0

Changelog for ROCprofiler

Full documentation for ROCprofiler is available at
docs.amd.com

ROCprofiler for rocm 5.7.0

Navi support

Rocprofiler for ROCm 5.7 added support for counter collection (PMC) and advanced thread tracing (ATT) for Navi21 and Navi31 GPUs.

• On Navi3x, counter collection requires the GPU to be in a stable power state. See README.md for instructions. HIP RT in ATT not yet supported.

Changed

• ATT analysis will not run by default. For ATT to have the same behaviour as 5.5, use --plugin att <as.s> --mode network
• Kernel Names are now removed from HIP API records, users of the API can get the kernel names from the corresponding HIP Dispatch OPS using the correlation ID, this change was done to optimize and to manage the data copied.
• Removing Replay modes as we discovered that some of them will corrupt the applications' behavior, we will re-add them once we implement the fix for them.

Optimized

• Improved ATT parser performance and filesizes.
• Now profiler autocorrects user input errors for pmc and throws exception for wrong input with this message:"Bad input metric. usage --> pmc: [counter1] [counter2]"

Added

• Every API trace in V2 reported synchronously will have two records, one for Enter phase and for Exit phase
• File Plugin now reports the HSA OPS operation kind as part of the output text
• MI300 counters support for rocprof v1 and v2.
• Support for MI300 XCC modes for rocprof v2.
• MI300 individual XCC counters dumped per-xcc as separate records but with same record-id and kernel dispatch info
• Naming for MPI ranks. Filenames containing "%rank" are replaced by variables "MPI_RANK", "OMPI_COMM_WORLD_RANK" or "MV2_COMM_WORLD_RANK".
• MPI Rank will appear in perfetto track names.
• File plugin is splitted to File & CLI plugins, CLI plugin is responsible for showing results on the terminal screen and will be automatically the choice if no -d option given in rocprof, File plugin on the other hand is responsible for writing the output results in files if -d option is given.
• Structure of the results is different for both CLI & File plugin; File plugin will make sure every type of result is in a separate file, starting by specifying the header; CLI plugin will have the records in the old way.
  Example for file plugin output:

  Dispatch_ID,GPU_ID,Queue_ID,Queue_Index,PID,TID,GRD,WGR,LDS,SCR,Arch_VGPR,ACCUM_VGPR,SGPR,Wave_Size,SIG,OBJ,Kernel_Name,Start_Timestamp,End_Timestamp,Correlation_ID,GRBM_COUNT
  
  1,4,1,1,1584730,1584730,10,10,0,0,8,0,16,64,140464978048000,1,"helloworld(char*, char*) (.kd)",0,140469300947216,33,12637.000000
  

  Domain,Function,Kernel_Name,Start_Timestamp,End_Timestamp,Correlation_ID
  
  HIP_API_DOMAIN,hipGetDeviceProperties,,316678074094190,316678074098929,1
  HIP_API_DOMAIN,hipMalloc,,316678074105702,316678074130851,2
  HIP_API_DOMAIN,hipMalloc,,316678074131382,316678074136111,3
  

• Removing Record IDs from tracer records in CLI plugin.
• Added Flush Interval and Trace Period functionality, where --flush-interval <time_in_ms>, for flushing the buffers every given interval by the user, and --trace-period :<trace_time>:, where delay is the time to wait before starting session, trace_time is the time between every start and stop session and interval the time between two consecutive sessions (ommiting interval = infinite). For more details please refer to the ROCProfV2 tool usage document.
• Added requirements.txt to be used to install all the necessary python3 packages.
• ATT plugin:
  • Added --mode, --mpi and --depth parameters.
  • Limiting file name sizes for large kernels.
  • SE_MASK parameter for input.txt, a binary mask specifying for which shader engines to collect from.
    On GFX9, SEs are masked out completely. On Navi only part of the data is masked.
    The use of SE_MASK=0x1 is heavily encouraged to avoid packet lost events.
  • "ROCPROFILER_MAX_ATT_PROFILES" environment variable can be set. Previously fixed at 16, now the default is 1.
  • Increased default ATT buffer size per collection to 1GB. Added "BUFFER_SIZE=size" (in MB) parameter to set buffer size.
  • Added "DISPATCH=id" or "DISPATCH=id,rank" to set which dispatch ids to profile for which MPI rank.

Fixed

• Samples are fixed to show the new usage of phases.
• Plugin option validates the plugin names.
• Fixing rocsys, for rocsys options, rocsys -h can be called
• "--output-file" option ignored when no output folder was specified.
• Perfetto crash when using ROCTX and/or no output file specified.
• Parsing of the getpc, setpc and swappc instructions with registers loaded from scratch space.
• Some browsers caching ATT data from older kernels.
• Navi2x GPUs required the first counter to be GRBM. This is fixed in 5.7.
• If ROCPROFILER_METRICS_PATH environment variable is not set, the counters xml path will be taken from the following path (../libexec/rocprofiler/counters/derived_counters.xml) which is relative to librocprofiler64.so.2.0.0
• Repeated base metrics were not being properly reused by derived counters.
• Fixed wrong dispatch ID on kernel.txt

rocm-5.6.1

ROCm release v5.6.1