算子调优工具支持上板环境下的性能数据采集和自动解析。

表1 参数说明
参数	描述	是否必选
op	开启算子调优。	是
--application	配置为运行环境上的指定可执行文件，可配置为绝对路径或者相对路径。说明：不建议配置其他用户目录或其他用户可写目录下的AI任务，避免提权风险。不建议配置删除文件或目录、修改密码、提权命令等有安全风险的高危操作。	是，二选一
--config	配置为输入算子二进制文件*.o的json文件，可配置为绝对路径或者相对路径。具体可参考json配置文件说明。	是，二选一
--kernel-name	指定要采集的算子名称，如果不指定，则只对程序运行过程中调度的第一个算子进行采集。需与--application配合使用，限制长度为1024，仅支持[A-Za-z0-9_]+的格式。	否
--aic-metrics	使能算子性能指标采集。支持以下性能指标采集项，默认全部采集。 ArithmeticUtilization L2Cache Memory MemoryL0 MemoryUB PipeUtilization ResourceConflictRatio 可选其中的一项或多项，选多项时用英文逗号隔开，例如：--aic-metrics=Memory,MemoryL0。	否
--output	收集到的性能数据的存放路径，默认在当前目录下保存性能数据。	否
--help	输出帮助信息。	否

算子上板调优可以通过以下两种方式执行：

基于可执行文件

示例一：

msprof op --application=./add_custom_npu

示例二：

msprof op --application=./add_custom_npu --aic-metrics=<select_metrics> --output=./output_data

基于输入算子二进制文件*.o的配置文件.json

msprof op --config=./add_test.json --aic-metrics=<select_metrics> --output=./output_data

命令完成后，会在默认路径或指定的“--output”目录下生成以“OPPROF_{timestamp}_XXX”命名的文件夹，在“--aic-metrics”全部开启时，结构示例如下：

OPPROF_20231201160906_KXXKOCCWXESVYBYE
├── dump
   ├── DeviceProf1.bin   
   ├── DeviceProf2.bin
   ├── DeviceProf3.bin
   ├── DeviceProf4.bin
   ├── DeviceProf5.bin
   ├── DeviceProf6.bin
   ├── duration.bin
   └── op_basic_info.txt
├── ArithmeticUtilization.csv
├── L2Cache.csv
├── Memory.csv
├── MemoryL0.csv
├── MemoryUB.csv
├── OpBasicInfo.csv
├── PipeUtilization.csv
└── ResourceConflictRatio.csv

dump文件夹：原始的性能数据，用户无需关注。
ArithmeticUtilization.csv：cube和vector类型的指令耗时和占比，可参考ArithmeticUtilization（cube及vector类型指令耗时和占比）。
L2Cache.csv：L2 Cache命中率，可参考L2Cache（L2 Cache命中率）。
Memory.csv：UB/L1/L2/主存储器采集内存读写带宽速率，可参考Memory（内存读写带宽速率）。
MemoryL0.csv：L0A/L0B/L0C采集内存读写带宽速率，可参考MemoryL0（L0读写带宽速率）。
MemoryUB.csv：mte/vector/scalar采集ub读写带宽速率，可参考MemoryUB（ub读写带宽速率）。
PipeUtilization.csv：采集计算单元和搬运单元耗时和占比，可参考PipeUtilization（计算单元和搬运单元耗时占比）。
ResourceConflictRatio.csv：UB上的 bank group、bank conflict和资源冲突在所有指令中的占比，可参考ResourceConflictRatio（资源冲突占比）。
OpBasicInfo.csv：算子基础信息，包含算子名称、block dim和耗时等信息，可参考OpBasicInfo（算子基础信息）。