导出性能数据

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

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

    • 导出timeline数据
      python3 msprof.py export timeline [-h] -dir <dir> [--iteration-id <iteration_id>] [--model-id <model-id>] [--iteration-count <iteration_count>] [--clear]

      例如：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>] [--iteration-count <iteration_count>] [--format <export_format>] [--clear]

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

    表1 导出性能数据命令参数说明

    参数名

    描述

    可选/必选

    -dir, --collection-dir

    收集到的性能数据目录。须指定为PROF_XXX目录，例如：

    /home/HwHiAiUser/profiler_data/PROF_XXX

    必选

    --iteration-id

    指定以Graph为粒度统计的迭代ID（每个Graph执行一次，Iteration ID加1，当一个脚本被编译为多个Graph时，该ID与脚本层面的Step ID不一致）。默认值为1。

    可选

    --model-id

    模型ID。

    可选

    --iteration-count

    导出迭代的个数。

    可选

    --format

    summary数据文件的导出格式，支持csv和json两种格式，默认值为csv。

    仅配置summary参数时支持。

    本文中summary文件介绍均以csv文件为例。

    可选

    --clear

    数据精简模式，开启后将在导出性能数据后删除PROF_XXX目录下的原始性能数据（sqlite和data目录），以节省存储空间。可选on或off，默认值为off。

    可选

    -h，--help

    显示帮助信息，仅在获取使用方式时使用。

    可选

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

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

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

    导出的性能数据详细介绍请参见性能数据文件参考。

    • 多Device场景下，若启动单采集进程，则仅生成一个PROF_XXX目录，若启动多采集进程则生成多个PROF_XXX目录，其中Device目录在PROF_XXX目录下生成，每个PROF_XXX目录下生成多少个Device目录与用户实际操作有关，不影响性能数据分析。
    • timeline和summary目录中的文件是根据采集的实际性能数据进行生成，如果实际的性能数据没有相关的数据文件，就不会导出对应的timeline和summary数据。
    • 使用export命令能直接从已解析的性能数据中导出数据文件。当性能数据未解析时，单独执行export命令也能进行解析性能数据并导出数据文件。

父主题： 性能数据解析与导出（msprof.py脚本）