Profiling数据导出

在导出Profiling数据前，需要参见Profiling数据解析解析Profiling数据。参见如下步骤导出Profiling数据。

1. 以Ascend-cann-toolkit开发套件包的运行用户登录开发环境。
2. 切换至“msprof.py”脚本所在目录，如/home/HwHiAiUser/Ascend/ascend-toolkit/latest/tools/profiler/profiler_tool/analysis/msprof。
3. 导出Profiling数据。可以导出timeline和summary两类文件，命令行格式如下：
   • 导出timeline数据

     python3 msprof.py export timeline [-h] -dir <dir> [--iteration-id <iteration_id>] [--model-id <model-id>]

     例如：python3 msprof.py export timeline -dir /home/HwHiAiUser/profiler_data/PROF_XXX

   • 导出summary数据

     python3 msprof.py export summary [-h] -dir <dir> [--iteration-id <iteration_id>] [--model-id <model-id>] [--format <export_format>]

     例如：python3 msprof.py export summary -dir /home/HwHiAiUser/profiler_data/PROF_XXX

   表1 导出Profiling数据命令参数说明

   参数名	描述	可选/必选
   -dir, --collection-dir	收集到的Profiling数据目录。须指定为PROF_XXX目录、PROF_XXX目录下的device_{id}目录（生成具体设备数据）或PROF_XXX目录的父目录，例如：/home/HwHiAiUser/profiler_data/PROF_XXX、/home/HwHiAiUser/profiler_data/PROF_XXX/device_{id}或/home/HwHiAiUser/profiler_data/。	必选
   --iteration-id	某轮迭代的ID，默认值为1。	可选
   --model-id	模型ID。 单算子场景和仅执行采集昇腾AI处理器系统数据场景，不支持--model-id参数。	可选
   --format	summary数据文件的导出格式，支持csv和json两种格式，默认值为csv。 仅配置summary参数时支持。 本文中summary文件介绍均以csv文件为例。	可选
   -h，--help	显示帮助信息，仅在获取使用方式时使用。	可选

4. 执行完上述命令后，会在collection-dir目录下的PROF_XXX目录的device_{id}目录下生成timeline和summary目录。

   生成的Profiling数据目录结构如图1所示。

   图1 Profiling数据目录结构（仅为示例）
   
   

   • 多Device场景下，若启动单Profiling采集进程，则仅生成一个PROF_XXX目录，若启动多Profiling采集进程则生成多个PROF_XXX目录，其中Device目录在PROF_XXX目录下生成，每个PROF_XXX目录下生成多少个Device目录与用户实际操作有关，不影响Profiling分析。
   • timeline和summary文件夹下分别保存timeline和summary数据文件，文件名格式为{name}_{device_id}_{model_id}_{iter_id}.json和{name}_{device_id}_{model_id}_{iter_id}.csv。其中{device_id}表示设备ID，{model_id}表示模型ID，{iter_id}表示某轮迭代的ID。详细数据介绍请参见Profiling数据说明。
   • 单算子场景和仅执行采集昇腾AI处理器系统数据时，生成的文件名称格式为{name}_{device_id}_{iter_id}.json和{name}_{device_id}_{iter_id}.csv。
   • timeline和summary目录中的文件是根据采集的实际Profiling数据进行生成，如果实际的Profiling数据没有相关的数据文件，就不会导出对应的timeline和summary数据。
   • 使用export命令能直接从已解析的Profiling数据中导出数据文件。当Profiling数据未解析时，单独执行export命令也能进行解析Profiling数据并导出数据文件。
   • 生成的json文件可以通过以下方式打开查看：在Chrome浏览器中输入“chrome://tracing”地址，然后将json文件拖到空白处打开。下文中文件介绍均使用此种形式。关于chrome trace的格式，可参考chrome trace介绍。
   • 生成的summary数据文件中某些字段值为“N/A”时，表示此时该值不存在。
   • 生成的summary数据文件使用excel打开时，会出现字段值为科学计数的情况，例如“1.00159E+12”。此时可选中该单元格，然后“右键>设置单元格格式”，在弹出的对话框中“数字”标签下选择“数值”，单击“确定”就能正常显示。
   • 导出的数据中涉及到的时间节点（非Timestamp）为系统单调时间只与系统有关，非真实时间。