---
title: 查询性能数据文件信息
description: "| 产品 | 是否支持 |"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/devaids/Profiling/atlasprofiling_16_0020.html
sourcePath: /source/zh/canncommercial/900/devaids/Profiling/atlasprofiling_16_0020.html
indexId: f0febe4b6f7bd21c63b80d34de1468216ff2132a9da078243316a9bda1f9181f75
---
# 查询性能数据文件信息

#### 产品支持情况

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


#### 功能说明

本功能用于查询性能数据文件信息，确认导出时指定迭代（Iteration ID）/模型（Model ID）。

性能数据解析时自动打印展示性能数据文件信息，故本功能在数据解析中为可选操作，主要用于已解析的历史PROF_XXX目录重新查询性能数据文件信息。


#### 注意事项

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

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


#### 命令格式

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


#### 参数说明


**表1 参数说明**

| 参数 | 说明 | 可选/必选 |
| --- | --- | --- |
| \-\-query | 查询性能数据文件信息。可选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", "\"", "\\\"", "'", "\'", "\\", "\\\\", "%", "\\%", ">", "\\>", "<", "\\<", "\|", "\\\|", "&", "\\&", "$", "\\$", ";", "\\;", "\`", "\\\`"。 | 必选 |


#### 使用示例

指定解析后的性能数据文件目录为/home/profiler_data/PROF_XXX，开启查询性能数据文件信息功能。

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


#### 输出说明

msprof工具的查询功能获取到的信息如表2所示。


**表2 Profiling数据文件信息**

| 字段 | 含义 |
| --- | --- |
| Job Info | 任务名。 |
| Device ID | 设备ID。 |
| Dir Name | 文件夹名称。 |
| Collection Time | 数据采集时间。 |
| Model ID | 模型ID。 |
| Iteration Number | 总迭代数。 |
| Top Time Iteration | 耗时最长的5个迭代。 |
| Rank ID | 集群场景的节点识别ID。 |