Atlas系列硬件: Atlas 200l DK A2 开发者套件; Atlas 200l DK 开发者套件（型号：3000）; 加速模块、加速卡、智能小站、服务器、集群

异构计算架构: CANN社区版; CANN商用版

AI框架: MindSpore; TensorFlow框架模型（社区版）; TensorFlow框架模型（商用版）; PyTorch框架适配

昇腾推理引擎: MindIE

应用使能MindX: MindX DL; MindX Edge; MindX SDK

全流程开发工具: MindStudio

msprof采集通用命令

msprof工具说明

Profiling数据通过可执行文件“msprof”进行数据采集。其功能和安装路径如下。

表1 msprof文件介绍
文件名	功能	路径
msprof	采集Profiling性能数据。	例如： Ascend EP场景下路径为/home/HwHiAiUser/Ascend/ascend-toolkit/latest/tools/profiler/bin Ascend RC场景下路径为/var

前提条件

采集Profiling数据前，需确保编译生成的应用工程或算子工程能在运行环境中正常运行。

使用该方式采集Profiling数据前请确保完成环境搭建。

操作步骤

以运行用户登录Ascend-cann-toolkit开发套件包所在环境。
根据前提条件配置环境变量后执行以下命令，采集性能数据。命令示例如下：
```
msprof --application="/home/projects/MyApp/out/main" --output=/home/projects/output
```

参数说明

表2 常用参数说明
参数	描述	可选/必选
--application	配置为运行环境上AI任务文件，不建议配置其他用户目录下的AI任务，避免提权风险。不建议使用此参数进行有安全风险的高危操作，如删除文件或目录、修改密码、提权命令等。指定推理可执行文件： --application="/home/projects/MyApp/out/main parameter1 parameter2 ..." 指定训练脚本文件： --application="/home/projects/mindspore/scripts/run_standalone_train.sh parameter1 parameter2 ..."	采集全部性能数据、采集AI任务运行时性能数据或采集msproftx数据时，本参数必选。仅采集昇腾AI处理器系统数据时，本参数不选。采集Host侧性能数据时，本参数可选。
--output	收集到的Profiling数据的存放路径，默认为AI任务文件所在目录。	采集全部性能数据或采集AI任务运行时性能数据时，本参数可选。仅采集昇腾AI处理器系统数据时，本参数必选。
--environment	执行Profiling时运行环境上需要的自定义环境变量。不建议使用其他用户的目录覆盖原有环境变量，避免提权风险。配置格式为--environment="${envKey}=${envValue}"或environment="${envKey1}=${envValue1};${envKey2}=${envValue2}"。例如：--environment="LD_LIBRARY_PATH=/home/HwHiAiUser/Ascend/nnrt/latest/lib64"。	可选
--storage-limit	指定落盘目录允许存放的最大文件容量。当Profiling数据文件在磁盘中即将占满本参数设置的最大存储空间（剩余空间<=20MB）或剩余磁盘总空间即将被占满时（总空间剩余<=20MB），则将磁盘内最早的文件进行老化删除处理。单位为MB，取值范围为[200, 4294967296]，默认未配置本参数。参数值配置格式为数值+单位，例如--storage-limit=200MB。未配置本参数时，默认取值为Profiling数据文件存放目录所在磁盘可用空间的90%。昇腾310P AI处理器，支持该参数。昇腾910 AI处理器，支持该参数。	可选
--help	帮助提示参数。	可选

非Ascend RC场景下，msprof会自动解析采集到的Profiling数据，并默认导出迭代数最多的模型ID（Model ID）对应的性能数据。导出数据详细介绍请参见数据解析与导出。

父主题： 性能数据采集（msprof命令行方式）