Example of Using the Kunpeng Performance Boundary Analyzer
The following example uses a compressed package and assumes that you have switched to the tool directory. It describes how to use the tool on a Kunpeng 920 server to collect and analyze system performance data and detect metric differences.
Figure 1 Overall process
- Run the collection command.
1./ksys collect -d 10 -i 1 -o /home/test/
- Set the collection duration to 10 seconds and the collection interval to 1 second. Set the JSON file directory to /home/test/.
- After the collection is complete, the summary data is printed but not saved to the JSON file.
Command output:
\hotspot data collection is disabled. Refer to /home/ksys-xxx-Linux-aarch64/config.yaml for details Starting to collect data. You can press Ctrl+C to stop the task. Starting to parse data. You can press Ctrl+C stop the task. Progress: 2/2 | Sub-progress(spe data): 10/10. Starting to process and print data. You can press Ctrl+C to stop, and no results will be saved. ==================================================== Time : 2026/01/22 19:51:22 Version : DevKit xxx Model Name : HUAWEI Kunpeng 920 V200 7270Z Command : ksys collect -d 10 -i 1 -o /home/test/ ==================================================== ============================================================================================CPU Metrics============================================================================================= Common Microarchitecture Metrics Summary Data (System wide) +------+--------------+------+------+----------+----------+----------+----------+-----------+-----------+---------+ | IPC | INSTRUCTIONS | MPKI | BPKI | L1D MPKI | L1I MPKI | L2D MPKI | L2I MPKI | DTLB MPKI | ITLB MPKI | CPU-NUM | +------+--------------+------+------+----------+----------+----------+----------+-----------+-----------+---------+ | 0.51 | 152795353756 | 1.07 | 0.24 | 1.1 | 0.42 | 0.66 | 0.1 | 1.24 | 0.1 | 256 | +------+--------------+------+------+----------+----------+----------+----------+-----------+-----------+---------+ Topdown Summary Data (System wide) +----------------------------+-------+ | Metric | Value | +----------------------------+-------+ | Retiring(%) | 8.14 | | Frontend Bound(%) | 5.52 | | Fetch Latency Bound(%) | 3.37 | | Fetch Bandwidth Bound(%) | 2.15 | | Bad Speculation(%) | 1.56 | | Branch Mispredicts(%) | 0.16 | | Machine Clears(%) | 1.4 | | Backend Bound(%) | 84.78 | | Core Bound(%) | 48.03 | | Memory Bound(%) | 36.75 | | CPU-NUM | 256 | +----------------------------+-------+ OS Metrics Summary Data (System wide) +------------------+------------+-------------+---------+ | context-switches | migrations | page-faults | CPU-NUM | +------------------+------------+-------------+---------+ | 88074 | 186 | 26284 | 256 | +------------------+------------+-------------+---------+ INSTRUCTION Summary Data (System wide) +----------------------------------+-------+ | Metric | Value | +----------------------------------+-------+ | Memory(%) | 31.03 | | Load(%) | 31.03 | | Store(%) | 0.0 | | Scalar(%): | 42.27 | | Integer(%) | 42.26 | | Floating Point(%) | 0.01 | | Vector(%) | 0.02 | | Advanced SIMD(%) | 0.02 | | SVE(+loads/stores)(%): | 0.0 | | SME(retired)(%): | 0.0 | | Integer(%) | 0.0 | | Floating Point(%) | 0.0 | | Crypto(%) | 0.0 | | Branches(%) | 13.5 | | Immediate(%) | 13.1 | | Return(%) | 0.18 | | Indirect(%) | 0.22 | | Barriers(%) | 0.02 | | Instruction Synchronization(%) | 0.0 | | Data Synchronization(%) | 0.0 | | Data Memory(%) | 0.02 | | Not Retired(%) | 13.16 | +----------------------------------+-------+ Load_avg Summary Data (System wide) +--------------+--------------+---------------+ | recent 1 min | recent 5 min | recent 15 min | +--------------+--------------+---------------+ | 2.76 | 2.9 | 2.82 | +--------------+--------------+---------------+ Softirqs Summary Data (System wide) +----------+----------+---------+---------+---------+ | NET_TX/s | NET_RX/s | BLOCK/s | SCHED/s | CPU-NUM | +----------+----------+---------+---------+---------+ | 0 | 0 | 0 | 3 | 256 | +----------+----------+---------+---------+---------+ CPU_stat Summary Data (System wide) +----------------+--------------+-------------------+ | ctx_switches/s | interrupts/s | soft_interrupts/s | +----------------+--------------+-------------------+ | 7738.0 | 48489.0 | 1631.0 | +----------------+--------------+-------------------+ ... IO_info Summary Data (System wide) +--------------+-------+-------+--------+-------+---------+--------+-------+-------+ | BLOCK DEVICE | tps | rkB/s | wkB/s | dkB/s | areq-sz | aqu-sz | await | %util | +--------------+-------+-------+--------+-------+---------+--------+-------+-------+ | sdb | 5.0 | 0.0 | 195.21 | 0.0 | 10.68 | 0.0 | 0.08 | 0.24 | | sdb1 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | | sdb2 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | | sdb3 | 4.6 | 0.0 | 195.21 | 0.0 | 13.81 | 0.0 | 0.1 | 0.2 | | sda | 0.3 | 0.0 | 1.6 | 0.0 | 0.53 | 0.0 | 0.0 | 0.04 | | sda1 | 0.2 | 0.0 | 1.6 | 0.0 | 0.8 | 0.0 | 0.0 | 0.04 | | dm-0 | 10.11 | 0.0 | 196.41 | 0.0 | 4.66 | 0.0 | 0.03 | 0.2 | | dm-1 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | | dm-2 | 0.5 | 0.0 | 2.0 | 0.0 | 0.4 | 0.0 | 0.0 | 0.04 | +--------------+-------+-------+--------+-------+---------+--------+-------+-------+ ============================================================================================Net Metrics============================================================================================= Net_info Summary Data (System wide) +-------------+---------+---------+--------+--------+---------+---------+----------+---------+ | IFACE | rxpck/s | txpck/s | rxkB/s | txkB/s | rxcmp/s | txcmp/s | rxmcst/s | %ifutil | +-------------+---------+---------+--------+--------+---------+---------+----------+---------+ | eno1 | 21.61 | 30.31 | 1.64 | 3.61 | 0.0 | 0.0 | 0.0 | 0.0 | | eno2 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | | eno3 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | | eno4 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | | docker0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | | vethca66367 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | +-------------+---------+---------+--------+--------+---------+---------+----------+---------+ Starting to save data. You can press Ctrl+C to stop, and no results will be saved. Data saved successfully at /home/test/2026_01_22_19_51_22_report.json Use the --verbose option for detailed metric explanations.
After the collection is complete, a terminal report and a JSON performance data file (/home/test/2026_01_22_19_51_22_report.json) are generated. The terminal report displays multi-dimensional metrics such as CPU and memory access. It can be observed that the context switch frequency of the current server is high (ctx_switches/s is 7738.0), and the DDRC bandwidth is low (between 0 MB/s and 30 MB/s). This indicates that compute-intensive services are running in the current environment.
- Analyze the generated performance data file and generate an Excel report.
1./ksys report -i /home/test/2026_01_22_19_51_22_report.json -o /home/test/
- 2026_01_22_19_51_22_report.json is the JSON file generated by running the ksys collect command.
- After the analysis is complete, the summary data is printed and saved together with the time series data to an Excel file.
- The time series data is displayed in a line chart or area chart. The time lines in each chart are aligned.
Command output:
Analyzing system data... Please wait. ==================================================== Time : 2026/01/22 19:52:37 Version : DevKit xxx Model Name : HUAWEI Kunpeng 920 V200 7270Z Command : ksys collect -d 10 -i 1 -o /home/test/ ==================================================== ============================================================================================CPU Metrics============================================================================================= Common Microarchitecture Metrics Summary Data (System wide) +------+--------------+------+------+----------+----------+----------+----------+-----------+-----------+---------+ | IPC | INSTRUCTIONS | MPKI | BPKI | L1D MPKI | L1I MPKI | L2D MPKI | L2I MPKI | DTLB MPKI | ITLB MPKI | CPU-NUM | +------+--------------+------+------+----------+----------+----------+----------+-----------+-----------+---------+ | 0.51 | 152795353756 | 1.07 | 0.24 | 1.1 | 0.42 | 0.66 | 0.1 | 1.24 | 0.1 | 256 | +------+--------------+------+------+----------+----------+----------+----------+-----------+-----------+---------+ Topdown Summary Data (System wide) +----------------------------+-------+ | Metric | Value | +----------------------------+-------+ | Retiring(%) | 8.14 | | Frontend Bound(%) | 5.52 | | Fetch Latency Bound(%) | 3.37 | | Fetch Bandwidth Bound(%) | 2.15 | | Bad Speculation(%) | 1.56 | | Branch Mispredicts(%) | 0.16 | | Machine Clears(%) | 1.4 | | Backend Bound(%) | 84.78 | | Core Bound(%) | 48.03 | | Memory Bound(%) | 36.75 | | CPU-NUM | 256 | +----------------------------+-------+ OS Metrics Summary Data (System wide) +------------------+------------+-------------+---------+ | context-switches | migrations | page-faults | CPU-NUM | +------------------+------------+-------------+---------+ | 88074 | 186 | 26284 | 256 | +------------------+------------+-------------+---------+ INSTRUCTION Summary Data (System wide) +----------------------------------+-------+ | Metric | Value | +----------------------------------+-------+ | Memory(%) | 31.03 | | Load(%) | 31.03 | | Store(%) | 0.0 | | Scalar(%): | 42.27 | | Integer(%) | 42.26 | | Floating Point(%) | 0.01 | | Vector(%) | 0.02 | | Advanced SIMD(%) | 0.02 | | SVE(+loads/stores)(%): | 0.0 | | SME(retired)(%): | 0.0 | | Integer(%) | 0.0 | | Floating Point(%) | 0.0 | | Crypto(%) | 0.0 | | Branches(%) | 13.5 | | Immediate(%) | 13.1 | | Return(%) | 0.18 | | Indirect(%) | 0.22 | | Barriers(%) | 0.02 | | Instruction Synchronization(%) | 0.0 | | Data Synchronization(%) | 0.0 | | Data Memory(%) | 0.02 | | Not Retired(%) | 13.16 | +----------------------------------+-------+ Load_avg Summary Data (System wide) +--------------+--------------+---------------+ | recent 1 min | recent 5 min | recent 15 min | +--------------+--------------+---------------+ | 2.76 | 2.9 | 2.82 | +--------------+--------------+---------------+ ... IO_info Summary Data (System wide) +--------------+-------+-------+--------+-------+---------+--------+-------+-------+ | BLOCK DEVICE | tps | rkB/s | wkB/s | dkB/s | areq-sz | aqu-sz | await | %util | +--------------+-------+-------+--------+-------+---------+--------+-------+-------+ | sdb | 5.0 | 0.0 | 195.21 | 0.0 | 10.68 | 0.0 | 0.08 | 0.24 | | sdb1 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | | sdb2 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | | sdb3 | 4.6 | 0.0 | 195.21 | 0.0 | 13.81 | 0.0 | 0.1 | 0.2 | | sda | 0.3 | 0.0 | 1.6 | 0.0 | 0.53 | 0.0 | 0.0 | 0.04 | | sda1 | 0.2 | 0.0 | 1.6 | 0.0 | 0.8 | 0.0 | 0.0 | 0.04 | | dm-0 | 10.11 | 0.0 | 196.41 | 0.0 | 4.66 | 0.0 | 0.03 | 0.2 | | dm-1 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | | dm-2 | 0.5 | 0.0 | 2.0 | 0.0 | 0.4 | 0.0 | 0.0 | 0.04 | +--------------+-------+-------+--------+-------+---------+--------+-------+-------+ ============================================================================================Net Metrics============================================================================================= Net_info Summary Data (System wide) +-------------+---------+---------+--------+--------+---------+---------+----------+---------+ | IFACE | rxpck/s | txpck/s | rxkB/s | txkB/s | rxcmp/s | txcmp/s | rxmcst/s | %ifutil | +-------------+---------+---------+--------+--------+---------+---------+----------+---------+ | eno1 | 21.61 | 30.31 | 1.64 | 3.61 | 0.0 | 0.0 | 0.0 | 0.0 | | eno2 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | | eno3 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | | eno4 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | | docker0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | | vethca66367 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | 0.0 | +-------------+---------+---------+--------+--------+---------+---------+----------+---------+ Save statistics and time series data to an Excel file. Please wait. The report has been saved to /home/test/2026_01_22_19_52_37_report.xlsx
After the analysis task is complete, a terminal report and an Excel file (/home/test/2026_01_22_19_52_37_report.xlsx) are generated. The Excel file contains multi-dimensional time series data (such as CPU and device data), and a visualized time series chart is generated.
- Run the comparison command to compare the performance differences and generate a comparison report.
1./ksys diff -i /home/test/2026_01_22_19_51_22_report.json /home/test/2026_01_22_19_53_45_report.json -o /home/test
2026_01_22_19_51_22_report.json and 2026_01_22_19_53_45_report.json are JSON files generated by running the ksys collect command. The data after comparison is saved in the Excel file in the /home/test/ directory.
Command output:
============================================================================================System Info============================================================================================= System Architecture diff: +--------------+-------------------------------+-------------------------------+------+ | Metric | Before | After | Diff | +--------------+-------------------------------+-------------------------------+------+ | Cpu Type | Kunpeng920 high-performance | Kunpeng920 high-performance | N/A | | Model Name | HUAWEI Kunpeng 920 V200 7270Z | HUAWEI Kunpeng 920 V200 7270Z | N/A | | Vendor ID | HiSilicon | HiSilicon | N/A | | Hyper Thread | False | False | N/A | | CPU-NUM | 256 | 256 | N/A | +--------------+-------------------------------+-------------------------------+------+ ============================================================================================CPU Metrics============================================================================================= Common Microarchitecture Metrics diff: +--------------+--------------+--------------+---------+ | Metric | Before | After | Diff | +--------------+--------------+--------------+---------+ | IPC | 0.51 | 0.51 | +0.00% | | MPKI | 1.07 | 1.18 | +10.28% | | BPKI | 0.24 | 0.35 | +45.83% | | L1D MPKI | 1.1 | 1.19 | +8.18% | | L1I MPKI | 0.42 | 0.52 | +23.81% | | L2D MPKI | 0.66 | 0.74 | +12.12% | | L2I MPKI | 0.1 | 0.11 | +10.00% | | DTLB MPKI | 1.24 | 1.51 | +21.77% | | INSTRUCTIONS | 152795353756 | 151352935542 | -0.94% | | ITLB MPKI | 0.1 | 0.14 | +40.00% | +--------------+--------------+--------------+---------+ Topdown diff: +----------------------------+--------+-------+---------+ | Metric | Before | After | Diff | +----------------------------+--------+-------+---------+ | Retiring(%) | 8.14 | 8.12 | -0.25% | | Frontend Bound(%) | 5.52 | 5.88 | +6.52% | | Fetch Bandwidth Bound(%) | 2.15 | 2.14 | -0.47% | | Fetch Latency Bound(%) | 3.37 | 3.74 | +10.98% | | Bad Speculation(%) | 1.56 | 1.57 | +0.64% | | Branch Mispredicts(%) | 0.16 | 0.19 | +18.75% | | Machine Clears(%) | 1.4 | 1.38 | -1.43% | | Backend Bound(%) | 84.78 | 84.43 | -0.41% | | Core Bound(%) | 48.03 | 47.67 | -0.75% | | Memory Bound(%) | 36.75 | 36.76 | +0.03% | +----------------------------+--------+-------+---------+ OS Metrics diff: +------------------+--------+-------+---------+ | Metric | Before | After | Diff | +------------------+--------+-------+---------+ | context-switches | 88074 | 93718 | +6.41% | | migrations | 186 | 300 | +61.29% | | page-faults | 26284 | 42116 | +60.23% | +------------------+--------+-------+---------+ INSTRUCTION diff: +----------------------------------+--------+-------+---------+ | Metric | Before | After | Diff | +----------------------------------+--------+-------+---------+ | Memory(%) | 31.03 | 31.4 | +1.19% | | Load(%) | 31.03 | 31.4 | +1.19% | | Store(%) | 0.0 | 0.0 | +0.00% | | Scalar(%): | 42.27 | 40.46 | -4.28% | | Integer(%) | 42.26 | 40.45 | -4.28% | | Floating Point(%) | 0.01 | 0.01 | +0.00% | | Vector(%) | 0.02 | 0.03 | +50.00% | | Advanced SIMD(%) | 0.02 | 0.03 | +50.00% | | SVE(+loads/stores)(%): | 0.0 | 0.0 | +0.00% | | SME(retired)(%): | 0.0 | 0.0 | +0.00% | | Integer(%) | 0.0 | 0.0 | +0.00% | | Floating Point(%) | 0.0 | 0.0 | +0.00% | | Crypto(%) | 0.0 | 0.0 | +0.00% | | Branches(%) | 13.5 | 13.97 | +3.48% | | Immediate(%) | 13.1 | 13.42 | +2.44% | | Return(%) | 0.18 | 0.24 | +33.33% | | Indirect(%) | 0.22 | 0.31 | +40.91% | | Barriers(%) | 0.02 | 0.02 | +0.00% | | Instruction Synchronization(%) | 0.0 | 0.0 | +0.00% | | Data Synchronization(%) | 0.0 | 0.0 | +0.00% | | Data Memory(%) | 0.02 | 0.02 | +0.00% | | Not Retired(%) | 13.16 | 14.12 | +7.29% | +----------------------------------+--------+-------+---------+ Load_avg diff: +---------------+--------+-------+--------+ | Metric | Before | After | Diff | +---------------+--------+-------+--------+ | recent 1 min | 2.76 | 2.62 | -5.07% | | recent 5 min | 2.9 | 2.77 | -4.48% | | recent 15 min | 2.82 | 2.78 | -1.42% | +---------------+--------+-------+--------+ Softirqs diff: +----------+--------+-------+---------+ | Metric | Before | After | Diff | +----------+--------+-------+---------+ | NET_TX/s | 0 | 0 | +0.00% | | NET_RX/s | 0 | 0 | +0.00% | | BLOCK/s | 0 | 0 | +0.00% | | SCHED/s | 3 | 4 | +33.33% | +----------+--------+-------+---------+ CPU_stat diff: +-------------------+---------+---------+--------+ | Metric | Before | After | Diff | +-------------------+---------+---------+--------+ | ctx_switches/s | 7738.0 | 8353.0 | +7.95% | | interrupts/s | 48489.0 | 48774.0 | +0.59% | | soft_interrupts/s | 1631.0 | 1773.0 | +8.71% | +-------------------+---------+---------+--------+ ... Net_info Network Device vethca66367 diff: +----------+--------+-------+--------+ | Metric | Before | After | Diff | +----------+--------+-------+--------+ | rxpck/s | 0.0 | 0.0 | +0.00% | | txpck/s | 0.0 | 0.0 | +0.00% | | rxkB/s | 0.0 | 0.0 | +0.00% | | txkB/s | 0.0 | 0.0 | +0.00% | | rxcmp/s | 0.0 | 0.0 | +0.00% | | txcmp/s | 0.0 | 0.0 | +0.00% | | rxmcst/s | 0.0 | 0.0 | +0.00% | | %ifutil | 0.0 | 0.0 | +0.00% | +----------+--------+-------+--------+ ==============================================================================================Top diff============================================================================================== Top diff: ---------------------------------------------------------------------------------------------------------------- Note: At most 20 Top diffs are listed, please check the generated xlsx file for the rest of report. +-------------+------------------------------+------------------+----------+----------+----------+-------------+ | Table Group | Metric Type/Metric Device | Metric | Before | After | Diff | Diff(value) | +-------------+------------------------------+------------------+----------+----------+----------+-------------+ | HHA | HHA DEVICE hisi_sccl11_hha3 | rx_ops_num | 210977.4 | 342261.4 | +62.23% | 131284.0 | | HHA | HHA DEVICE hisi_sccl11_hha0 | rx_ops_num | 211826.6 | 340646.2 | +60.81% | 128819.6 | | HHA | HHA DEVICE hisi_sccl11_hha2 | rx_ops_num | 203417.4 | 332189.6 | +63.30% | 128772.2 | | HHA | HHA DEVICE hisi_sccl11_hha1 | rx_ops_num | 202916.8 | 329660.0 | +62.46% | 126743.2 | | HHA | HHA DEVICE hisi_sccl9_hha0 | rx_ops_num | 213699.4 | 326738.0 | +52.90% | 113038.6 | | OS | OS Metrics | page-faults | 26284 | 42116 | +60.23% | 15832 | | OS | OS Metrics | migrations | 186 | 300 | +61.29% | 114 | | IO_info | IO_info Summary | Total wkB/s | 592.03 | 50.03 | -91.55% | 542.0 | | IO_info | IO_info IO Device dm-0 | wkB/s | 196.41 | 11.6 | -94.09% | 184.81 | | IO_info | IO_info IO Device sdb | wkB/s | 195.21 | 10.8 | -94.47% | 184.41 | | IO_info | IO_info IO Device sdb3 | wkB/s | 195.21 | 10.8 | -94.47% | 184.41 | | IO_info | IO_info Summary | Total tps | 20.71 | 7.5 | -63.79% | 13.21 | | PA | PA DEVICE hisi_sicl2_pa0 | PA2Ring MB/s | 79.05 | 167.61 | +112.03% | 88.56 | | PA | PA DEVICE hisi_sicl2_pa0 | Ring2PA MB/s | 84.41 | 146.56 | +73.63% | 62.15 | | PA | PA DEVICE hisi_sicl10_pa0 | PA2Ring MB/s | 95.84 | 147.55 | +53.95% | 51.71 | | PA | PA DEVICE hisi_sicl2_pa0 | Ring2PA_lk0 MB/s | 48.48 | 84.76 | +74.83% | 36.28 | | PA | PA DEVICE hisi_sicl2_pa0 | Ring2PA_lk1 MB/s | 5.46 | 8.35 | +52.93% | 2.89 | | Net_info | Net_info Summary | Total txkB/s | 3.61 | 5.71 | +58.17% | 2.1 | | Net_info | Net_info Network Device eno1 | txkB/s | 3.61 | 5.71 | +58.17% | 2.1 | | Net_info | Net_info Summary | Total %ifutil | 0.0 | 0.01 | +inf% | 0.01 | +-------------+------------------------------+------------------+----------+----------+----------+-------------+ Data has been saved to /home/test/2026_01_22_19_54_59_diff.xlsxThe data after comparison is stored in the /home/test/2026_01_22_19_54_59_diff.xlsx file. The summary data collected twice is analyzed, and a Top Diff report is generated to identify the metric with the largest difference. The current report shows that the bandwidth difference is significant between the two rounds of collection for PA device hisi_sicl2_pa0.
Parent topic: Kunpeng Performance Boundary Analyzer