msprof采集通用命令

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

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

前提条件

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

操作步骤（Ascend EP）

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

方式一（推荐）：在msprof命令末尾添加AI任务执行命令来传入用户程序
```
msprof --output=/home/projects/output /home/projects/MyApp/out/main
```

方式二：配置--application参数添加AI任务执行命令来传入用户程序

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

操作步骤（Ascend RC）

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

方式一（推荐）：在msprof命令末尾添加AI任务执行命令来传入用户程序
```
./msprof --output=/home/projects/output /home/projects/MyApp/out/main
```

方式二：配置--application参数添加AI任务执行命令来传入用户程序

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

参数说明

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

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

父主题： 性能数据采集