ChkBugReport使用指南

一、ChkBugReport介绍

ChkBugReport是一个开源工具，它可以把你得到的bugreprot解析成适合阅读的html文件。导出的html文件包含了根据bugreport数据得出的图表和分析结论。

它用到了以下开源类库：

• jQuery
• jsTree jQuery plugin
• tablednd jQuery plugin
• tablesorter jQuery plugin
• js-hotkeys
• jquery-cookie

目前ChkBugReport可以从bugreport数据中抽取出如下信息：

1. Stacktraces ChkBugReport可以从bugreport中解析出输出bugreport的最后时刻、导致ANR时刻甚至更多时刻的堆栈信息。在 例子中你可以看到进程的优先级和策略都已标示出来，堆栈中耗时的部分颜色是黑红，一些违反Strict Mode的部分（比如主线程中使用数据库）颜色标记为亮红。如果这个线程死锁，在报告的Errors将会出现。
2. Logs 这部分是对system、main和kernel日志的分析，在这里你可以看到每个进程内存使用图、那个程序产生的log最多、Activity的启动耗时、数据库操作耗时统计、对象被锁定时间、AIDL调用时间、Activity和Service的生命周期及其在内存中使用频率等等， 详见
3. Packages ChkBugReport解析bugreport中存储的packages.xml并展示一系列的packages、user ids和 permissions。参加 例子
4. Processes 操作app过程中产生的系统事件日志、内存使用信息等等， 参见
5. Battery statistics 电池使用统计信息， 参见
6. CPU Frequency statistics CPU频率统计信息， 参见
7. Raw data 被分割成小段的原始数据

等等同时ChkBugReport也可以检测到（潜在的）错误，这些错误在输出的报告Errors中可以找到。你也可以在输出报告的stacktrace中找到死锁或一些违反Strict Mode的行为。

二、ChkBugReport使用

1、分析Bugreport文件

java -jar $HOME/Downloads/chkbugreport.jar $HOME/tmp/bugreport.txt

你也可以把chkbugreport.jar加到path下，然后这样使用,这将根据你的bugreport数据输出一个分析结果目录bugreport_out。

chkbugreport thebugreport.txt

你可以使用如下命令取得bugreport：

adb bugreport > bugreport.txt

2、分析BugReport的部分数据

当然你可以使用ChkBugReport分析bugreport的部分数据比如/data/anr/traces.txt

chkbugreport -sl:the_system_log.txt -sa:traces.txt dummy

这将输出分析结果到dummy_out。

3、分析profile文件

你甚至可以使用ChkBugReport分析traceview生成的数据

chkbugreport -t something.prof

附prof数据生成方法：

1. 可以使用eclipse插件traceview生成
2. 也可以按如下步骤
   • 用adb shell ps列出所有进程并找出你想要trace的进程的PID
   • 执行adb shell am profile PID start /data/profile.dat，开始分析
   • 操作你的app
   • 执行adb shell am profile PID stop ，停止分析
   • 导出数据并清除临时文件：adb pull /data/profile.dat adb shell rm /data/profile.dat
   • 使用ChkBugReport进行分析 chkbugreport -t profile.dat

4、分析monkey文件

chkbugreport -t something.prof
java -jar chkbugreport-0.4-164.jar output_file_name -mo:monkey.log

chkbugreport的常见参数如下：

参数	说明
-ds:file	分析dumsys输出(类似-pb)
-el:file	分析event日志
-ft:file	分析ftrace dump
-ml:file	分析main日志
-mo:file	分析monkey输出并提取堆栈信息
-pb:file	加载bugreport部分数据(例如dumpsys输出的数据)
-pk:file	加载packages.xml
-ps:file	分析 “processes”部分
-pt:file	分析”processes and threads”部分
-sa:file	分析”vm traces at last anr”部分
-sl:file	分析system日志
-sn:file	分析”vm traces just now”部分
-sd:dir	从指定目录加载部分bugreports
-uh:file	加载usage-history.xml

其他参数(较少使用):

不常用参数	说明
–browser	分析完后启动浏览器查看结果报告
–gui	不指定文件名则启动图形界面(开发中)
–silent	不输出非严重错误信息
–limit	限制要分析文件大小
–no-limit	不限制分析文件大小

三、相关参考

1. 开源工具 ChkBugReport介绍
2. ChkBugReport 源码
3. ChkBugReport最新jar包 下载
4. 使用ChkBugReport输出的报告参考例子
   • 进程死锁的简单 例子
   • 两个进程相互调用对方的AIDL导致阻塞的死锁 例子
   • 这个例子结合了上面两 例子（由于一进程调用AIDL阻塞造成另一线程死锁）