性能数据采集

功能说明
采集性能数据。

产品支持情况

产品	是否支持
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、aicore，支持输入多个枚举类型，以英文逗号分隔。
- p：必选参数，采集间隔，单位为秒，最小值为1，最大值30*24*3600。
- d：必选参数，指定待操作的deviceId，支持输入多个deviceId，以英文逗号分隔。
- output：必选参数，其值作为asys工具的结果输出目录的路径前缀，即最终输出目录为{output}。若output指定值为空、无效字符串、或指定路径目录无写权限、或创建目录失败，则asys工具退出执行并报错。
  结果文件的详细解释请参见《性能调优工具用户指南》中的性能数据文件参考。
- aic_metrics：可选参数，AI Core PMU（performance monitor unit，性能监测单元）类型，当采集类型包含aicore时该参数生效。
  取值范围：
  - PipeUtilization：默认值，计算单元和搬运单元耗时占比。
  - ArithmeticUtilization：cube及vector类型指令耗时和占比。
  - Memory：内存读写带宽速率。
  - MemoryL0：L0读写带宽速率。
  - MemoryUB：UB读写带宽速率。
  - ResourceConflictRatio：资源冲突占比。
  - L2Cache：L2Cache命中率。

使用示例及输出说明

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

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

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 /usr/local/Ascend/8.5.0/tools/ascend_system_advisor/asys/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.

父主题： asys工具使用指导