BTrace介绍和生产环境例子
BTrace latest realese：
release-1.2.5.1
BTrace guide（1.2-20101020）：
http://kenai.com/projects/btrace/pages/UserGuide
例子：在压缩包内有。
一／简单介绍
BTrace 是一个可靠的，用来动态跟踪Java程序的工具。它通过动态对运行中的Java程序进行字节码生成来工作。BTrace会对运行中的Java程序的类插入一些跟踪操作 来对被跟踪的程序进行热替换。
BTrace 名词
探测点 (Probe Point)
就是一系列的跟踪语句被执行的“地方”或者“事件”。探测点就是我们想要执行一些跟踪语句的地方或者事件。
跟踪动作或简称动作 （Trace Actions）
就是那些当探测点被触发时所执行的跟踪语句。
动作方法
BTrace的跟踪语句是必须定义在一个类的某个静态方法里的，这个静态方法就叫“动作”方法。
BTrace 程序结构
一个BTrace程序就是一个普通的Java类，这个类至少有一个这样的方法：
public static void ***
其次这个方法还需要加上BTrace相关的注解。这些注解用来指明被跟踪程序的“位置”（也就是前面提到的探测点）。跟踪动作需要在这个静态方法的方法体里指定。这些（注意，可以有多个）静态方法就是所谓的“动作”方法。
BTrace的限制
为了保证跟踪动作是“只读”的（也就是这些动作不可以修改被跟踪程序的状态）和有限度的（比如在固定时间里结束）。一个BTrace程序只允许完成一些指定的动作。下面是BTrace一些不可以完成的事情：
- 不能创建新的对象
- 不能创建新的数组
- 不能抛出异常
- 不能捕获异常
- 不能进行任何的实例函数或者静态函数 -- 只有com.sun.btrace.BTraceUtils类中的静态函数或者BTrace程序自己声明的
- 函数才可以被BTrace调用
- 对1.2版本以前的程序，不能由实例级别的field和函数。只有静态公开的并且无返回值的函数才允许在BTrace类中使用。所有
- 不可以在目标程序的类，或者对象的静态或者实例级别的field进行赋值。但是，BTrace自身的类是可以给它的静态field进行赋值的。
- （也就是意味着跟踪的状态时可以更改的）
- 不能有outer，inner,嵌套的或者本地类。
- 不能有同步代码块或者同步的函数
- 不能有循环语句（for,while, do..while）
- 不能继承其它类（父类只能是java.lang.Object）
- 不能实现接口
- 不能包含断言(assert)语句
- can NOT use class literals （这个我也没搞明白是啥意思）
二／具体例子
现网碰到问题，目前需要拦截框架请求，并判断req中storeId字段为11008时，输出其他参数，方便进一步查问题。
需要拦截的类结构如图：
需要拦截match方法，match方法这里有好几个重载方法，目前只需要拦截第一个。
btrace代码：
（补充一点：在btrace代码中，没法去调用非BTraceUtils之外的方法，也就是说，要输出类各字段信息是没法通过toString()方法，因为调用instance.toString（）方法是不安全，编译fail，需要自己去解析每个字段值）
package btrace;
import com.sun.btrace.AnyType;
import com.sun.btrace.annotations.*;
import java.lang.reflect.Field;
import static com.sun.btrace.BTraceUtils.*;
/**
* Created by vernonzheng on 14-8-15.
*/
@BTrace
public class FrameFilterTrace {
@OnMethod(
clazz="com.skymobi.market.applist.service.imp.CustomizedFrameMatcher",
method="match",
type = "com.skymobi.market.applist.entity.FrameStorageMetadata (com.skymobi.market.applist.bean.common.TlvCommonHeaderReq)"
)
public static void onMatch(AnyType request){
Class frameRequestCl = classOf(request);
String storeId = getVal("storeId",frameRequestCl, request);
Class tlvCommentHeaderReqCl = getSuperclass(frameRequestCl);
Class networkTrackCl = getSuperclass(tlvCommentHeaderReqCl);
Class terminalRequestCl = getSuperclass(networkTrackCl);
if(storeId!=null){
if(compare(storeId,"10118")){
//asHsman,asHstype,bizSource,sessionId,channelNo,storeId,clientVer,hsman,hstype,mnc,imsi,
//networkType,capability
println(strcat("vernon----store_id=10118--输出参数 : ", str(request)));
println(strcat("storeId:",storeId));
println(strcat("channelNo:",getVal("channelNo",frameRequestCl,request)));
println(strcat("asHsman:",getVal("asHsman",frameRequestCl,request)));
println(strcat("asHstype:",getVal("asHstype",frameRequestCl,request)));
println(strcat("bizSource:",getVal("bizSource",tlvCommentHeaderReqCl,request)));
println(strcat("sessionId:",getVal("sessionId",tlvCommentHeaderReqCl,request)));
println(strcat("clientVer:",getVal("clientVer",tlvCommentHeaderReqCl,request)));
println(strcat("hsman:",getVal("hsman",terminalRequestCl,request)));
println(strcat("hstype:",getVal("hstype",terminalRequestCl,request)));
println(strcat("mnc:",getVal("mnc",terminalRequestCl,request)));
println(strcat("imsi:",getVal("imsi",terminalRequestCl,request)));
println(strcat("networkType:",getVal("networkType",terminalRequestCl, request)));
println("----------------------------------------------------------");
}
}
}
private static String getVal(String filedName,Class cl,AnyType instance){
Field field = field(classOf(cl), filedName, false);
if(field!=null) {
return str(get(field, instance));
}else{
return "is null";
}
}
}把FrameFilterTrace.java 和下载好的btrace-bin .tar.gz丢到现网上，解压btrace-bin .tar.gz，
把FrameFilterTrace.java拷贝到bin目录，
vi btrace脚本，在头上加上（export BTRACE_HOME=解压路径），如果JAVA_HOME没有设置，也export一下。
然后jps，找到jvm PID，
执行btrace PID FrameFilterTrace.java > catch.log
完成！
输出如图：
参考：
https://kenai.com/projects/btrace/pages/UserGuide
http://linmingren2003.blog.163.com/blog/static/56751003201121871725139/
http://www.stacktrace.cn/?p=28