Files
rocm-systems/source/docs/api-reference/pc_sampling.md
T

22 wiersze
1.4 KiB
Markdown
Czysty Zwykły widok Historia

2024-10-30 19:39:08 +05:30
---
myst:
html_meta:
"description": "ROCprofiler-SDK is a tooling infrastructure for profiling general-purpose GPU compute applications running on the ROCm software."
"keywords": "ROCprofiler-SDK API reference, ROCprofiler-SDK PC sampling, Program counter sampling, PC sampling"
---
2024-05-29 22:31:02 +05:30
2024-10-30 19:39:08 +05:30
# ROCprofiler-SDK PC sampling method
2024-05-29 22:31:02 +05:30
2024-10-30 19:39:08 +05:30
Program Counter (PC) sampling is a profiling method that uses statistical approximation of the kernel execution by sampling GPU program counters. Furthermore, this method periodically chooses an active wave in a round robin manner and snapshots its PC. This process takes place on every compute unit simultaneously, making it device-wide PC sampling. The outcome is the histogram of samples, explaining how many times each kernel instruction was sampled.
2024-05-30 00:42:09 -05:00
2024-10-30 19:39:08 +05:30
:::{note}
Risk acknowledgment:
2024-08-13 23:35:12 +05:30
2024-10-30 19:39:08 +05:30
The PC sampling feature is under development and might not be completely stable. Use this beta feature cautiously. It may affect your system's stability and performance. Proceed at your own risk.
2024-08-13 23:35:12 +05:30
2024-10-30 19:39:08 +05:30
By activating this feature through `ROCPROFILER_PC_SAMPLING_BETA_ENABLED` environment variable, you acknowledge and accept the following potential risks:
- Hardware freeze: This beta feature could cause your hardware to freeze unexpectedly.
- Need for cold restart: In the event of a hardware freeze, you might need to perform a cold restart (turning the hardware off and on) to restore normal operations.
:::