BTrace 是什麼？
BTrace 是一個動態安全的 Java 追蹤工具，它通過向運行中的 Java 程序植入字節碼文件，來對運行中的 Java 程序熱更新，方便的獲取程序運行時的數據信息，並且，保證自己的消耗特別小，大部分情況下不會影響 Java 程序的性能。
BTrace 能幹什麼？
相信每一位開發都或多或少的幹過這檔子事：為了解決線上的一個 bug，不得不在代碼中打印下入參、出參數據，然後再重啟服務器，觀察日誌。BTrace 的出現就是為了解決這類事宜，BTrace 的最大好處，是可以通過自己編寫的腳本，獲取應用的一切調用信息，而不需要不斷的修改代碼，然後重啟應用。
以下是 BTrace 的一些典型應用場景：
- 服務慢，能找出慢在哪一步，哪個函數里麼？
- 誰調用了System.gc()，調用棧如何？
- 誰構造了一個超大的 ArrayList?
- 什麼樣的入參或對象屬性，導致拋出了這個異常？或進入了這個處理分支？
BTrace 快速開始
下載最新的 BTrace releases 版本：https://github.com/btraceio/btrace/releases
解壓文件夾，在 /bin 目錄下主要有兩個命令：一個是 btrace，一個是 btracec。
btrace
<code>BTRACE_HOME/bin/btrace PID /<code>
btrace 將通過 JVM Attach API 連接到 的 java 應用程序，然後把腳本綁定到應用進程，進行 AOP 式的代碼植入。
btracec
<code>BTRACE_HOME/bin/btracec /<code>
類似於 javac，btracec 命令是用來預編譯腳本的，以此校驗腳本語法的正確性，要不然等運行到線上才發現寫錯就尷尬了。
BTrace 腳本
寫到這裡，唯一能阻礙我們繼續下去的，就是怎麼寫 BTrace 腳本了。
首先，推薦在集成工具（IDEA、Eclipse）中編寫 BTrace 腳本，引入 BTrace 的依賴：
<code> com.sun.tools.btrace btrace-agent 1.2.3 jar system D:\btace\libs\btrace-agent.jar com.sun.tools.btrace btrace-boot 1.2.3 jar system D:\btace\libs\btrace-boot.jar com.sun.tools.btrace btrace-client 1.2.3 jar system D:\btace\libs\btrace-client.jar /<code>
先來看一個簡單的 Demo 示例：
<code>@BTrace//表示這是一個BTrace跟蹤腳本
public class Hello {
@OnMethod(clazz = "org.jvm.demo.chapter4.btrace.BtraceCase", // 全類名
method = "add", // 方法名
location = @Location(Kind.RETURN) // 表示跟蹤某個類的某個方法，位置為方法返回處
)
public static void run(@Self Object self, int a, int b, // 入參，按順序定義
@Return int result, // 出參
@Duration long time // 方法耗時
) {
BTraceUtils.print("打印入參, a = " + a + ",b=" + b);
BTraceUtils.print("打印出參, result = " + result);
BTraceUtils.print("打印耗時，time = " + time);
}
}/<code><code>btrace.bat 4284 src/main/java/org/jvm/demo/chapter4/btrace/Hello.java/<code>
BTrace 主要有兩類註解需要學習，一類是探測方法的註解，像上面的 @OnMethod 註解，類似的還有 @OnTimer、@OnError、@OnExit、@OnEvent、@OnLowMemory、@OnProbe 等等；另一類是
探測方法參數的註解，像上面的 @Return、@Duration、@Self，類似的還有 @ProbeMethodName、@ProbeClassName、@TargetInstance、@TargetMethodOrField 等等本文不過分說明 BTrace 的語法，私以為平常遇到什麼樣的業務場景，邊學邊用就是了，以下是官方的一些 BTrace 資料：
- BTrace Github Wiki（https://github.com/btraceio/btrace/wiki）
- BTrace User's Guide（https://zcfy.cc/original/btrace-wiki-userguide-mdash-project-kenai-952.html）
由於 BTrace 的安全和性能考慮，一般情況下不允許在探查方法中調用 BTraceUtils 以外的其它方法，但可使用 unsafe 模式。
BTrace 植入過的代碼，會一直在，直到應用重啟為止。所以即使 Btrace 退出了，業務函數每次執行時都會多出一次 Btrace 是否 Attach 狀態的判斷。
為了保證程序的安全，BTrace對編寫的腳本進行了一些限制，比如不允許在腳本中創建對象，不允許在腳本中拋出異常等，更詳細的限制請參考 BTrace 使用限制。
關鍵字: 性能 jar BTraceUtils
