鲲鹏社区首页
中文
注册
开发者
我要评分
获取效率
正确性
完整性
易理解
在线提单
论坛求助

report子命令

命令功能

显示历史报告或分析两份报告间的差异。

命令格式

1
./kspect report [-h] [-r REPORT] [-d DIFF [-t THRESHOLD]] [--diff_x86 DIFF_X86 [-t THRESHOLD]]

参数说明

表1 report子命令参数

参数

参数选项

参数说明

-h/--help

-

获取帮助信息,显示报告的历史记录。

-r/--report

报告序号

在历史记录中选择需展示的报告或输入报告路径(支持工具采集报告和使用diff/diff_x86后生成的对比报告),历史记录仅显示最近10个报告。

-d/--diff

  • 0
  • N
  • N,M
  • <INPUT_PATH>
  • <INPUT_PATH_A>,<INPUT_PATH_B>

选择需对比的两份报告,使用格式如下:

  • 0:生成新的报告,并和上一个报告比较。
  • N:生成新报告,与历史报告<N>比较。
  • N,M:比较历史报告<N>和报告<M>。
  • <INPUT_PATH>:生成新报告并与指定报告比较。
  • <INPUT_PATH_A>,<INPUT_PATH_B>:比较报告<A>和报告<B>。

--diff_x86

  • <X86_PATH>
  • N,<X86_PATH>
  • <INPUT_PATH>,<X86_PATH>

选择需要和x86报告对比的报告,当前支持perfspect report --all生成的x86报告(perfspect获取地址:https://github.com/intel/PerfSpect),使用格式如下:

  • <X86_PATH>:生成新报告并与输入的x86报告对比。
  • N,<X86_PATH>:比较历史报告号<N>和x86报告。
  • <INPUT_PATH>,<X86_PATH>:比较输入的采集报告和输入的x86报告。

-t/--threshold

非负数值

指定对比的阈值百分比,超过此阈值的数据会被标记,系统默认为20%(输入时无需添加“%”),只支持--diff/--diff_x86。

使用示例

  • 查看存在的历史报告。
    1
    ./kspect report -h
    
    • 使用-h参数可查看生成时间最近的十份报告记录,使用“./kspect report -r 报告序号”可查看对应序号的报告。
    • 若没有历史报告,请使用“./kspect all”生成第一份报告,或将已有报告移至工具路径下的output目录中,放入的报告需以“kspect-json-八位数字-六位数字.json”命名,例如:kspect-json-12345678-123456.json。
  • 使用最近的历史报告和x86报告进行对比。
    1
    ./kspect report --diff_x86 1,/home/kspect/perfspect/localhost.localdomain3.0.0.json -t 90
    
    • 参数“-t 90”表示对比报告中将标红差值超过90%的数据项。
    • 报告中的中括号内有数值且差值超过阈值时将标红显示,[--]表示无法计算阈值,也将标红显示。
    • 报告中[arm]为ARM报告独有数据,[x86]为x86报告独有数据,[common]表示两份报告中都有的内容,[same]表示两份报告的该数据相同。