查询性能数据文件信息

本功能用于查询性能数据文件信息，性能数据文件信息中包含迭代（Iteration ID）/模型（Model ID）。

执行查询操作前需要调用import命令解析Profiling数据，否则查询结果无意义。

python3 msprof.py query -dir <dir>

表1 查询性能数据信息命令参数说明
参数名	描述	可选/必选
-dir或--collection-dir	收集到的性能数据目录。须指定为PROF_XXX目录或PROF_XXX目录的父目录，例如： /home/profiler_data/PROF_XXX	必选
--data-type	数据类型。用于MindStudio对接，用户无需配置。取值为： 0：集群场景，可查询当前数据是否为集群场景采集的数据。 1：迭代轨迹数据，每轮迭代的详细数据，包括FP/BP计算时间、迭代更新拖尾和迭代间隙。 2：计算量，AI Core上的浮点运算数。 3：数据准备，训练数据发送至Device以及Device侧读取训练数据。 4：并行度调优建议。 5：并行度数据，主要展示纯通信耗时和计算耗时。 6：通信慢卡慢链路数据及优化建议。 7：通信矩阵数据及优化建议。 8：Host侧系统及进程的CPU、内存的性能指标。 9：通信耗时使能关键路径分析。 10：通信矩阵使能关键路径分析。	可选
--id	集群场景时指定集群节点的Rank ID，非集群场景指定设备ID。用于MindStudio对接，用户无需配置。	可选
--model-id	模型ID。用于MindStudio对接，用户无需配置。	可选
--iteration-id	指定以Graph为粒度统计的迭代ID（每个Graph执行一次，Iteration ID加1，当一个脚本被编译为多个Graph时，该ID与脚本层面的Step ID不一致）。默认值为1。用于MindStudio对接，用户无需配置。	可选
-h或--help	显示帮助信息，仅在获取使用方式时使用。	可选

登录安装了Toolkit包的环境。
切换至msprof.py脚本所在目录。
${INSTALL_DIR}/tools/profiler/profiler_tool/analysis/msprof，${INSTALL_DIR}请替换为CANN软件安装后文件存储路径。以root用户安装为例，安装后文件默认存储路径为：/usr/local/Ascend/cann。

查询性能数据信息，命令行格式如下。

python3 msprof.py query -dir /home/profiler_data/PROF_XXX

执行查询性能数据信息命令后会打印显示结果。

msprof工具的查询功能获取到的信息如表2所示。

父主题： 使用msprof.py脚本解析、查询与导出性能数据