一、下載btrace

可以下載它的原始碼包，它的原始碼包是一個gradle專案

如果只想使用它排查問題，也可以直接下載它的bin包，下載地址

可以直接通過這個連結下載1.3.8版本的btrace

二、配置環境變數

解壓完成後需要配置環境變數BTRACE_HOME

export BTRACE_HOME=/home/work/btrace/
export PATH=$PATH:$BTRACE_HOME/bin

三、編寫btrace指令碼

比如我們監控spring-data-redis出現異常的時候，列印入參和異常堆疊資訊：

package com;
import com.sun.btrace.AnyType;
import com.sun.btrace.annotations.*;
import static com.sun.btrace.BTraceUtils.*;
import com.alibaba.fastjson.JSON;

@BTrace(unsafe=true)
public class Trace {

    @OnMethod(clazz = "org.springframework.data.redis.core.DefaultHashOperations", method = "putAll", location 
 
[email protected](Kind.ERROR)) 
    public static void putAll(Throwable exception,AnyType[] args){
	 println("\n##################################@#####DefaultHashOperations");	
	 println(JSON.toJSONString(args));
	 println(JSON.toJSONString(exception));
	 println("\[email protected]@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@");	
    }

    @OnMethod(clazz = "org.springframework.data.redis.core.DefaultSetOperations", method = "add", location 
 
[email protected](Kind.ERROR)) 
    public static void add(Throwable exception,AnyType[] args){
	 println("\n##################################@#####DefaultSetOperations");	
	 println(JSON.toJSONString(args));
	 println(JSON.toJSONString(exception));
	 println("\[email protected]@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@");	
    }
}
 

四、執行指令碼:

./btrace -cp /home/work/btrace/bin/fastjson-1.2.29.jar -p 2021 5941 Trace.java

說明:
1. -cp  /home/work/btrace/bin/fastjson-1.2.29.jar  指定classpath，因為引入了fastjson對引數序列化成json字串後輸出，所以這裡加入了fastjson的jar包;

2. -p 2021 btrace預設埠為2020，這裡更改了預設埠；

3. 5941是要追蹤的jvm程序的程序id;

4. Trace.java 是第三步編寫的java指令碼的檔名；

異常說明

1. Port 2020 unavailable.  
btrace會在remote JVM  agent開啟一個遠端socketserver，預設埠是2020，正好如果一臺臺伺服器有多個JVM例項需要使用btrace，當在第一個JVM上執行btrace命令後，再從其他jvm例項上執行btrace就會報錯。這時候就可以使用-p引數指定埠；

2. method calls are not allowed - only calls to BTraceUtils are allowed

原因是btrace存在安全限制，不允許呼叫com.sun.btrace.BTraceUtils這個類中提供的方法以外的方法。但是我的指令碼中使用的fastjson來講物件轉換為json字串打印出來，所以需要解除安全限制；

3. Unable to open socket file: target process not responding or HotSpot VM not loaded

執行btrace的使用者必須和啟動jvm程序的使用者是同一個

正確的姿勢解除安全限制

網上提供了很多種方解除安全限制的方式都不靠譜,例如：

1. 使用 -u    ；

2. 給btrace設定jvm引數 -Dcom.sun.btrace.unsafe=true

如果，按上面兩種方式是無法解除安全限制的，正確的解除安全限制的姿勢是給btrace的jvm啟動指令碼添加了

-Dcom.sun.btrace.unsafe=true引數後，還需要在java指令碼類的@Btrace註解上加上unsafe=true：

@BTrace(unsafe=true)