4f9d76b9创建于 2025年11月3日历史提交

算子调试调优

调试定位（AI Core算子）

算子运行过程中，如果出现算子执行失败、精度异常等问题，可以打印各阶段信息，如Kernel中间结果，进行问题分析和定位。

以AddExample算子为例，常见调试方法如下：

printf

该接口支持打印Scalar类型数据，如整数、字符、布尔型等，详细介绍请参见《Ascend C API》中“算子调测API > printf”。

blockLength_ = tilingData->totalLength / AscendC::GetBlockNum();
tileNum_ = tilingData->tileNum;
tileLength_ = blockLength_ / tileNum_ / BUFFER_NUM;
// 打印当前核计算Block长度
AscendC::PRINTF("Tiling blockLength is %llu\n", blockLength_);

DumpTensor

该接口支持Dump指定Tensor的内容，同时支持打印自定义附加信息，比如当前行号等，详细介绍请参见《Ascend C API》中“算子调测API > DumpTensor”。
```
AscendC::LocalTensor<T> zLocal = outputQueueZ.DeQue<T>();
// 打印zLocal Tensor信息
DumpTensor(zLocal, 0, 128);
AscendC::DataCopy(outputGMZ[progress * tileLength_], zLocal, tileLength_);
```

对于复杂场景的问题定位，比如算子卡死、GM/UB访问越界等场景，可以采取单步调试的方式，具体操作请参见msDebug算子调试工具。

调试定位（AI CPU算子）

算子运行过程中，如果出现算子执行失败、精度异常等问题，可以打印各阶段信息，如Kernel中间结果，进行问题分析和定位。

以AddExample算子为例，常见调试方法如下：

KERNEL_LOG宏

可通过如下宏打印算子执行过程中的日志信息，包括DEBUG、INFO、WARN、ERROR级别日志。

KERNEL_LOG_DEBUG(fmt, …)      // fmt参数表示格式控制字符串
KERNEL_LOG_INFO(fmt, …)
KERNEL_LOG_WARN(fmt, …)
KERNEL_LOG_ERROR(fmt, …)      // 默认打印ERROR级别日志

如需打印非ERROR级别日志，需提前配置环境变量ASCEND_GLOBAL_LOG_LEVEL，具体使用方法参见《环境变量参考》。

打印示例如下：

Tensor* input0 = ctx.Input(kFirstInputIndex);
Tensor* input1 = ctx.Input(kSecondInputIndex);
Tensor* output = ctx.Output(0);

if (input0 == nullptr || input1 == nullptr || output == nullptr) {
  // 打印错误信息
  KERNEL_LOG_ERROR("Invalid argument");
  return kParamInvalid;
}

int64_t num_elements = input0->NumElements();
// 打印输入元素个数
KERNEL_LOG_INFO("Num of elements is %ld", data_size);

性能调优

算子运行过程中，如果出现执行精度下降、内存占用异常等问题，可通过msProf性能分析工具分析算子各运行阶段指标数据（如吞吐率、内容占用、耗时等），从而确定问题根源，并针对性地优化。

本章以AddExample自定义算子为例，通过采集算子上板运行时各项流水指标分析算子Bound场景。

前提条件。

完成算子开发和编译后，假设采用aclnn接口方式调用，生成的算子可执行文件（test_aclnn_add_example）所在目录为本项目examples/add_example/examples/build/bin/。
采集性能数据。

进入算子可执行文件所在目录，执行如下命令：
```
msprof op ./test_aclnn_add_example
```
采集结果在本项目examples/add_example/examples/build/bin/OPPROF_*目录，采集完成后打印如下信息：
```
Op Name: AddExample_a1532827238e1555db7b997c7bce2928_high_performance_1
Op Type: vector             
Task Duration(us): 97.861954 
Block Dim: 8
Mix Block Dim:
Device Id: 0
Pid: 2776181
Current Freq: 1800
Rated Freq: 1800
```
其中Task Duration是当前算子Kernel耗时，Block Dim是当前算子执行核数。

算子各项流水详细指标可关注OPPROF_*下ArithmeticUtilization文件，包含了当前各项流水的占比，具体介绍参见msProf中”性能数据文件 > msprof op > ArithmeticUtilization（cube及vector类型指令耗时和占比）“章节。