我要评分

文档获取效率

文档正确性

内容完整性

文档易理解

在线提单

论坛求助

昇腾小AI

msprof采集通用命令

msprof工具说明

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

表1 msprof文件介绍
文件名	功能	路径
msprof	采集Profiling性能数据。	例如： Ascend RC场景下路径为/var

前提条件

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

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

操作步骤

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

参数说明

表2 常用参数说明
参数	描述	可选/必选
--application	配置为运行环境上AI任务文件，不建议配置其他用户目录下的AI任务，避免提权风险。不建议使用此参数进行有安全风险的高危操作，如删除文件或目录、修改密码、提权命令等。说明：推理环境App可执行文件所在目录+文件名，例如：--application=/home/HwHiAiUser/HIAI_PROJECTS/MyAppname/out/main。如果“application”带参数输入，此时需要使用英文双引号将“application”的参数值括起来，例如--application="main parameters1 parameters2 parameters3 ..."。	采集全部性能数据、采集AI任务运行时性能数据或采集msproftx数据时，本参数必选。仅采集昇腾AI处理器系统数据时，本参数不选。
--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%。	可选
--help	帮助提示参数。	可选

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

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