msprof采集通用命令
- 以Ascend-cann-toolkit开发套件包的运行用户（以HwHiAiUser用户为例）登录运行环境。
- 切换至“msprof”文件所在目录，如/home/HwHiAiUser/Ascend/ascend-toolkit/latest/toolkit/tools/profiler/bin。
- 执行Profiling命令，采集性能数据。
命令行格式如下：
./msprof --application=<app> --output=<dir>
表1 参数说明 参数
描述
可选/必选
--help
帮助提示参数。
可选
--output
收集到的profiling的数据的存放路径，默认为app所在目录。
仅采集system profiling数据时，本参数必选。
可选
--storage-limit
指定落盘目录允许存放的最大文件容量。当Profiling数据文件在磁盘中即将占满本参数设置的最大存储空间（剩余空间<=20MB）或剩余磁盘总空间即将被占满时（总空间剩余<=20MB），则将磁盘内最早的文件进行老化删除处理。
单位为MB，取值范围为[200, 4294967295]，默认未配置本参数。
参数值配置格式为数值+单位，例如--storage-limit=200MB。
未配置本参数时，不开启数据老化功能。
可选
--application
配置为运行环境上app可执行文件所在目录+文件名。
例如：--application=/home/HwHiAiUser/HIAI_PROJECTS/MyAppname/out/main。
如果“application”带参数输入，此时需要使用英文双引号将“application”的参数值括起来，例如--application="main parameters1 parameters2 parameters3 ..."。
不配置本参数表示仅采集system profiling数据。
不建议调用与当前用户不一致的其它用户目录下的AI任务文件，避免提权风险。
必选
--environment
执行Profiling时运行环境上需要的自定义环境变量。配置格式为--environment="${envKey}=${envValue}""${envKey1}=${envValue1};${envKey2}=${envValue2}"。例如：--environment="LD_LIBRARY_PATH=/home/HwHiAiUser/Ascend/nnrt/latest/lib64"。
可选
执行完上述命令后，会在--output目录下生成PROFXXX目录，PROFXXX目录保存Device侧或Host侧的原始Profiling数据以及timeline汇总数据。
生成的Profiling数据目录结构如图1所示。
