Bhardwaj, Gopesh
162 line
6.4 KiB
Markdown
162 line
6.4 KiB
Markdown
# Changelog for ROCprofiler-SDK
|
|
|
|
Full documentation for ROCprofiler-SDK is available at [rocm.docs.amd.com/projects/rocprofiler-sdk](https://rocm.docs.amd.com/projects/rocprofiler-sdk/en/latest/index.html)
|
|
|
|
## ROCprofiler-SDK for AFAR I
|
|
|
|
### Added
|
|
|
|
- HSA API tracing
|
|
- Kernel dispatch tracing
|
|
- Kernel dispatch counter collection
|
|
- Instances reported as single dimension
|
|
- No serialization
|
|
|
|
## ROCprofiler-SDK for AFAR II
|
|
|
|
### Added
|
|
|
|
- HIP API tracing
|
|
- ROCTx tracing
|
|
- Tracing ROCProf Tool V3
|
|
- Documentation packaging
|
|
- ROCTx control (start and stop)
|
|
- Memory copy tracing
|
|
|
|
## ROCprofiler-SDK for AFAR III
|
|
|
|
### Added
|
|
|
|
- Kernel dispatch counter collection. This includes serialization and multidimensional instances.
|
|
- Kernel serialization.
|
|
- Serialization control (on and off).
|
|
- ROCprof tool plugin interface V3 for counters and dimensions.
|
|
- Support to list metrics.
|
|
- Correlation-Id retirement
|
|
- HIP and HSA trace distinction:
|
|
- --hip-runtime-trace For collecting HIP Runtime API traces
|
|
- --hip-compiler-trace For collecting HIP compiler-generated code traces
|
|
- --hsa-core-trace For collecting HSA API traces (core API)
|
|
- --hsa-amd-trace For collecting HSA API traces (AMD-extension API)
|
|
- --hsa-image-trace For collecting HSA API traces (image-extension API)
|
|
- --hsa-finalizer-trace For collecting HSA API traces (finalizer-extension API)
|
|
|
|
## ROCprofiler-SDK for AFAR IV
|
|
|
|
### Added
|
|
|
|
**API:**
|
|
|
|
- Page migration reporting
|
|
- Scratch memory reporting
|
|
- Kernel dispatch callback tracing
|
|
- External correlation Id request service
|
|
- Buffered counter collection record headers
|
|
- Option to remove HSA dependency from counter collection
|
|
|
|
**Tool:**
|
|
|
|
- `rocprofv3` multi-GPU support in a single-process
|
|
|
|
## ROCprofiler-SDK for AFAR V
|
|
|
|
### Added
|
|
|
|
**API:**
|
|
|
|
- Agent or device counter collection
|
|
- PC sampling (beta)
|
|
|
|
**Tool:**
|
|
|
|
- Single JSON output format support
|
|
- Perfetto output format support (.pftrace)
|
|
- Input YAML support for counter collection
|
|
- Input JSON support for counter collection
|
|
- Application replay in counter collection
|
|
- `rocprofv3` multi-GPU support:
|
|
- Multiprocess (multiple files)
|
|
|
|
### Changed
|
|
|
|
- `rocprofv3` tool now requires mentioning `--` before the application. For detailed use, see [Using rocprofv3](source/docs/how-to/using-rocprofv3.rst)
|
|
|
|
### Resolved issues
|
|
|
|
- Fixed `SQ_ACCUM_PREV` and `SQ_ACCUM_PREV_HIRE` overwriting issue
|
|
|
|
## ROCprofiler-SDK 0.4.0 for ROCm release 6.2 (AFAR VI)
|
|
|
|
### Added
|
|
|
|
- OTF2 tool support
|
|
- Kernel and range filtering
|
|
- Counter collection definitions in YAML
|
|
- Documentation updates (SQ block, counter collection, tracing, tool usage)
|
|
- `rocprofv3` option `--kernel-rename`
|
|
- `rocprofv3` options for Perfetto settings (buffer size and so on)
|
|
- CSV columns for kernel trace
|
|
- `Thread_Id`
|
|
- `Dispatch_Id`
|
|
- CSV column for counter collection
|
|
|
|
|
|
## ROCprofiler-SDK 0.5.0 for ROCm release 6.3 (AFAR VII)
|
|
|
|
### Added
|
|
|
|
- Start and end timestamp columns to the counter collection csv output
|
|
- Check to force tools to initialize context id with zero
|
|
- Support to specify hardware counters for collection using rocprofv3 as `rocprofv3 --pmc [COUNTER [COUNTER ...]]`
|
|
- Memory Allocation Tracing
|
|
- PC sampling tool support with CSV and JSON output formats
|
|
- List supported PC Sampling Configurations
|
|
|
|
### Changed
|
|
|
|
- `--marker-trace` option for `rocprofv3` now supports the legacy ROCTx library `libroctx64.so` when the application is linked against the new library `librocprofiler-sdk-roctx.so`.
|
|
- Replaced deprecated `hipHostMalloc` and `hipHostFree` functions with `hipExtHostAlloc` and `hipFreeHost` for ROCm versions starting 6.3.
|
|
- Updated `rocprofv3` `--help` options.
|
|
- Changed naming of "agent profiling" to a more descriptive "device counting service". To convert existing tool or user code to the new name, use the following sed:
|
|
`find . -type f -exec sed -i 's/rocprofiler_agent_profile_callback_t/rocprofiler_device_counting_service_callback_t/g; s/rocprofiler_configure_agent_profile_counting_service/rocprofiler_configure_device_counting_service/g; s/agent_profile.h/device_counting_service.h/g; s/rocprofiler_sample_agent_profile_counting_service/rocprofiler_sample_device_counting_service/g' {} +`
|
|
- Changed naming of "dispatch profiling service" to a more descriptive "dispatch counting service". To convert existing tool or user code to the new names, the following sed can be used: `-type f -exec sed -i -e 's/dispatch_profile_counting_service/dispatch_counting_service/g' -e 's/dispatch_profile.h/dispatch_counting_service.h/g' -e 's/rocprofiler_profile_counting_dispatch_callback_t/rocprofiler_dispatch_counting_service_callback_t/g' -e 's/rocprofiler_profile_counting_dispatch_data_t/rocprofiler_dispatch_counting_service_data_t/g' -e 's/rocprofiler_profile_counting_dispatch_record_t/rocprofiler_dispatch_counting_service_record_t/g' {} +`
|
|
- `FETCH_SIZE` metric on gfx94x now uses `TCC_BUBBLE` for 128B reads.
|
|
- PMC dispatch-based counter collection serialization is now per-device instead of being global across all devices.
|
|
- Added output return functionality to rocprofiler_sample_device_counting_service
|
|
- Added rocprofiler_load_counter_definition.
|
|
|
|
### Resolved issues
|
|
|
|
- Create subdirectory when `rocprofv3 --output-file` includes a folder path
|
|
- Fixed misaligned stores (undefined behavior) for buffer records
|
|
- Fixed crash when only scratch reporting is enabled
|
|
- Fixed `MeanOccupancy` metrics
|
|
- Fixed aborted-application validation test to properly check for `hipExtHostAlloc` command
|
|
- Fixed implicit reduction of SQ and GRBM metrics
|
|
- Fixed support for derived counters in reduce operation
|
|
- Bug fixed in max-in-reduce operation
|
|
- Introduced fix to handle a range of values for `select()` dimension in expressions parser
|
|
- Conditional `aql::set_profiler_active_on_queue` only when counter collection is registered (resolves Navi3 kernel tracing issues)
|
|
|
|
### Removed
|
|
|
|
- Removed gfx8 metric definitions
|
|
- Removed `rocprofv3` installation to sbin directory
|
|
|
|
## ROCprofiler-SDK 0.6.0 for ROCm release 6.4
|
|
|
|
### Added
|
|
|
|
- Added support for select() operation in counter expression.
|
|
- Added reduce operation for counter expression wrt dimension.
|
|
- `--collection-period` feature added in rocprofv3, to enable filtering using time.
|
|
- `--collection-period-unit` feature added in rocprofv3, to allow the user to control time units used in collection period option.
|
|
- Added deprecation notice for rocprofiler(v1) and rocprofiler(v2).
|
|
- Added support for rocDecode API Tracing
|
|
|
|
### Changed
|
|
|
|
### Resolved issues
|
|
|
|
### Removed
|