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必须是静态的。

• 不可以在目标程序的类，或者对象的静态或者实例级别的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