Jobs: document that GPU performance counters are unavailable - #2714
Open
pjmalandrino wants to merge 1 commit into
Open
Jobs: document that GPU performance counters are unavailable#2714pjmalandrino wants to merge 1 commit into
pjmalandrino wants to merge 1 commit into
Conversation
NVIDIA counter access is gated by the host kernel module, so Nsight Compute fails with ERR_NVGPUCTRPERM inside a Job and no image or command change can enable it. Add a note under Hardware flavor so users stop debugging their image for a platform restriction.
pjmalandrino
force-pushed
the
jobs-gpu-counters-note
branch
from
August 19, 2026 10:26
1ce8ad9 to
3bc07a0
Compare
Member
|
Maybe a bit too much of a edge case to be mentioned in the main docs? |
Author
|
Yeah, it's rare for sure. The annoying part is that when you hit it, the error points to a driver setting you can't touch on Jobs, so you end up debugging your own image on paid GPU time for nothing. Happy to cut it to one sentence or move it somewhere less visible. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds a note under Hardware flavor in
jobs-configuration.md: NVIDIA GPU performance counters are not accessible from inside a Job.The failure mode is confusing. Nsight Compute installs and even attaches to the target process, then fails:
This looks like a problem with the image, so you keep trying variants (different CUDA base, different
ncuversion,--target-processes all, running as root). None of that can work: counter access is gated by the host's NVIDIA kernel module (NVreg_RestrictProfilingToAdminUsers), and nothing inside the job can change it. A note in the docs would have saved me that time.For the record: observed on
l40sx1, driver 580.159.03, nsight-compute-2024.1.1 installed from the CUDA apt repo. On the same job,nvidia-smiqueries and CUDA event timing work fine.I only hit the counter restriction, so that is all the note claims. Happy to reword this or move it if another spot fits better.
Note
Low Risk
Documentation-only change with no runtime, security, or API impact.
Overview
Adds a [!NOTE] under Hardware flavor in
jobs-configuration.md(right after thehf jobs hardwaretable) explaining that NVIDIA GPU performance counters cannot be used inside Jobs.The note calls out the
ERR_NVGPUCTRPERMfailure mode for profilers like Nsight Compute, states the limit is host-enforced (not fixable via image, command, or env), links NVIDIA’s docs, and clarifies thatnvidia-smiand CUDA event timing still work.Reviewed by Cursor Bugbot for commit 3bc07a0. Bugbot is set up for automated code reviews on this repo. Configure here.