ROCTracer documentation

Important

ROCTracer, ROCProfiler, rocprof, and rocprofv2 are deprecated. It’s strongly recommended to upgrade to the latest version of the ROCprofiler-SDK library and the rocprofv3 tool to ensure continued support and access to new features.

To learn about key feature improvements and benefits of ROCprofiler-SDK over the deprecated ROCProfiler and ROCTracer, see Comparing ROCprofiler-SDK to legacy ROCm profiling tools.

It’s anticipated that ROCTracer, ROCProfiler, rocprof, and rocprofv2 will reach end of support (EoS) by the end of 2026 Q2.

ROCTracer consists of the ROCTracer and ROC-TX libraries, which provide APIs to help you trace an application in the runtime. The runtime-independent API enables tracing runtime calls and asynchronous activities such as GPU kernel dispatches and memory moves to profile the application and hardware performance.

The code is open and hosted at ROCm/rocm-systems.

Note

The ROCTracer repository for ROCm 7.0 and earlier is located at ROCm/roctracer.

Install

• Installing ROCTracer

Reference

• ROCTracer library specification

• ROC-TX library specification

• ROCTracer API library

  • Modules

  • Data Structures

  • Files

To contribute to the documentation, refer to Contributing to ROCm.

You can find licensing information on the Licensing page.