BTrace とは
BTrace は、スクリプトを作成することでプログラムの実行中にすべての情報を取得できるキラー ツールです。はい、必要ありません。サービスを再起動します。スクリプトを記述した後は、元のプログラム コードに触れることなく、コマンドで直接実行できます。
原則
安装和配置
export JAVA_HOME=/home/fengzheng/soft/jdk1.8.0_111 export JRE_HOME=${JAVA_HOME}/jre export CLASSPATH=.:${JAVA_HOME}/lib:${JRE_HOME}/lib export PATH=${JAVA_HOME}/bin:$PATH export BTRACE_HOME=/home/fengzheng/soft/btrace export PATH=$PATH:$BTRACE_HOME/bin
简单测试用例
package kite.lab.utils; /** * NumberUtil * * @author fengzheng * @date 2017/2/15 */ public class NumberUtil { public int sum(){ int result = 0; for(int i = 0; i< 100; i++){ result += i * i; } return result; } public static void main(String[] args){ while (true) { Thread.currentThread().setName("计算"); NumberUtil util = new NumberUtil(); int result = util.sum(); System.out.println(result); try { Thread.sleep(5000); }catch (InterruptedException e){ } } } }
2. 执行上面的程序后,可用 jps
実際、BTrace は Java Attach api Agent.jar を添付し、スクリプト解析エンジン + asm を使用して指定したクラスのバイトコードを書き換え、その後、Instrument を使用して元のクラスを置き換えます。
インストールと構成
最初のステップは、github からリリース バージョン btrace-bin-1.3.9.tgz をダウンロードすることです。zip バージョンにはビルド ディレクトリがありません。
2 番目のステップでは、btrace-bin-1.3.9.tgz を/home/fengzheng/soft/btrace
などのディレクトリに解凍します。このステップで実際に使用できるようになります。スクリプトを実行するには、btrace コマンドの前に絶対パスを追加する必要があります。任意のディレクトリで実行できるようにするには、次のステップに進み、構成された環境変数に JAVA_HOME
と BTRACE_HOME
の例として、私の構成は次のとおりです:
次に、コマンド source /etc/profile を使用して、環境変数をすぐに有効にします。次に、任意のディレクトリで <code>btrace
コマンドを実行すると、正常に実行されます。
簡単なテストケース
btrace 最も単純な構文は btrace $pid script.java
なので、検出される Java
プログラムのプロセス ID を知る必要があります。 、そして、A 検出スクリプトを書きます。
Java
プログラムを作成します。ここでは、一連の計算結果を 5 秒ごとに出力する無限ループを作成します。 🎜🎜 🎜🎜 package kite; import com.sun.btrace.annotations.*; import static com.sun.btrace.BTraceUtils.Strings.strcat; import static com.sun.btrace.BTraceUtils.jstack; import static com.sun.btrace.BTraceUtils.println; import static com.sun.btrace.BTraceUtils.str; /** * NumberUtilBTrace * * @author fengzheng * @date 2017/6/20 */ @BTrace public class NumberUtilBTrace { @OnMethod( clazz="kite.lab.utils.NumberUtil", method="sum", location=@Location(Kind.RETURN) ) public static void func(@Return int result) { println("trace: ======================="); println(strcat("result:", str(result))); jstack(); } }🎜🎜🎜 ちなみに、コマンドラインから Java をコンパイルして実行するプロセス: 🎜🎜🎜🎜🎜🎜🎜コンパイル:
javac -d .java code> を選択し、NumberUtil .java を見つけてこのコマンド ラインを実行すると、パッケージ名に示されているディレクトリ構造が現在のディレクトリ (. は現在のディレクトリを示します)、kite/lab/utils/NumberUtil.class に生成されます🎜🎜🎜 🎜🎜🎜🎜🎜🎜<strong>実行</strong>: <code>java kite.lab.utils.NumberUtil
を実行してから 🎜🎜🎜🎜 🎜🎜 2. 上記のプログラムを実行すると、 jps
コマンドを使用して pid を表示します (通常、プログラムの起動に使用されるアカウントは、root アカウントを除く、jps の実行に使用されるアカウントによって異なります)。jps コマンドを実行すると、次の結果が表示されます。 🎜🎜🎜trace: ======================= result:328350 kite.lab.utils.NumberUtil.sum(NumberUtil.java:16) kite.lab.utils.NumberUtil.main(NumberUtil.java:27)🎜3. 実行されたJavaプロセスは10860であることがわかります。🎜🎜4. btraceスクリプトの内容は次のとおりです。 🎜🎜🎜🎜
@OnMethod(clazz="/javax\.swing\..*/", method="/.*/") public static void swingMethods( @ProbeClassName String probeClass, @ProbeMethodName String probeMethod) { print("entered " + probeClass + "." + probeMethod); }🎜は、実行が完了した後のことを意味します。 (location=@Location(Kind.RETURN) は実行の終了を示します)、結果とスタック情報が出力されます 🎜🎜🎜🎜5 . プリコンパイル: プリコンパイル コマンドを使用して、実行前にスクリプトの正しさを確認できます。コマンドは btracec で、これは javac に似たコマンドです。btracec NumberUtilBTrace.java🎜🎜🎜🎜🎜6. コマンド ラインの実行を呼び出します。btrace 10860 NumberUtilBTrace.java (ローカル ファイルに保存したい場合は、次のコマンドを使用できます)。リダイレクト コマンド btrace 10860 NumberUtilBTrace.java > mylog.log) 出力される情報は次のとおりです🎜🎜🎜🎜🎜🎜
@OnMethod(clazz = "com.kite.demo", location = @Location(value = Kind.LINE, line = 20)) public static void onBind() { println("执行到第20行"); }🎜7 🎜🎜 Ctrl + C を押すと終了プロンプトが表示され、もう一度 1 を押して終了します🎜🎜 🎜🎜使用シナリオ🎜
比如哪些方法执行太慢,例如监控执行时间超过1s的方法
查看哪些方法调用了 System.gc() ,调用栈是怎样的
查看方法参数或对象属性
哪些方法发生了异常
多说一点,为了更好解决问题,最好还要配合事前准备和进行中监控,事前准备就是埋点嘛,在一些可能出现问题的方法中进行日志输出,进行中监控就是利用一些实时监控工具,例如 VisualVM 、jmc 这些带界面的工具或者 jdk 提供的命令行工具等,再高级一点的就是利用 Graphite 这样的Metrics 工具配合 web 界面展示出来。
使用限制
BTrace class不能新建类, 新建数组, 抛异常, 捕获异常,
不能调用实例方法以及静态方法(com.sun.btrace.BTraceUtils除外)
不能将目标程序和对象赋值给BTrace的实例和静态field
不能定义外部, 内部, 匿名, 本地类
不能有同步块和方法
不能有循环
不能实现接口, 不能扩展类
不能使用assert语句, 不能使用class字面值
1. 精准定位
直接定位到一个类下的一个方法,上面测试用的例子就是
2. 正则表达式定位
正则表达式在两个"/" 之间,例如下面的例子,监控 javax.swing 包下的所有方法,注意正式环境中,范围尽可能小一点,太大了性能会有影响。
@OnMethod(clazz="/javax\\.swing\\..*/", method="/.*/") public static void swingMethods( @ProbeClassName String probeClass, @ProbeMethodName String probeMethod) { print("entered " + probeClass + "." + probeMethod); }
通过在拦截函数的定义里注入@ProbeClassName String probeClass, @ProbeMethodName String probeMethod 参数,告诉脚本实际匹配到的类和方法名。
3. 按接口或继承类定位
@OnMethod(clazz="+com.kite.base", method="doSome")
4. 按注解定位
在前面加上 @ 即可,例如@OnMethod(clazz="@javax.jws.WebService", method="@javax.jws.WebMethod")
拦截时机由 location 决定,当然也可为同一个定位加入多个拦截时机,即可以在进入方法时拦截、方法返回时拦截、抛出异常时拦截
1. Kind.Entry与Kind.Return
2. Kind.Error, Kind.Throw和 Kind.Catch
表示异常被 throw 、异常被捕获还有异常发生但是没有被捕获的情况,在拦截函数的参数定义里注入一个Throwable的参数,代表异常
@OnMethod(clazz = "com.kite.demo", location = @Location(value = Kind.LINE, line = 20)) public static void onBind() { println("执行到第20行"); }
@OnMethod(clazz = "java.net.ServerSocket", method = "bind", location =@Location(Kind.ERROR)) public static void onBind(Throwable exception, @Duration long duration){ }
3. Kind.Call 和 Kind.Line
Kind.Call 表示被监控的方法调用了哪些其他方法,例如:
@OnMethod(clazz = "com.kite", method = "login", location = @Location(value = Kind.CALL, clazz = "/.*/", method = "/.*/", where = Where.AFTER)) public static void onBind(@Self Object self, @TargetInstance Object instance, @TargetMethodOrField String method, @Duration long duration){ println(strcat("self: ", str(self))); println(strcat("instance: ", str(instance))); println(strcat("method: ", str(method))); println(strcat("duration(ms): ", str(duration / 1000000))); }
Kind.Line 监测类是否执行到了设置的行数,例如:
@OnMethod(clazz = "com.kite.demo", location = @Location(value = Kind.LINE, line = 20)) public static void onBind() { println("执行到第20行"); }
@OnMethod(clazz = "java.lang.System", method = "gc") public static void onSystemGC() { println("entered System.gc()"); jstack(); }
@OnMethod(clazz = "/com\\.kite\\.controller\\..*/",method = "/.*/",location = @Location(Kind.RETURN)) public static void slowQuery(@ProbeClassName String pcn,@ProbeMethodName String probeMethod, @Duration long duration){ if(duration > 1000000 * 100){ println(strcat("类:", pcn)); println(strcat("方法:", probeMethod)); println(strcat("时长:", str(duration / 1000000))); } }
以上がBTrace for Java のオンライン トラブルシューティングの詳細な説明の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。