perf-nsight-systems

Profile CPU, GPU, and communication timelines from .nsys-rep captures.

Updated May 23, 2026
One-click install
npx skills add https://github.com/yo-steven/skills-exploration-20260522 --skill perf-nsight-systems-yo-steven
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: perf-nsight-systems
Source: https://github.com/yo-steven/skills-exploration-20260522/tree/main/skills/TensorRT-LLM/perf-nsight-systems
Command: npx skills add https://github.com/yo-steven/skills-exploration-20260522 --skill perf-nsight-systems-yo-steven

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you diagnose end-to-end performance slowdowns by profiling a complete system timeline so you can see where CPU, GPU, and communication overlap—or fails to.

Core Features & Use Cases

  • Run Nsight Systems (nsys) CLI profiling to capture .nsys-rep reports for timeline analysis of CUDA activity, NVTX annotations, OS runtime, and distributed communication.
  • Summarize and analyze reports using nsys stats, nsys analyze, and targeted report/recipe outputs to quantify GPU gaps, API overhead, and iteration consistency.
  • Diagnose common bottlenecks such as GPU idle time, slow data loading, synchronous memcpy/synchronization, and NCCL/compute overlap issues in distributed training.

Quick Start

Profile your training workload with Nsight Systems to generate a timeline report and then run nsys stats and nsys analyze to identify the dominant time sources and any anti-patterns.

Frequently Asked Questions about perf-nsight-systems

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

FAQPage Schema
How do I find why my GPU is idle during distributed training?

Nsight Systems profiling identifies GPU idle gaps by capturing a full system timeline with nsys profile, then using nsys stats and nsys analyze to quantify where time is spent across CPU, GPU, OS runtime, and NCCL communication overlap.

What is the best way to profile a CUDA timeline with NVTX annotations?

The best way to profile a CUDA timeline with NVTX annotations is to run nsys profile to generate a .nsys-rep report, then summarize it with nsys stats and nsys analyze to trace CUDA activity and attribute time spent to specific NVTX annotations.

How do I use nsys stats to diagnose slow data loading in deep learning?

You use nsys stats to diagnose slow data loading by analyzing the generated .nsys-rep timeline to identify synchronous memcpy operations, API overhead, and CPU bottlenecks that block GPU compute utilization and cause anti-patterns.

Does Nsight Systems profiling work for analyzing NCCL and compute overlap?

Yes, Nsight Systems profiling works for analyzing NCCL and compute overlap by capturing distributed communication alongside CUDA activity in the .nsys-rep report, allowing you to validate iteration consistency and diagnose communication bottlenecks.

When should I use nsys profile instead of other performance analysis methods?

You should use nsys profile when you need an end-to-end deep learning timeline investigation across CPU, GPU, OS runtime, and communication, rather than isolated kernel-level metrics, to identify complex overlap failures and validate iteration consistency.