---
title: 性能数据采集
description: "采集性能数据。"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/maintenref/troubleshooting/troubleshooting_0516.html
sourcePath: /source/zh/canncommercial/900/maintenref/troubleshooting/troubleshooting_0516.html
indexId: 2205a2a4e78a65c6dacc8b0d3c035e339513310b280c2e986934892ec445276682
---
# 性能数据采集

#### 功能说明

采集性能数据。


#### 产品支持情况

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


#### 命令格式

```
asys profiling -r=aicore
-p
=
time
-d=
deviceId
--output=
./
--aic_metrics=
PipeUtilization
```


#### 参数说明

- r：必选参数，采集类型，类型为字符串枚举，取值如下，支持输入多个枚举类型，以英文逗号分隔。

  - dvpp：采集dvpp的性能数据，例如执行时间、利用率等。
  - aicore：采集AI Core的性能数据，例如cube及vector类型指令耗时和占比、计算单元和搬运单元耗时占比等。
  - os：采集系统内存数据、AI CPU利用率、Ctrl CPU利用率等。
  - memory：采集内存读取速率和带宽数据，包括片上内存、三级缓存等。
  - link：采集带宽数据，例如集合通信带宽、PCIe带宽等。
  - power：采集低功耗数据。
- p：必选参数，采集间隔，单位为秒，最小值为1，最大值30*24*3600。
- d：可选参数，指定待操作的deviceId，仅支持输入单个deviceId，默认值为0。
- output：可选参数，其值作为asys工具的结果输出目录的路径前缀，即最终输出目录为{output}/asys_profiling_result_timestamp。命令行中不带output参数时，输出结果存放在命令行执行目录下。若output指定值为空、无效字符串、或指定路径目录无写权限、或创建目录失败，则asys工具退出执行并报错。
  结果文件的详细解释请参见《性能调优工具(https://www.hiascend.com/document/detail/zh/canncommercial/900/devaids/Profiling/atlasprofiling_16_0144.html)》中的性能数据文件参考。

- aic_metrics：可选参数，AI Core PMU（performance monitor unit，性能监测单元）类型，当采集类型包含aicore时该参数生效。
取值范围：

  - PipeUtilization：默认值，计算单元和搬运单元耗时占比。
  - ArithmeticUtilization：cube及vector类型指令耗时和占比。
  - Memory：内存读写带宽速率。
  - MemoryL0：L0读写带宽速率。
  - MemoryUB：UB读写带宽速率。
  - ResourceConflictRatio：资源冲突占比。
  - L2Cache：L2Cache命中率。
  - MemoryAccess：算子在AI Core上的访存带宽数据量。


#### 使用示例和输出说明

```
# 采集AI Core的性能数据
asys profiling -r=
aicore
-p=
-d=
--output=
./
--aic_metrics=
PipeUtilization
```


命令执行成功后，会提示如下信息，并在{output}/asys_profiling_result_timestamp目录下生成采集结果文件：

```
2025-11-27 20:15:45,141 [ASYS] [INFO]: asys start.
2025-11-27 20:15:45,141 [ASYS] [INFO]:
Start run
: msprof --output=./ --sys-period=10 --sys-devices=0 --ai-core=on --aic-mode=sample-based --aic-metrics=PipeUtilization, please wait about 10 seconds.
2025-11-27 20:16:04,335 [ASYS] [INFO]: Succeeded in running aicore profiling, [INFO] Start profiling....
[INFO] Start export data in PROF_000001_20251127201545157_03062849EPFNHDPB.
......
[INFO] Query all data in PROF_000001_20251127201545157_03062849EPFNHDPB done.
[INFO] Profiling finished.
[INFO] Process profiling data complete.
Data is saved in
/xxx/ascend_system_advisor/asys/asys_profiling_result_20251127201545110/PROF_000001_20251127201545157_03062849EPFNHDPB
2025-11-27 20:16:04,336 [ASYS] [INFO]: profiling task execute finish.
2025-11-27 20:16:04,336 [ASYS] [INFO]: asys finish.
```