perf-nsight-systems

Profile CPU-GPU timelines, API calls, OS events, and NVTX ranges.

2.8k|332|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/NVIDIA/skills --skill perf-nsight-systems
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: perf-nsight-systems
Source: https://github.com/NVIDIA/skills/tree/main/skills/TensorRT-LLM/perf-nsight-systems
Command: npx skills add https://github.com/NVIDIA/skills --skill perf-nsight-systems

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Nsight Systems profiles system-level performance to reveal how CPU and GPU work together over time, enabling you to pinpoint scheduling bottlenecks, overlap gaps, and data movement issues.

Core Features & Use Cases

  • System-level timeline profiling of CPU/GPU activity, API calls, and OS events.
  • NVTX ranges and PyTorch autograd integration to correlate code with GPU work.
  • Workflows for profiling DL training, distributed training, and inference, plus post-run analysis with stats, recipes, and exports.

Quick Start

Profile a representative training run with Nsight Systems, generate an .nsys-rep, and begin analysis with nsys stats/analyze/recipe.

Frequently Asked Questions about perf-nsight-systems

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I profile CPU-GPU scheduling bottlenecks during deep learning training?

System-level timeline profiling reveals how CPU and GPU work together over time, capturing API calls and OS events to pinpoint scheduling bottlenecks and data movement issues during deep learning training.

How do I generate timeline traces with NVTX annotations for CUDA workloads?

You generate timeline traces with NVTX annotations by profiling a representative run to create an .nsys-rep file, which correlates code with GPU work through NVTX ranges and PyTorch autograd integration.

Does Nsight Systems work with PyTorch for distributed training and inference profiling?

Yes, Nsight Systems supports distributed training and inference workflows, utilizing PyTorch autograd integration to correlate code with GPU work and capture CPU and GPU activity timelines.

What is the best way to analyze GPU performance after generating an .nsys-rep file?

The best way to analyze GPU performance after generating an .nsys-rep file is to use nsys stats, analyze, and recipe commands for post-run analysis, enabling you to export detailed reports.

What distinguishes system-level GPU profiling from other performance analysis approaches?

System-level GPU profiling focuses on how CPU and GPU work together over time to reveal scheduling bottlenecks and overlap gaps, rather than focusing solely on individual kernel execution metrics.

When should I use system-level timeline profiling instead of other GPU performance tools?

Use system-level timeline profiling when you need to identify CPU-GPU scheduling bottlenecks, overlap gaps, and data movement issues in DL training, distributed training, or inference workflows.