我要评分

文档获取效率

文档正确性

内容完整性

文档易理解

在线提单

论坛求助

昇腾小AI

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/HwHiAiUser/HIAI_PROJECTS/MyAppname/out/main --output=/home/HwHiAiUser
```

参数说明

表2 常用参数说明
参数	描述	可选/必选
--application	配置为运行环境上AI任务文件。不建议配置其他用户目录或其他用户可写目录下的AI任务，避免提权风险。不建议配置删除文件或目录、修改密码、提权命令等有安全风险的高危操作。说明：推理环境App可执行文件所在目录+文件名，例如：--application=/home/HwHiAiUser/HIAI_PROJECTS/MyAppname/out/main。训练环境训练脚本目录+文件名，例如：--application=/home/HwHiAiUser/train/mindspore/scripts/run_standalone_train.sh。如果“application”带参数输入，此时需要使用英文双引号将“application”的参数值括起来，例如--application="main parameters1 parameters2 parameters3 ..."。	采集全部性能数据、采集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数据文件保存至磁盘时的存储空间上限。当累计存放的Profiling数据文件大小接近参数设置值（<=20MB）或数据存放目录所在磁盘的可用空间即将不足（<=20MB）时，除特定的Profiling数据文件外，最早保存的Profiling数据文件将被删除，以保证新生成的数据文件可以循环覆盖保存。单位为MB，参数值配置格式为数值+单位，例如--storage-limit=200MB，有效取值范围为[200, 4294967296]。未配置本参数时，默认取值为Profiling数据文件存放目录所在磁盘可用空间的90%。 Atlas 推理系列产品，支持该参数。 Atlas 训练系列产品，支持该参数。	可选
--python-path	指定解析使用的Python解释器路径，要求Python3.7.5及以上版本。如果是高权限执行则禁止指定低权限路径。	可选
--help	帮助提示参数。	可选

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

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