niu-guoliangupdate: 更新文件 smartperf-guidelines.md

d12594ba创建于 2025年8月13日历史提交

SmartPerf Device性能工具使用指导

工具简介

SmartPerf Device是一款基于系统开发的性能功耗测试工具，操作简单易用。该工具可以监测性能、功耗相关指标，包括FPS、CPU、GPU、RAM、Temp等，通过量化的指标项了解应用、整机性能状况。

在开发过程中，会使用到有屏或无屏设备，对此SmartPerf Device提供了两种方式：分别是Device-hap端和Device-daemon端。Device-hap端适用于有屏设备，支持可视化操作。测试时是通过悬浮窗的开始和暂停来实时展示性能指标数据，保存后可生成数据报告，在报告中可分析各指标数据详情。Device-daemon端支持shell命令行方式，同时适用于有屏和无屏设备。

指标说明

CPU：每秒读取一次设备节点下CPU大中小核的频点和各核使用率，衡量应用占用CPU资源的情况，占用过多的CPU资源会导致芯片发烫。
GPU：每秒读取一次设备节点下GPU的频点和负载信息，衡量应用占用GPU资源的情况，当GPU占用过多时，会导致性能下降，应用程序的运行速度变慢。
FPS：应用界面每秒刷新次数，衡量应用画面的流畅度，FPS越高通常表示图像流畅度越好，用户体验也越好。
TEMP：每秒读取一次设备节点下GPU温度、系统芯片温度信息。
RAM：每秒读取一次应用进程的实际物理内存，衡量应用的内存占比情况。
snapshot：每2秒截取一张应用界面截图。

实现原理

下图展示了SmartPerf Device工具的主要功能组成。Device-hap端设置好采集项和采集参数后，启动应用，FPS、RAM、Trace等指标通过消息发送给Device-daemon端，Device-daemon端进行数据采集、持久化和数据分析，将生成的报告回传给Device-hap端，Device-hap端进行可视化显示。

图片说明

约束与限制

Device-daemon端、Device-hap端在API 9版本开始预置使用。
Device-daemon端执行需连接硬件设备，Device-hap端需在有屏幕设备使用。
Device-daemon端执行前需完成hdc环境配置。

SmartPerf Device-hap端

下面的操作步骤和界面内容以RK3568设备为例。

获取应用列表

点击设备上"SmartPerf Device-hap端"应用图标，进入"首页"，点击"请选择一个应用"，在应用列表页选择需要测试的应用。

图片说明

设置采集参数

应用选择完成后回到开始测试页面，根据实际业务需要，配置"测试指标"。同时，可修改测试名称（测试名称包含测试的应用名称和测试时间，会呈现在报告列表中），是否抓取trace，选择是否开启截图。配置完成后，点击底部"开始测试"按钮。

悬浮窗控制采集

点击悬浮窗"start"开始采集，点击悬浮窗"计时器"（如下图中00:07）暂停采集。再次点击"计时器"，继续开始采集。双击"计时器"，实时展示采集数据。长按"计时器"，结束采集。
整个过程中，可拖动悬浮框调整悬浮框位置。

图片说明

查看报告

点击"报告"，查看测试报告列表。点击项目，进入报告详情页，查看测试指标项详情。

图片说明

SmartPerf Device-daemon端

采集前提

进入shell
```
C:\Users\issusser>hdc shell
$
```

拉起和查看daemon进程

C:\Users\issusser>hdc shell
// 拉起daemon进程
$ SP_daemon 
// 查看daemon进程是否存在
$ ps -ef | grep SP_daemon
shell          1584     1 0 21:50:05 ?     00:00:00 SP_daemon
shell          1595  1574 3 21:51:02 pts/0 00:00:00 grep SP_daemon
$

执行和查看帮助命令

$ SP_daemon --help
OpenHarmony performance testing tool SmartPerf command-line version
 Usage: SP_daemon [options] [arguments]
  
 options:
  -N              set the collection times(default value is 0) range[1,2147483647], for example: -N 10
  -PKG            set package name, must add, for example: -PKG ohos.samples.ecg
  -PID            set process pid, must add, for example: -PID 3568
  -threads        get threads, must add -PID or -PKG for example:
                  -threads -PID 3568 or -threads -PKG ohos.samples.ecg
  -fds            get file descriptor, must add -PID or -PKG for example:
                  -fds -PID 3568 or -fds -PKG ohos.samples.ecg
  -c              get device CPU frequency and CPU usage, process CPU usage and CPU load ..
  -g              get device GPU frequency and GPU load
  -f              get app refresh fps(frames per second) and fps jitters and refreshrate
  -profilerfps    get refresh fps and timestamp
  -sections       set collection time period(using with profilerfps)
  -t              get remaining battery power and temperature..
  -p              get battery power consumption and voltage(Not supported by some devices)
  -print          start mode print log
  -r              get process memory and total memory
  -snapshot       get screen capture
  -net            get uplink and downlink traffic
  -start          collection start command
  -stop           collection stop command
  -VIEW           set layler, for example: -VIEW DisplayNode
  -OUT            set csv output path.
  -d              get device DDR information
  -screen         get screen resolution
  -deviceinfo     get device information
  -server         start a process to listen to the socket message of the start and stop commands
  -clear          clear the process ID
  -ohtestfps      used by the validator to obtain the fps, the collection times can be set
  -editorServer   start a process to listen to the socket message of the editor
  -recordcapacity get the battery level difference
  --version       get version
  --help          get help
  -editor         scenario-based collection identifier, parameter configuration items can be added later
  responseTime   get the page response delay after an application is operated
  completeTime   get the page completion delay after an application is operated
  fpsohtest      used by the validator to obtain the fps
  example1:
  SP_daemon -N 20 -c -g -t -p -r -net -snapshot -d
  SP_daemon -N 20 -PKG ohos.samples.ecg -c -g -t -p -f -r -net -snapshot -d
  SP_daemon -start -c
  SP_daemon -stop
  example2: These parameters need to be used separately
  SP_daemon -screen
  SP_daemon -deviceinfo
  SP_daemon -server
  SP_daemon -clear
  SP_daemon -ohtestfps 10
  SP_daemon -editorServer
  SP_daemon -recordcapacity
  example3: These parameters need to be used separately
  SP_daemon -editor responseTime ohos.samples.ecg app name
  SP_daemon -editor completeTime ohos.samples.ecg app name
  SP_daemon -editor fpsohtest
  
  
  
  command exec finished!
 $

基础采集

基础采集主要采集整机或者应用的gpu、fps、CPU、DDR、内存等，支持秒级采集和启停采集，并将采集的结果写入data.csv。

1. 秒级采集

命令参数	必选	说明
-N	是	设置采集次数，一秒采集一次。
-PKG	否	设置包名。
-PID	否	设置进程ID或者线程ID。
-threads	否	采集应用子线程数量。
-fds	否	采集应用文件描述符，仅支持root用户采集。
-c	否	采集cpu的频点和使用率。设置应用包名时，采集整机和应用CPU信息。不设置应用包名时，采集整机CPU信息。
-ci	否	采集cpu的指令数。设置应用包名时，采集整机和应用CPU指令数。不设置应用包名时，采集整机CPU指令数。
-g	否	采集gpu的频点和负载信息。
-f	否	采集指定应用的fps以及屏幕刷新率，必须设置应用包名。
-t	否	采集GPU温度、系统芯片温度。
-r	否	采集内存。设置应用包名时，采集整机和应用内存信息。不设置应用包名时，采集整机内存信息。
-snapshot	否	屏幕截图。
-net	否	采集网络速率。
-VIEW	否	设置图层，需要先获取应用图层名。
-d	否	采集DDR。
-sections	否	设置分段采集。

设置包名并采集1次应用的线程数量

  $ SP_daemon -N 1 -PKG ohos.samples.ecg -threads

  order:0 timestamp=1741415592481
  order:1 threadsNum=18847:113|
  order:2 tids=18847:43411 43409 43350 43236 25783 25622 25384 25381 19423 19170 19167 19166 19165 19163 19162 19159 19157 19156 19154 19153 19152 19151 19150 19149 19147 19146 19145 19142 19141 19140 19139 19136 19135 19134 19120 19112 19111 19088 19083 19081 19077 19076 19075 19074 19073 19072 19071 19070 19055 19044 19040 19039 19034 19033 19032 19031 19030 19029 19028 19027 19019 19017 19016 19015 19014 19013 19012 19011 19009 19007 19006 19005 19004 19003 19001 19000 18999 18998 18997 18996 18995 18994 18993 18992 18991 18990 18989 18988 18987 18986 18985 18984 18983 18982 18981 18980 18977 18974 18946 18942 18936 18934         18933 18931 18930 18929 18928 18927 18926 18925 18924 18923 18847|

  command exec finished!
  $

采集2次整机CPU大中小核频率、各核使用率

  $ SP_daemon -N 2 -c

  order:0 timestamp=1501839064260
  order:1 TotalcpuUsage=0.502513
  order:2 TotalcpuidleUsage=99.497487
  order:3 TotalcpuioWaitUsage=0.000000
  order:4 TotalcpuirqUsage=0.000000
  order:5 TotalcpuniceUsage=0.000000
  order:6 TotalcpusoftIrqUsage=0.000000
  order:7 TotalcpusystemUsage=0.251256
  order:8 TotalcpuuserUsage=0.251256
  order:9 cpu0Frequency=1992000
  order:10 cpu0Usage=1.000000
  order:11 cpu0idleUsage=99.000000
  order:12 cpu0ioWaitUsage=0.000000
  order:13 cpu0irqUsage=0.000000
  order:14 cpu0niceUsage=0.000000
  order:15 cpu0softIrqUsage=0.000000
  order:16 cpu0systemUsage=0.000000
  order:17 cpu0userUsage=1.000000
  order:18 cpu1Frequency=1992000
  order:19 cpu1Usage=0.000000
  order:20 cpu1idleUsage=100.000000
  order:21 cpu1ioWaitUsage=0.000000
  order:22 cpu1irqUsage=0.000000
  order:23 cpu1niceUsage=0.000000
  order:24 cpu1softIrqUsage=0.000000
  order:25 cpu1systemUsage=0.000000
  order:26 cpu1userUsage=0.000000
  order:27 cpu2Frequency=1992000
  order:28 cpu2Usage=1.000000
  order:29 cpu2idleUsage=99.000000
  order:30 cpu2ioWaitUsage=0.000000
  order:31 cpu2irqUsage=0.000000
  order:32 cpu2niceUsage=0.000000
  order:33 cpu2softIrqUsage=0.000000
  order:34 cpu2systemUsage=1.000000
  order:35 cpu2userUsage=0.000000
  order:36 cpu3Frequency=1992000
  order:37 cpu3Usage=0.000000
  order:38 cpu3idleUsage=100.000000
  order:39 cpu3ioWaitUsage=0.000000
  order:40 cpu3irqUsage=0.000000
  order:41 cpu3niceUsage=0.000000
  order:42 cpu3softIrqUsage=0.000000
  order:43 cpu3systemUsage=0.000000
  order:44 cpu3userUsage=0.000000

  ...

  command exec finished!
  $

设置包名并采集2次整机CPU大中小核频率、各核使用率以及进程CPU使用率、负载

  $ SP_daemon -N 2 -PKG ohos.samples.ecg -c



  order:0 timestamp=1741415021814
  order:1 ChildProcCpuLoad=NA
  order:2 ChildProcCpuUsage=NA
  order:3 ChildProcId=NA
  order:4 ChildProcSCpuUsage=NA
  order:5 ChildProcUCpuUsage=NA
  order:6 ProcAppName=ohos.samples.ecg
  order:7 ProcCpuLoad=2.742330
  order:8 ProcCpuUsage=7.825508
  order:9 ProcId=18847
  order:10 ProcSCpuUsage=2.014652
  order:11 ProcUCpuUsage=5.810856
  order:12 TotalcpuUsage=22.527016
  order:13 TotalcpuidleUsage=77.472984
  order:14 TotalcpuioWaitUsage=0.000000
  order:15 TotalcpuirqUsage=0.083126
  order:16 TotalcpuniceUsage=0.000000
  order:17 TotalcpusoftIrqUsage=0.000000
  order:18 TotalcpusystemUsage=7.148795
  order:19 TotalcpuuserUsage=15.295096
  order:20 cpu0Frequency=1430000
  order:21 cpu0Usage=52.475248
  order:22 cpu0idleUsage=47.524752
  order:23 cpu0ioWaitUsage=0.000000
  order:24 cpu0irqUsage=0.000000

  ...

  command exec finished!
  $

设置进程ID并采集2次整机CPU大中小核频率、各核使用率以及进程CPU使用率、负载

  $ SP_daemon -N 2 -PID 18847 -c



  order:0 timestamp=1741415133211
  order:1 ChildProcCpuLoad=NA
  order:2 ChildProcCpuUsage=NA
  order:3 ChildProcId=NA
  order:4 ChildProcSCpuUsage=NA
  order:5 ChildProcUCpuUsage=NA
  order:6 ProcAppName=ohos.samples.ecg
  order:7 ProcCpuLoad=2.510634
  order:8 ProcCpuUsage=7.005678
  order:9 ProcId=18847
  order:10 ProcSCpuUsage=2.697061
  order:11 ProcUCpuUsage=4.308617
  order:12 TotalcpuUsage=24.979114
  order:13 TotalcpuidleUsage=75.020886
  order:14 TotalcpuioWaitUsage=0.000000
  order:15 TotalcpuirqUsage=0.083542
  order:16 TotalcpuniceUsage=0.000000
  order:17 TotalcpusoftIrqUsage=0.000000
  order:18 TotalcpusystemUsage=8.270677
  order:19 TotalcpuuserUsage=16.624896
  order:20 cpu0Frequency=1430000
  order:21 cpu0Usage=50.000000
  order:22 cpu0idleUsage=50.000000
  order:23 cpu0ioWaitUsage=0.000000
  order:24 cpu0irqUsage=0.000000
  ...
  command exec finished!
  $

说明

使用该命令采集时需进入被测应用内。

采集1次整机GPU频率和负载

  $ SP_daemon -N 1 -g
  
  
  
  order:0 timestamp=1503078740268
  order:1 gpuFrequency=200000000
  order:2 gpuLoad=38.000000
  
  command exec finished!
  $

采集2次整机温度

  $ SP_daemon -N 2 -t

  order:0 timestamp=1502720711191
  order:1 gpu-thermal=42500.000000
  order:2 soc-thermal=43.125000
  
  
  order:0 timestamp=1502720712191
  order:1 gpu-thermal=41875.000000
  order:2 soc-thermal=42.500000

  command exec finished!
  $

采集2次整机内存

  $ SP_daemon -N 2 -r
  order:0 timestamp=1705041562521
  order:1 memAvailable=7339224
  order:2 memFree=7164708
  order:3 memTotal=11641840

  order:0 timestamp=1705041563527
  order:1 memAvailable=7339136
  order:2 memFree=7164684
  order:3 memTotal=11641840

  command exec finished!
  $

设置包名并采集1次整机和指定应用进程内存

  $ SP_daemon -N 1 -PKG ohos.samples.ecg -r



  order:0 timestamp=1741415257059
  order:1 arktsHeapPss=44835
  order:2 childCarktsHeapPss=NA
  order:3 childGpuPss=NA
  order:4 childGraphicPss=NA
  order:5 childHeapAlloc=NA
  order:6 childHeapFree=NA
  order:7 childHeapSize=NA
  order:8 childNativeHeapPss=NA
  order:9 childPrivateClean=NA
  order:10 childPrivateDirty=NA
  order:11 childPss=NA
  order:12 childSharedClean=NA
  order:13 childSharedDirty=NA
  order:14 childStackPss=NA
  order:15 childSwap=NA
  order:16 childSwapPss=NA
  order:17 gpuPss=222377
  order:18 graphicPss=184276
  order:19 heapAlloc=154696
  order:20 heapFree=780
  order:21 heapSize=163208
  order:22 memAvailable=4612096
  order:23 memFree=1240924
  order:24 memTotal=11692696
  order:25 nativeHeapPss=85290
  order:26 privateClean=195816
  order:27 privateDirty=418973
  order:28 pss=693349
  order:29 sharedClean=146848
  order:30 sharedDirty=71056
  order:31 stackPss=2492
  order:32 swap=25360
  order:33 swapPss=25356

  command exec finished!
  $

设置进程ID并采集1次整机和指定应用进程内存

  $ SP_daemon -N 1 -PID 18847 -r



  order:0 timestamp=1741415293198
  order:1 arktsHeapPss=45011
  order:2 childCarktsHeapPss=NA
  order:3 childGpuPss=NA
  order:4 childGraphicPss=NA
  order:5 childHeapAlloc=NA
  order:6 childHeapFree=NA
  order:7 childHeapSize=NA
  order:8 childNativeHeapPss=NA
  order:9 childPrivateClean=NA
  order:10 childPrivateDirty=NA
  order:11 childPss=NA
  order:12 childSharedClean=NA
  order:13 childSharedDirty=NA
  order:14 childStackPss=NA
  order:15 childSwap=NA
  order:16 childSwapPss=NA
  order:17 gpuPss=222381
  order:18 graphicPss=184276
  order:19 heapAlloc=154588
  order:20 heapFree=757
  order:21 heapSize=163184
  order:22 memAvailable=4612096
  order:23 memFree=1238420
  order:24 memTotal=11692696
  order:25 nativeHeapPss=85274
  order:26 privateClean=195996
  order:27 privateDirty=418977
  order:28 pss=693440
  order:29 sharedClean=146848
  order:30 sharedDirty=71056
  order:31 stackPss=2492
  order:32 swap=25360
  order:33 swapPss=25356

  command exec finished!
  $

说明

使用该命令采集时需进入被测应用内。

该命令集成了历史版本-m的数据（arktsHeapPss、gpuPss、graphicPss...）。

采集2次截图
```
  $ SP_daemon -N 2 -snapshot

  order:0 timestamp=1501837609657
  order:1 capture=data/local/tmp/capture/screenCap_1501837609657.png
  
  
  order:0 timestamp=1501837610657
  order:1 capture=NA

  command exec finished!
  $
```
说明
- 截图采集是2秒截取一次。
- 截图报告存放路径为：data/local/tmp/capture。
- 采集结束后：进入 data/local/tmp/capture 查看生成的截图。
- 导出截图到D盘：重启一个命令行工具执行命令： hdc file recv data/local/tmp/capture/screenCap_1700725192774.png D:\。

采集2次网络速率

  $ SP_daemon -N 2 -net

  order:0 timestamp=1705041904832
  order:1 networkDown=0
  order:2 networkUp=0

  order:0 timestamp=1705041905870
  order:1 networkDown=22931
  order:2 networkUp=2004

  command exec finished!
  $

设置包名并采集5次指定应用帧率

  $ SP_daemon -N 5 -PKG ohos.samples.ecg -f

  order:0 timestamp=1705306472232
  order:1 fps=43
  order:2 fpsJitters=602261688;;8352083;;8267708;;8305209;;8298437;;8308854;;8313542;;8569271;;8061458;;8300521;;8308333;;8309896;;8429167;;8241667;;8258333;;8318229;;8312500;;8304167;;41760937;;16418750;;8298959;;8319270;;8308334;;8313541;;8302605;;8320312;;8298958;;8326042;;8321354;;8301042;;8310417;;8309895;;8308855;;8331250;;8286458;;8343229;;8278125;;8311458;;8306250;;8312500;;8320834;;8346875;;8283333
  order:3 refreshrate=69

  order:0 timestamp=1705306473234
  order:1 fps=40
  order:2 fpsJitters=674427313;;8191145;;8310417;;8319271;;8301562;;8318750;;8302084;;8314062;;8333334;;8283854;;8307812;;8311979;;8310417;;8307813;;8309375;;8323958;;8306250;;8308333;;8317709;;8296875;;8721875;;7895833;;8320833;;8340625;;8276563;;8409896;;8216145;;8310938;;8301042;;8362500;;8252604;;8317708;;8376042;;8256250;;8292187;;8303125;;8313542;;8310417;;8520312
  order:3 refreshrate=69
  ...

  command exec finished!
  $

采集10次指定图层帧率

  $ SP_daemon -N 10 -VIEW DisplayNode -f
  order:0 timestamp=1705306822850
  order:1 fps=15
  order:2 fpsJitters=876291843;;8314062;;8308334;;8314583;;8310417;;8308333;;8326042;;8314583;;8292708;;8492709;;8143750;;8340104;;8294271;;8302604;;8297396
  order:3 refreshrate=69

  order:0 timestamp=1705306823852
  order:1 fps=12
  order:2 fpsJitters=906667363;;8279167;;8311458;;8315625;;8291146;;8313021;;8323438;;8293750;;8303125;;8313541;;8301563;;8317708
  order:3 refreshrate=69
  ...

  command exec finished!
  $

说明

DisplayNode 是指定的图层名。

使用该命令采集时，需在传入的图层上操作页面。

该命令不能与指定应用帧率一起采集（SP_daemon -N 20 -PKG ohos.samples.ecg -f 或 SP_daemon -N 20 -VIEW DisplayNode -f）。

采集1次DDR信息

  $ SP_daemon -N 1 -d
  
  order:0 timestamp=1710916175201
  order:1 ddrFrequency=1531000000
  
  command exec finished!
  $

全量采集示例1，采集整机信息，包括cpu、gpu、温度、内存信息、DDR信息、网络速率、屏幕截图

  $ SP_daemon -N 10 -c -g -t -r -d -net -snapshot

  order:0 timestamp=1501837838664
  order:1 TotalcpuUsage=0.751880
  order:2 TotalcpuidleUsage=99.248120
  order:3 TotalcpuioWaitUsage=0.000000
  order:4 TotalcpuirqUsage=0.000000
  order:5 TotalcpuniceUsage=0.000000
  order:6 TotalcpusoftIrqUsage=0.000000
  order:7 TotalcpusystemUsage=0.501253
  order:8 TotalcpuuserUsage=0.250627
  order:9 cpu0Frequency=1992000
  order:10 cpu0Usage=0.000000
  order:11 cpu0idleUsage=100.000000
  order:12 cpu0ioWaitUsage=0.000000
  order:13 cpu0irqUsage=0.000000
  order:14 cpu0niceUsage=0.000000
  order:15 cpu0softIrqUsage=0.000000
  order:16 cpu0systemUsage=0.000000
  order:17 cpu0userUsage=0.000000
  order:18 cpu1Frequency=1992000
  order:19 cpu1Usage=0.000000
  order:20 cpu1idleUsage=100.000000
  order:21 cpu1ioWaitUsage=0.000000
  order:22 cpu1irqUsage=0.000000
  order:23 cpu1niceUsage=0.000000
  order:24 cpu1softIrqUsage=0.000000
  order:25 cpu1systemUsage=0.000000
  order:26 cpu1userUsage=0.000000
  order:27 cpu2Frequency=1992000
  order:28 cpu2Usage=1.000000
  order:29 cpu2idleUsage=99.000000
  order:30 cpu2ioWaitUsage=0.000000
  order:31 cpu2irqUsage=0.000000
  order:32 cpu2niceUsage=0.000000
  order:33 cpu2softIrqUsage=0.000000
  order:34 cpu2systemUsage=1.000000
  order:35 cpu2userUsage=0.000000
  order:36 cpu3Frequency=1992000
  order:37 cpu3Usage=0.000000
  order:38 cpu3idleUsage=100.000000
  order:39 cpu3ioWaitUsage=0.000000
  order:40 cpu3irqUsage=0.000000
  order:41 cpu3niceUsage=0.000000
  order:42 cpu3softIrqUsage=0.000000
  order:43 cpu3systemUsage=0.000000
  order:44 cpu3userUsage=0.000000
  order:45 gpuFrequency=200000000
  order:46 gpuLoad=0.000000
  order:47 gpu-thermal=40000.000000
  order:48 soc-thermal=40.625000
  order:49 memAvailable=1142820
  order:50 memFree=687988
  order:51 memTotal=1935948
  order:52 ddrFrequency=800000000
  order:53 networkDown=0
  order:54 networkUp=0
  order:55 capture=data/local/tmp/capture/screenCap_1501837838669.png

  ...

  command exec finished!
  $

全量采集示例2，设置包名并采集指定应用信息，包括cpu、gpu、温度、fps、内存信息、DDR信息、网络速率、屏幕截图

  $ SP_daemon -N 10 -PKG ohos.samples.ecg -c -g -t -f -r -d -net -snapshot -threads
  
  order:0 timestamp=1741415955626
  order:1 ChildProcCpuLoad=NA
  order:2 ChildProcCpuUsage=NA
  order:3 ChildProcId=NA
  order:4 ChildProcSCpuUsage=NA
  order:5 ChildProcUCpuUsage=NA
  order:6 ProcAppName=ohos.samples.ecg
  order:7 ProcCpuLoad=2.641511
  order:8 ProcCpuUsage=6.026481
  order:9 ProcId=18847
  order:10 ProcSCpuUsage=1.747202
  order:11 ProcUCpuUsage=4.279279
  order:12 TotalcpuUsage=26.021798
  order:13 TotalcpuidleUsage=73.978202
  order:14 TotalcpuioWaitUsage=0.000000
  order:15 TotalcpuirqUsage=0.068120
  order:16 TotalcpuniceUsage=0.000000
  order:17 TotalcpusoftIrqUsage=0.000000
  order:18 TotalcpusystemUsage=10.762943
  order:19 TotalcpuuserUsage=15.190736
  ...
  order:123 gpuFrequency=279000000
  order:124 gpuLoad=0.000000
  order:125 Battery=35.000000
  order:126 cluster0=51.000000
  order:127 gpu=47.000000
  order:128 npu_thermal=35.000000
  order:129 shell_back=36.627000
  order:130 shell_frame=35.627000
  order:131 shell_front=35.652000
  order:132 soc_thermal=59.259000
  order:133 system_h=37.000000
  order:134 fps=30
  order:135 fpsJitters=33501562;;50251042;;33522396;;16743750;;33482812;;33505730;;33507291;;33505209;;33502604;;50258854;;33518229;;33501563;;16753125;;50247916;;16751563;;33507812;;16740104;;16792188;;33464583;;33497917;;50261458;;33493750;;33511459;;33502083;;16744271;;16756250;;33505729;;50254687;;33507292;;50286979
  order:136 refreshrate=60
  order:137 arktsHeapPss=29564
  order:138 gpuPss=254647
  order:139 graphicPss=215796
  order:140 heapAlloc=174032
  order:141 heapFree=1232
  order:142 heapSize=187924
  order:143 memAvailable=3437568
  order:144 memFree=780152
  order:145 memTotal=11697880
  order:146 nativeHeapPss=91244
  order:147 privateClean=162560
  order:148 privateDirty=488739
  order:149 pss=761908
  order:150 sharedClean=225060
  order:151 sharedDirty=48740
  order:152 stackPss=2596
  order:153 swap=62024
  order:154 swapPss=62024
  order:155 ddrFrequency=1531000000
  order:156 networkDown=215
  order:157 networkUp=0
  ...
  order:180 capture=data/local/tmp/capture/screenCap_1741415955811.png
  order:181 threadsNum=18847:111|
  order:182 tids=18847:45862 45700 25783 25622 25384 25381 19423 19170 19167 19166 19165 19163 19162 19159 19157 19156 19154 19153 19152 19151 19150 19149 19147 19146 19145 19142 19141 19140 19139 19136 19135 19134 19120 19112 19111 19088 19083 19081 19077 19076 19075 19074 19073 19072 19071 19070 19055 19044 19040 19039 19034 19033 19032 19031 19030 19029 19028 19027 19019 19017 19016 19015 19014 19013 19012 19011 19009 19007 19006 19005 19004 19003 19001 19000 18999 18998 18997 18996 18995 18994 18993 18992 18991 18990 18989 18988 18987 18986 18985 18984 18983 18982 18981 18980 18977 18974 18946 18942 18936 18934 18933 18931 18930 18929 18928 18927 18926 18925 18924 18923 18847|
  ...
  
  command exec finished!
  $

全量采集示例3，设置进程ID并采集指定应用信息，包括cpu、gpu、温度、fps、内存信息、DDR信息、网络速率、屏幕截图

  $ SP_daemon -N 10 -PID 18847 -c -g -t -f -r -d -net -snapshot -threads
  
  order:0 timestamp=1741416084766
  order:1 ChildProcCpuLoad=NA
  order:2 ChildProcCpuUsage=NA
  order:3 ChildProcId=NA
  order:4 ChildProcSCpuUsage=NA
  order:5 ChildProcUCpuUsage=NA
  order:6 ProcAppName=ohos.samples.ecg
  order:7 ProcCpuLoad=2.857003
  order:8 ProcCpuUsage=5.932203
  order:9 ProcId=18847
  order:10 ProcSCpuUsage=1.765537
  order:11 ProcUCpuUsage=4.166667
  order:12 TotalcpuUsage=28.442728
  order:13 TotalcpuidleUsage=71.557272
  order:14 TotalcpuioWaitUsage=0.000000
  order:15 TotalcpuirqUsage=0.000000
  order:16 TotalcpuniceUsage=0.000000
  order:17 TotalcpusoftIrqUsage=0.000000
  order:18 TotalcpusystemUsage=9.716860
  order:19 TotalcpuuserUsage=18.725869
  ...
  order:123 gpuFrequency=279000000
  order:124 gpuLoad=0.000000
  order:125 Battery=35.000000
  order:126 cluster0=51.000000
  order:127 gpu=47.000000
  order:128 npu_thermal=35.000000
  order:129 shell_back=36.627000
  order:130 shell_frame=35.627000
  order:131 shell_front=35.652000
  order:132 soc_thermal=59.259000
  order:133 system_h=37.000000
  order:134 fps=30
  order:135 fpsJitters=33501562;;50251042;;33522396;;16743750;;33482812;;33505730;;33507291;;33505209;;33502604;;50258854;;33518229;;33501563;;16753125;;50247916;;16751563;;33507812;;16740104;;16792188;;33464583;;33497917;;50261458;;33493750;;33511459;;33502083;;16744271;;16756250;;33505729;;50254687;;33507292;;50286979
  order:136 refreshrate=60
  order:137 arktsHeapPss=29564
  order:138 gpuPss=254647
  order:139 graphicPss=215796
  order:140 heapAlloc=174032
  order:141 heapFree=1232
  order:142 heapSize=187924
  order:143 memAvailable=3437568
  order:144 memFree=780152
  order:145 memTotal=11697880
  order:146 nativeHeapPss=91244
  order:147 privateClean=162560
  order:148 privateDirty=488739
  order:149 pss=761908
  order:150 sharedClean=225060
  order:151 sharedDirty=48740
  order:152 stackPss=2596
  order:153 swap=62024
  order:154 swapPss=62024
  order:155 ddrFrequency=1531000000
  order:156 networkDown=215
  order:157 networkUp=0
  ...
  order:180 capture=data/local/tmp/capture/screenCap_1741416084923.png
  order:181 threadsNum=18847:113|
  order:182 tids=18847:46736 46734 46731 46663 25783 25622 25384 25381 19423 19170 19167 19166 19165 19163 19162 19159 19157 19156 19154 19153 19152 19151 19150 19149 19147 19146 19145 19142 19141 19140 19139 19136 19135 19134 19120 19112 19111 19088 19083 19081 19077 19076 19075 19074 19073 19072 19071 19070 19055 19044 19040 19039 19034 19033 19032 19031 19030 19029 19028 19027 19019 19017 19016 19015 19014 19013 19012 19011 19009 19007 19006 19005 19004 19003 19001 19000 18999 18998 18997 18996 18995 18994 18993 18992 18991 18990 18989 18988 18987 18986 18985 18984 18983 18982 18981 18980 18977 18974 18946 18942 18936 18934 18933 18931 18930 18929 18928 18927 18926 18925 18924 18923 18847|
  ...
  
  command exec finished!
  $

说明

使用该命令采集时需进入被测应用内。

2. 启停采集

执行start命令开始采集，操作设备或应用后，执行stop命令结束采集。

命令参数	必选	说明
-start	是	开始采集，该命令参数后可添加基础采集命令，每秒采集一次。
-stop	是	结束采集，生成采集报告。
-print	否	每秒打印启停采集信息。

启停采集整机CPU大中小核频率、各核使用率

# 开始采集
$ SP_daemon -start -c
SP_daemon Collection begins
 
 
command exec finished!
$
   
# 结束采集
$ SP_daemon -stop
SP_daemon Collection ended
Output Path: data/local/tmp/smartperf/1/t_index_info.csv
 
 
command exec finished!
$

启停采集并打印整机CPU大中小核频率、各核使用率

 # 开始采集
 # 打印启停采集信息
 $ SP_daemon -start -c -print
 SP_daemon Collection begins
 
 order:0 TotalcpuUsage=20.860927
 order:1 TotalcpuidleUsage=79.139073
 order:2 TotalcpuioWaitUsage=0.000000
 order:3 TotalcpuirqUsage=0.082781
 order:4 TotalcpuniceUsage=0.000000
 order:5 TotalcpusoftIrqUsage=0.000000
 order:6 TotalcpusystemUsage=8.029801
 order:7 TotalcpuuserUsage=12.748344
 order:8 cpu0Frequency=1430000
 order:9 cpu0Usage=44.554455
 order:10 cpu0idleUsage=55.445545
 order:11 cpu0ioWaitUsage=0.000000
 order:12 cpu0irqUsage=0.000000
 order:13 cpu0niceUsage=0.000000
 order:14 cpu0softIrqUsage=0.000000
 order:15 cpu0systemUsage=17.821782
 order:16 cpu0userUsage=26.732673
 order:17 cpu10Frequency=1239000
 order:18 cpu10Usage=0.000000
 order:19 cpu10idleUsage=100.000000
 order:20 cpu10ioWaitUsage=0.000000
 order:21 cpu10irqUsage=0.000000
 order:22 cpu10niceUsage=0.000000
 order:23 cpu10softIrqUsage=0.000000
 order:24 cpu10systemUsage=0.000000
 order:25 cpu10userUsage=0.000000
 order:26 cpu11Frequency=1239000
 order:27 cpu11Usage=0.000000
 order:28 cpu11idleUsage=100.000000
 order:29 cpu11ioWaitUsage=0.000000
 order:30 cpu11irqUsage=0.000000
 order:31 cpu11niceUsage=0.000000
 order:32 cpu11softIrqUsage=0.000000
 order:33 cpu11systemUsage=0.000000
 order:34 cpu11userUsage=0.000000
 ...
 command exec finished!
 $
   
 # 结束采集
 # 在启停打印时，需重新开启命令框执行此命令
 $ SP_daemon -stop
 SP_daemon Collection ended
 Output Path: data/local/tmp/smartperf/1/t_index_info.csv
 
 command exec finished!
 $

说明

开始采集示例1（采整机cpu、gpu、温度、fps、内存信息、DDR信息、网络速率、屏幕截图）：SP_daemon -start -c -g -t -r -d -net -snapshot。

开始采集示例2（采整机和进程cpu负载、gpu、温度、fps、内存信息、DDR信息、网络速率、屏幕截图、线程数、文件描述符）：SP_daemon -start -PKG ohos.samples.ecg -c -g -t -f -r -d -net -snapshot -threads -fds。

开始采集示例3（采整机和进程cpu负载、gpu、温度、fps、内存信息、DDR信息、网络速率、屏幕截图、线程数、文件描述符）：SP_daemon -start -PID 18847 -c -g -t -f -r -d -net -snapshot -threads -fds。

开始采集示例4（采整机cpu、gpu、温度、fps、内存信息、DDR信息、网络速率、屏幕截图、线程数、文件描述符并且打印采集信息）：SP_daemon -start -c -g -t -r -d -net -snapshot -threads -fds -print。

开始采集示例5（采整机和进程cpu负载、gpu、温度、fps、内存信息、DDR信息、网络速率、屏幕截图、线程数、文件描述符并且打印采集信息）：SP_daemon -start -PID 18847 -c -g -t -f -r -d -net -snapshot -threads -fds -print。

启停服务文件输出路径为：data/local/tmp/smartperf/1/t_index_info.csv，可通过hdc file recv的方式导出查看报告。具体请参考查看csv采集结果。

3. 查看csv采集结果

若采集结果保存在csv文件中，可以按照如下操作导出和查看结果内容。

采集结果默认输出路径：/data/local/tmp/data.csv

查看文件位置

C:\Users\issusser>hdc shell
$ cd data/local/tmp
# ls
data.csv
$

导出文件到指定路径

C:\Users\issusser>hdc file recv data/local/tmp/data.csv D:\
[I][2023-11-08 16:16:41] HdcFile::TransferSummary success
FileTransfer finish, Size:429, File count = 1, time:6ms rate:71.50kB/s

C:\Users\issusser>

打开data.csv文件查看采集数据

在自定义导出路径里找到data.csv文件打开查看采集数据表，data.csv数据名描述如下：

数据项	说明	备注
threadsNum	线程总数。	-
tids	线程id。	-
cpuFrequency	CPU大中小核频率。	单位：Hz
cpuUasge	CPU各核使用率。	%
cpuidleUsage	CPU空闲态使用率。	%
cpuioWaitUsage	等待I/O的使用率。	%
cpuirqUsage	硬中断的使用率。	%
cpuniceUsage	低优先级用户态使用率。	%
cpusoftIrqUsage	软中断的使用率。	%
cpusystemUsage	系统/内核态使用率。	%
cpuuserUsage	用户态使用率。	%
ProcId	进程id。	-
ChildProcId	子进程id。	-
ProcAppName	app包名。	-
ProcCpuLoad	进程CPU负载占比。	%
ChildProcCpuLoad	子进程CPU负载占比。	%
ProcCpuUsage	进程CPU使用率。	%
ChildProcCpuUsage	子进程CPU使用率。	%
ProcUCpuUsage	进程用户态CPU使用率。	%
ChildProcCpuUsage	子进程用户态CPU使用率。	%
ProcSCpuUsage	进程内核态CPU使用率。	%
ChildProcSCpuUsage	子进程内核态CPU使用率。	%
gpuFrequency	整机GPU的频率。	%
gpuLoad	整机GPU的负载占比。	%
hw-instructions	执行的指令数。	-
cycles per instruction	每条指令的平均周期数。	单位：ns
hw-cpu-cycles	CPU时钟周期数。	单位：ns
currentNow	当前读到的电流值。	单位：mA
voltageNow	当前读到的电压值。	单位：μV
fps	每秒帧数。	单位：fps
fpsJitters	每一帧绘制间隔。	单位：ns
refreshrate	屏幕刷新率。	单位：Hz
networkDown	下行速率。	单位：byte/s
networkUp	上行速率。	单位：byte/s
ddrFrequency	DDR频率。	单位：Hz
gpu-thermal	GPU温度。	单位：°C
soc-thermal	系统芯片温度。	单位：°C
memAvailable	整机可用内存。	单位：KB
memFree	整机空闲内存。	单位：KB
memTotal	整机总内存。	单位：KB
pss	进程实际使用内存。	单位：KB
Childpss	子进程实际使用内存。	单位：KB
sharedClean	进程共享的未改写页面。	单位：KB
ChildsharedClean	子进程共享的未改写页面。	单位：KB
sharedDirty	进程共享的已改写页面。	单位：KB
ChildsharedDirty	子进程共享的已改写页面。	单位：KB
priviateClean	进程私有的未改写页面。	单位：KB
ChildpriviateClean	子进程私有的未改写页面。	单位：KB
privateDirty	进程私有的已改写页面。	单位：KB
ChildprivateDirty	子进程私有的已改写页面。	单位：KB
swapTotal	进程总的交换内存。	单位：KB
ChildswapTotal	子进程总的交换内存。	单位：KB
swapPss	进程交换的pss内存。	单位：KB
ChildswapPss	子进程交换的pss内存。	单位：KB
HeapSize	进程堆内存大小。	单位：KB
ChildHeapSize	子进程堆内存大小。	单位：KB
HeapAlloc	进程可分配的堆内存大小。	单位：KB
ChildHeapAlloc	子进程可分配的堆内存大小。	单位：KB
HeapFree	进程剩余的堆内存大小。	单位：KB
ChildHeapFree	子进程剩余的堆内存大小。	单位：KB
gpuPss	进程使用的gpu内存大小。	单位：KB
ChildgpuPss	子进程使用的gpu内存大小。	单位：KB
graphicPss	进程使用的图形内存大小。	单位：KB
ChildgraphicPss	子进程使用的图形内存大小。	单位：KB
arktsHeapPss	进程使用的arkts内存大小。	单位：KB
ChildarktsHeapPss	子进程使用的arkts内存大小。	单位：KB
nativeHeapPss	进程使用的native内存大小。	单位：KB
ChildnativeHeapPss	子进程使用的native内存大小。	单位：KB
stackPss	进程使用的栈内存大小。	单位：KB
ChildstackPss	子进程使用的栈内存大小。	单位：KB
timeStamp	当前时间戳。	对应采集时间

场景化采集

除基础采集外，还支持采集响应和完成时延等内容。场景化采集结果不写入data.csv，采集结果直接在命令框显示。

命令参数	必选	说明
-editor	是	场景化采集标识，后可添加参数配置项。
-responseTime	否	响应时延。
-completeTime	否	完成时延。
-fpsohtest	否	validator用于获取fps，1秒采集一次，默认采集10次。

应用响应时延（命令仅支持RK）
```
 $ SP_daemon -editor responseTime ohos.samples.ecg ohtest
 time:544ms

 command exec finished!
```
说明
- 采集前先进入应用内，在命令框回车后切换至应用内页面，等待打印采集结果。
应用完成时延（命令仅支持RK）
```
 $ SP_daemon -editor completeTime ohos.samples.ecg ohtest
 time:677ms

 command exec finished!
```
说明
- 采集前先进入应用内，在命令框回车后切换至应用内页面，等待打印采集结果。

validator获取应用页面帧率

 $ SP_daemon -editor fpsohtest
 set num:10 successfps:0|1726909713442fps:97|1726909714442fps:113|1726909715442fps:116|1726909716442fps:116|1726909717442fps:118|1726909718442fps:114|1726909719442fps:114|1726909720442fps:115|1726909721442fps:118|1726909722442SP_daemon exec finished!

说明

执行命令后需滑动或切换当前页面，等待10s后打印采集结果。

其他采集

当前设备电量采集结果可写入csv文件，其它命令需单独采集，采集结果不写入data.csv，仅在命令框显示。

命令参数	必选	说明
-screen	否	采集屏幕分辨率和刷新率。
-deviceinfo	否	获取设备信息。
-server	否	启停采集用来拉起daemon进程。
-clear	否	清除所有SP_daemon进程。
-ohtestfps	否	validator用于获取fps，可设置采集次数（1秒采集一次）。
-editorServer	否	editor工具用来拉起daemon进程。
-recordcapacity	否	获取当前设备电量。
-profilerfps	否	采集当前界面fps。

获取屏幕分辨率
```
 $ SP_daemon -screen
 activeMode: 720x1280, refreshrate=69
  
  
 command exec finished!
 $
```
说明
- activeMode表示当前屏幕分辨率，refreshrate表示屏幕刷新率。

获取设备信息

 $ SP_daemon -deviceinfo
 abilist: default
 activeMode: 720x1280
 board: hw
 brand: default
 cpu_c1_cluster: 0 1 2 3
 cpu_c1_max: 1992000
 cpu_c1_min: 408000
 cpu_cluster_name: policy0
 daemonPerfVersion: 1.0.5
 deviceTypeName: rk3568
 fullname: OpenHarmony-5.1.0.46
 gpu_max_freq: 800000000
 gpu_min_freq: 200000000
 model: ohos
 name: OpenHarmony 3.2
 sn: 150100424a5444345209d941bec6b900
 version: OpenHarmony 5.1.0.46
  
 command exec finished!
 $

启动一个进程来监听start和stop命令的socket消息
```
 $ SP_daemon -server
 $
 $ pidof SP_daemon
 7024
 $
```
说明
- 可执行pidof SP_daemon查看进程id。

清除SP_daemon进程ID

 $ pidof SP_daemon
 2725   
 $ SP_daemon -clear
  
  
 command exec finished!
 $
 $ pidof SP_daemon
 $

说明

可执行pidof SP_daemon查看进程id。

validator用于获取当前页面帧率

 $ SP_daemon -ohtestfps 10
 set num:10 success
 fps:1|1501926684532
 fps:18|1501926685532
 fps:37|1501926686532
 fps:41|1501926687532
 fps:42|1501926688532
 fps:16|1501926689532
 fps:40|1501926690532
 fps:40|1501926691532
 fps:42|1501926692532
 fps:41|1501926693532
 SP_daemon exec finished!
 $

说明

该条命令里的10表示采集的次数（一秒采集一次），可以设置为其他正整数。

启动一个进程来监听editor工具的socket消息

 $ SP_daemon -editorServer
  
  
 command exec finished!

获取电池电量
```
 $ SP_daemon -recordcapacity
 recordTime: 1726903063
 recordPower: 5502
```
说明
- recordTime表示时间戳，recordPower表示当前时刻的电量。
- 该命令需单独采集，采集结果写入/data/local/tmp/powerLeftRecord.csv，可以使用hdc file recv导出到本地。具体请参考查看csv采集结果。

采集当前界面fps

  $ SP_daemon -profilerfps 10
  set num:10 success
  fps:0|1711692357278
  fps:0|1711692358278
  fps:1|1711692359278
  fps:0|1711692360278
  fps:0|1711692361278
  fps:0|1711692362278
  fps:0|1711692363278
  fps:0|1711692364278
  fps:26|1711692365278
  fps:53|1711692366278
  SP_daemon exec finished!
  $

说明

该条命令里的100表示采集的次数（一秒采集一次），可以设置为其他正整数。

fps分段采集

  $ SP_daemon -profilerfps 100 -sections 10
  set num:100 success
  fps:0|1711692393278
  fps:0|1711692394278
  fps:0|1711692395278
  fps:44|1711692396278
  sectionsFps:0|1711692396278
  sectionsFps:0|1711692396378
  sectionsFps:40|1711692396478
  sectionsFps:60|1711692396578
  sectionsFps:60|1711692396678
  sectionsFps:60|1711692396778
  sectionsFps:60|1711692396878
  sectionsFps:40|1711692396978
  sectionsFps:60|1711692397078
  sectionsFps:60|1711692397178
  fps:51|1711692397278

  ...

  SP_daemon exec finished!
  $

说明

该条命令里的100表示采集的次数（一秒采集一次），可以设置为其他正整数，10表示分段：目前支持设置 1-10（正整数）段采集。