---
title: 解析性能数据
description: "| 产品 | 是否支持 |"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/devaids/Profiling/atlasprofiling_16_0019.html
sourcePath: /source/zh/canncommercial/900/devaids/Profiling/atlasprofiling_16_0019.html
indexId: b395776daec29df7f75a887479286e8a9df8d4c2053f7cef457fee1cd103345475
---
# 解析性能数据

#### 产品支持情况

| 产品 | 是否支持 |
| --- | --- |
| Atlas 350 加速卡 | √ |
| Atlas A3 训练系列产品 / Atlas A3 推理系列产品 | √ |
| Atlas A2 训练系列产品 / Atlas A2 推理系列产品 | √ |
| Atlas 200I/500 A2 推理产品 | √ |
| Atlas 推理系列产品 | √ |
| Atlas 训练系列产品 | √ |


#### 功能说明

该功能只会进行性能数据解析，不会导出性能数据文件，导出性能数据文件功能请参见解析并导出性能数据。

一般情况下，解析性能数据功能不需要单独使用，主要有如下两种使用场景：- 对于性能数据文件解析失败的场景（例如：当存在首次解析由于某些原因导致解析失败，残留文件时），可以使用msprof--parse功能重新解析后，再次执行msprof --export。
- 对于需要指定--iteration-id和--model-id参数进行msprof --export导出时，可以先执行msprof--parse解析并打印迭代（Iteration ID）/模型（Model ID）后，选择需要的Iteration ID和Model ID进行导出。


#### 注意事项

- 请先完成  使用前准备
。
- 请先完成性能数据采集。
- 以下产品不支持在设备上直接解析，需要将采集到的PROF_XXX目录拷贝到安装了Toolkit包的环境下进行解析：

  - Atlas 200I/500 A2 推理产品的Ascend RC场景


#### 命令格式

```
msprof
--parse
=
on
--output
=
<dir>
```


#### 参数说明


**表1 参数说明**

| 参数 | 说明 | 可选/必选 |
| --- | --- | --- |
| \-\-parse | 解析原始性能数据文件。可选on或off，默认值为off。 on：表示开启 off：表示关闭 | 必选 |
| \-\-output | 原始性能数据文件目录。须指定为PROF\_XXX目录或PROF\_XXX目录的父目录，例如：/home/profiler\_data/PROF\_XXX。 路径中不能包含特殊字符："\n", "\\n", "\f", "\\f", "\r", "\\r", "\b", "\\b", "\t", "\\t", "\v", "\\v", "\u007F", "\\u007F", "\"", "\\\"", "'", "\'", "\\", "\\\\", "%", "\\%", ">", "\\>", "<", "\\<", "\|", "\\\|", "&", "\\&", "$", "\\$", ";", "\\;", "\`", "\\\`"。 | 必选 |
| \-\-python\-path | 指定解析使用的Python解释器路径，要求Python 3.7.5及以上版本。 当环境中的默认Python版本小于3.7.5时，需要使用该参数配置为大于3.7.5及以上的Python版本。 如果是高权限用户执行则禁止指定低权限路径。 | 可选 |


#### 使用示例

解释原始性能数据文件，指定/home/profiler_data/PROF_XXX为原始性能数据文件目录。

```
msprof --parse=on --output=/home/profiler_data/PROF_XXX
```


#### 输出说明

执行完上述命令，会打印展示性能数据文件信息并在PROF_XXX的device_{id}和host目录下生成sqlite目录，sqlite目录下会有.db文件生成。

需要继续导出最终结果的timeline数据或db文件，可执行解析并导出性能数据。