4、数据采集基础：使用Nsight Systems进行首次性能数据采集（CLI与GUI两种方式）
好，咱们进入实操环节了。前面聊了那么多概念，现在终于要动手了。说实话，我第一次用Nsight Systems的时候，也对着界面发过呆——按钮太多，不知道先点哪个。但别担心，今天我就带你走一遍，把两种采集方式都摸清楚。
4.1 准备工作：你得先有个能跑的程序
在开始采集之前，先确认几件事。嗯，这些坑我都踩过，所以帮你列出来：
- 目标程序必须是编译好的可执行文件——别想着对源码直接采集，Nsight Systems不是编译器。
- 建议用Release模式编译。Debug模式会插入额外检查，影响性能数据真实性。我在项目中遇到过，Debug版采集出来的热点分布跟Release完全不一样，白忙活半天。
- 确保系统时间同步。如果你在多节点采集，时间不同步会导致时间轴错位，分析时你会怀疑人生。
小技巧： 我个人习惯在采集前先跑一遍程序，确认它能正常结束。别问我为什么强调这个——有一次我采集了半小时，结果程序死锁了，数据全废。
4.2 方式一：CLI命令行采集（推荐新手先学这个）
为什么先讲CLI？因为CLI是GUI的底层逻辑。你理解了CLI，GUI那些按钮就只是图形化的壳而已。
最基本的命令长这样：
nsys profile -o my_first_profile ./my_cuda_app这条命令干了三件事：启动你的程序、采集性能数据、把结果存到 my_first_profile.qdrep 文件里。简单吧？
但实际项目中，我们通常需要更精细的控制。我给你一个我常用的模板：
nsys profile \
--trace=cuda,nvtx,osrt \
--cuda-memory-usage=true \
--stats=true \
--output=project_analysis \
./my_cuda_app --input=data.bin解释一下这些参数：
| 参数 | 作用 | 我的经验 |
|---|---|---|
--trace=cuda,nvtx,osrt |
指定采集哪些事件 | cuda必选，nvtx用于标记代码段，osrt看系统调用 |
--cuda-memory-usage=true |
记录内存分配/释放 | 排查内存泄漏时特别有用 |
--stats=true |
输出统计摘要 | 采集完直接看终端，快速了解瓶颈 |
--output |
指定输出文件名 | 不加的话默认是report.qdrep，容易覆盖 |
注意： 采集过程中不要动鼠标键盘？其实不用。Nsight Systems的overhead很小，你正常操作就行。但别开大型游戏或视频渲染——我曾经一边采集一边看4K视频，结果数据里全是调度延迟，根本没法分析。
4.3 方式二：GUI图形化采集（可视化操作）
CLI用熟了之后，GUI就很好理解了。说白了，GUI就是把上面那些参数变成了复选框和下拉菜单。
启动GUI的方式：
nsys-ui或者直接在应用菜单里找NVIDIA Nsight Systems。界面长什么样？嗯，我描述一下：
- 左侧是项目文件列表
- 中间是时间轴视图
- 右侧是配置面板
采集步骤很简单：
- 点击左上角的 "New Project" 或直接点 "Profile" 按钮
- 在弹出的对话框中，选择你的可执行文件
- 在 "Trace Settings" 里勾选你想采集的事件类型
- 点击 "Start" 开始采集
- 程序运行结束后，数据自动加载到时间轴视图
我个人觉得GUI最大的好处是——你能实时看到采集进度。CLI只能干等，GUI下面有个进度条，看着它走完心里踏实。
核心区别： CLI适合脚本化、自动化、批量采集；GUI适合探索性分析、快速验证、教学演示。两个都得会，别偏科。
4.4 两种方式的对比与选择
我整理了一个对比表，你一看就明白：
| 维度 | CLI | GUI |
|---|---|---|
| 上手难度 | 需要记参数 | 点点点就行 |
| 自动化 | 可以写脚本批量跑 | 每次手动操作 |
| 实时反馈 | 只有终端日志 | 有进度条和状态提示 |
| 远程采集 | 天然支持SSH | 需要额外配置X11转发 |
| 数据量 | 适合大规模采集 | 适合小规模探索 |
你想想看，如果你要在100台机器上采集，用GUI一个一个点？那得点到猴年马月。CLI配合一个shell脚本，几分钟搞定。
4.5 知识体系：数据采集的核心逻辑
下面这张图，是我自己总结的数据采集流程。你看一遍，心里就有谱了：
4.6 避坑指南：我踩过的那些坑
最后，分享几个实战中容易翻车的地方：
- 采集时间过长：我曾经对一个跑了2小时的程序做全量采集，结果生成了50GB的数据文件，打开分析时直接卡死。建议先用短时间运行测试，确认配置没问题再上全量。
- 忘记加--output参数：默认文件名是report.qdrep，如果你连续采集多次，后面的会覆盖前面的。别问我怎么知道的——我丢过三次数据才长记性。
- GUI采集时程序崩溃：GUI模式下如果程序异常退出，数据可能不完整。CLI模式至少会给你一个错误码和日志，方便排查。
我的习惯： 每次采集前，先在终端跑一遍
nsys status 检查环境。这个命令会告诉你Nsight Systems是否正常工作，以及当前系统状态。花5秒钟，省半小时排查时间。
好了，数据采集的基础就这些。CLI和GUI两种方式，你各试三次，基本就熟练了。记住，采集只是第一步，真正的重头戏在后面——怎么从数据里看出性能瓶颈。那是下一阶段的事，咱们先把采集这关过了。