msprof采集通用命令

msprof命令行工具提供了AI任务运行性能数据、昇腾AI处理器系统数据等性能数据的采集和解析能力。

其中，msprof采集通用命令是性能数据采集的基础，用于提供性能数据采集时的基本信息，包括参数含义帮助、指定待采集项目AI任务文件、采集到性能数据的存放路径、自定义环境变量、采集到性能数据允许存放的文件大小等。

前提条件

请确保AI工程能在运行环境中正常运行。
请确保完成使用前准备。

操作步骤（Ascend EP）

登录Ascend-cann-toolkit开发套件包所在环境，执行以下命令采集性能数据。命令示例如下：

msprof --application="/home/projects/MyApp/out/main" --output=/home/projects/output

操作步骤（Ascend RC）

登录运行环境，进入msprof工具所在目录“/var”，执行以下命令采集性能数据。命令示例如下：

./msprof --application="/home/projects/MyApp/out/main" --output=/home/projects/output

参数说明

表1 通用参数说明
参数	描述	支持的型号
--application	配置为运行环境上AI任务文件。不建议配置其他用户目录或其他用户可写目录下的AI任务，避免提权风险；不建议配置删除文件或目录、修改密码、提权命令等有安全风险的高危操作；应避免使用pmupload作为程序名称。采集全部性能数据、采集AI任务运行时性能数据或采集msproftx数据时，本参数必选。采集昇腾AI处理器系统数据时，本参数可选。采集Host侧系统数据时，本参数可选。配置示例：指定推理可执行文件： --application="/home/projects/MyApp/out/main parameter1 parameter2 ..." 指定训练脚本文件： --application="/home/projects/mindspore/scripts/run_standalone_train.sh parameter1 parameter2 ..."	Atlas 200/300/500 推理产品 Atlas 200I/500 A2推理产品 Atlas 推理系列产品 Atlas 训练系列产品 Atlas A2训练系列产品/Atlas 800I A2推理产品
--output	收集到的性能数据的存放路径，默认为AI任务文件所在目录。采集全部性能数据或采集AI任务运行时性能数据时，本参数可选。仅采集昇腾AI处理器系统数据时，本参数必选。该参数优先级高于ASCEND_WORK_PATH，具体请参考《环境变量参考》。路径中不能包含特殊字符："\n", "\f", "\r", "\b", "\t", "\v", "\u007F"，不支持软链接。	Atlas 200/300/500 推理产品 Atlas 200I/500 A2推理产品 Atlas 推理系列产品 Atlas 训练系列产品 Atlas A2训练系列产品/Atlas 800I A2推理产品
--type	设置性能数据解析结果文件格式，即可以选择msprof命令行执行采集后自动解析的结果文件格式，取值为： text：表示解析为.json和.csv格式的文件，详见性能数据文件参考。 db：表示解析为一个汇总所有性能数据的.db格式文件（msprof_时间戳.db），使用Ascend Insight工具展示。当前该格式数据与text参数解析的数据信息量存在差异，建议使用text方式采集。暂不支持MindSpore场景的.db格式数据解析。默认为text。	Atlas 200/300/500 推理产品，不支持系统数据 Atlas 200I/500 A2推理产品 Atlas 推理系列产品 Atlas 训练系列产品 Atlas A2训练系列产品/Atlas 800I A2推理产品
--environment	执行采集时运行环境上需要的自定义环境变量。可选。不建议使用其他用户的目录覆盖原有环境变量，避免提权风险。配置格式为--environment="${envKey}=${envValue}"或environment="${envKey1}=${envValue1};${envKey2}=${envValue2}"。例如：--environment="LD_LIBRARY_PATH=/home/HwHiAiUser/Ascend/nnrt/latest/home/HwHiAiUser/Ascend/nnae/latest/lib64"。	Atlas 200/300/500 推理产品 Atlas 200I/500 A2推理产品 Atlas 推理系列产品 Atlas 训练系列产品 Atlas A2训练系列产品/Atlas 800I A2推理产品
--storage-limit	指定落盘目录允许存放的最大文件容量。当性能数据文件在磁盘中即将占满本参数设置的最大存储空间或剩余磁盘总空间即将被占满时（总空间剩余<=20MB），则将磁盘内最早的文件进行老化删除处理。可选。取值范围为[200, 4294967295]，单位为MB，例如--storage-limit=200MB，默认未配置本参数。未配置本参数时，默认取值为性能数据文件存放目录所在磁盘可用空间的90%。	Atlas 200I/500 A2推理产品 Atlas 推理系列产品 Atlas 训练系列产品 Atlas A2训练系列产品/Atlas 800I A2推理产品
--python-path	指定解析使用的Python解释器路径，要求Python3.7.5及以上版本。可选。如果是高权限用户执行则禁止指定低权限路径。	Atlas 200/300/500 推理产品 Atlas 200I/500 A2推理产品 Atlas 推理系列产品 Atlas 训练系列产品 Atlas A2训练系列产品/Atlas 800I A2推理产品
--help	帮助提示参数。可选。	Atlas 200/300/500 推理产品 Atlas 200I/500 A2推理产品 Atlas 推理系列产品 Atlas 训练系列产品 Atlas A2训练系列产品/Atlas 800I A2推理产品

默认情况下，msprof会自动解析采集到的性能数据。导出数据详细操作请参见性能数据解析与导出（msprof命令）。

父主题： 性能数据采集