operator_task_package/ref/04_profiling/mcprofiler.md

mcProfiler

CLI 要点

--kernelnames   过滤设备 kernel symbol
--kernelname    不是过滤参数
--per-kernel    生成独立 kernel 报告
--counts N      限制匹配 kernel 数量
--single-pass   用有限事件推断全局计数，适合大 case 的快速趋势分析

当前版本使用显式 --metrics 比 --headnames 更稳定。只请求少量不完整指标可能 使报告组装器缺少 CE/ISU 字段；保留 Total Cycles、AP busy 和必要基础组。

推荐核心指标

Total Cycles
AP busy Duty
AP MMA Duty ratio
ISU stall cycles layout
VL1 Hit Rate
L2C Hit Rate
Global Memory Read/Write bytes
shared memory access efficiency
Achieved waves
Dispatched waves

第二组可补充 MTE、STE、MMA、VLS、L2C duty。每次运行保存完整 output 目录， 分析 1_<target>.txt/.json，不要只看 report.txt。

UI

Windows mcProfiler UI 通过 SSH 配置 Linux 采样并展示报告。已有 Linux CLI 时 UI 不是采样必需条件，只是可视化入口。