通过工具生成解析数据

设置环境变量

本工具需要配套Python使用，Python版本支持情况请参见《CANN 软件安装指南》中的“通过命令行方式安装>安装开发环境>安装OS依赖>依赖列表”章节。

在命令行中执行如下命令配置环境变量，需要根据开发套件包的实际安装路径配置。

export install_path=$HOME/Ascend/ascend-toolkit/latest# 软件包安装路径，请根据实际修改
export PATH=/usr/local/python3.7.5/bin:${install_path}/atc/ccec_compiler/bin:${install_path}/atc/bin:$PATH # 如果用户环境存在多个python3版本，则指定使用python3.7.5版本，python3.7.5安装路径请根据实际情况进行替换；同时设置ATC工具可执行文件所在路径

启动工具

表1 参数配置说明（Ascend EP场景）
参数	简写	是否必选	说明
--compile_path	-c	必选	ATC模型转换过程中，算子编译生成的文件目录kernel_meta父路径。
--report_path	-p	必选	Device侧（运行环境）日志回传到Host侧（本地环境）的落盘路径下的时间戳路径。具体回传方法请参考《日志参考》中的“msnpureport工具使用指南”。
--output	-out	可选	AI Core Error生成的报告文件路径。不填写默认为当前路径。

表2 参数配置说明（Ascend RC场景）
参数	简写	是否必选	说明
--compile_path	-c	必选	ATC模型转换过程中，算子编译生成的文件目录kernel_meta父路径。
--report_path	-p	必选	运行环境的“/var/log/npu/”路径下，需要执行scp -r命令将该路径下的日志文件拷贝到开发环境。
--output	-out	可选	AI Core Error生成的报告文件路径。不填写默认为当前路径。

进入脚本所在路径，通过命令行运行脚本启动AI Core Error分析工具。

脚本所在路径为“{toolkit包安装路径}/toolkit/tools/msaicerr”。

$ python3 msaicerr.py --compile_path /home/username/Project/aicerror_data/compile_path_infer --report_path 
/home/username/Project/aicerror_data/msnpulog --output local_infer

生成结果文件

AI Core Error Analyzer生成的文件会保存在--output参数指定路径下的“info_xxxx”文件夹中。生成的结果文件请以实际情况为准，以下示例仅供参考。

Ascend EP场景：

├── aicore_error  
│   ├──aicerr_out
│        ├──info_xxxxx  
│             ├──aicerror_xxxxx  //AI Core Error分析工具生成文件   
│                  ├──info.txt    //AI Core Error工具解析结果汇总文件
│                  ├──ts.log    //分析黑匣子中的ts.txt生成的日志文件
│                  ├──te_transdata_xxxx.o  
│                  ├──te_transdata_xxxx.o.txt   //反编译文件
│             ├──collection    //异常算子涉及文件
│                  ├──compile
│                       ├──kernel_meta
│                            ├──cce文件
│                            ├──json文件
│                            ├──loc.json文件
│                            ├──.o文件                            
│                       ├──ge_proto_xxxx_Build.txt
│                  ├──dump    //搬运的dump文件（推理场景，该目录下为空）
│                  ├──log    //Host侧日志
│                  ├──xxxxx   //时间信息 
│                       ├──hisi_logs    //黑匣子日志
│                       ├──slog  //Device侧的slog
│             ├──error.log    //收集了日志目录下所有ERROR级别日志信息
│             ├──imas.log    //GE的IMAS日志
│             ├──README.txt
│   ├──npu_report    
│        ├──xxxxx   //时间信息
│             ├──hisi_logs    //黑匣子日志
│             ├──message    //Device侧操作系统日志
│             ├──slog  
│             ├──stackcore

Ascend RC场景：

├── aicore_error  
│   ├──aicerr_out
│        ├──info_xxxxx  
│             ├──aicerror_xxxxx  //AI Core Error分析工具生成文件   
│                  ├──info.txt    //AI Core Error工具解析结果汇总文件
│                  ├──ts.log    //分析黑匣子中的ts.txt生成的日志文件
│                  ├──te_transdata_xxxx.o  
│                  ├──te_transdata_xxxx.o.txt   //反编译文件
│             ├──collection    //异常算子涉及文件
│                  ├──compile
│                       ├──kernel_meta
│                            ├──cce文件
│                            ├──json文件
│                            ├──loc.json文件
│                            ├──.o文件                            
│                       ├──ge_proto_xxxx_Build.txt
│                  ├──dump    //搬运的dump文件（推理场景，该目录下为空）
│                  ├──log    //Host侧日志
│                  ├──xxxxx   //根据-p参数最后一级目录变化
│                       ├──hisi_logs    //黑匣子日志
│                       ├──slog  
│             ├──error.log    //收集了日志目录下所有ERROR级别日志信息
│             ├──imas.log    //GE的IMAS日志
│             ├──README.txt

父主题： AI Core Error分析工具使用指南（推理）