perf-workload-profiling

Instrument GPU workloads with CUDA event timing and NVTX labeling.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Code instrumentation for timing GPU workloads, enabling precise measurements of per-iteration latency, throughput, and data loading for training loops, as well as standalone kernel timing with warmup and per-iteration statistics; NVTX labeling for profiler timelines is also supported.

Core Features & Use Cases

  • Manual timing for training loops to report per-iteration latency and throughput, with data-load timing.
  • CUDA event-based timing for standalone kernels or ops, with warmup and per-iteration statistics.
  • NVTX annotations to label profiler timelines for clearer visualization.

Quick Start

Provide a timing harness for your training loop or kernel to collect per-iteration latency, throughput, and data-load metrics with NVTX labeling.

Frequently Asked Questions about perf-workload-profiling

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

FAQPage Schema
How do I measure per-iteration latency and throughput for a GPU training loop?

Measure per-iteration latency and throughput for a GPU training loop by instrumenting the code with manual timing and CUDA event benchmarking, ensuring proper warmup handling and pre-allocation of timing resources to capture accurate data-load metrics.

What is the best way to profile standalone CUDA kernels with warmup and per-iteration statistics?

Profiling standalone CUDA kernels requires CUDA event-based timing to capture per-iteration statistics, utilizing proper warmup handling and avoiding intra-iteration synchronization to ensure precise kernel benchmarking measurements.

How do I add NVTX annotations to label profiler timelines for GPU workloads?

Add NVTX annotations to label profiler timelines by instrumenting GPU workloads with NVTX labeling, providing clearer visualization of training loops and standalone kernel operations within the profiler timeline.

Does GPU workload timing with CUDA events require avoiding intra-iteration synchronization?

GPU workload timing with CUDA events requires avoiding intra-iteration synchronization to ensure accurate measurements, along with proper warmup handling and pre-allocation of timing resources for reliable benchmarking.

Can I benchmark TensorRT-LLM workloads using manual timing and CUDA event benchmarking?

Benchmark TensorRT-LLM workloads by applying manual timing for training loops and CUDA event-based timing for standalone kernels, capturing per-iteration latency, throughput, and data loading metrics with NVTX profiler timeline support.