- 浏览: 253395 次
- 性别:
- 来自: 南京
文章分类
最新评论
-
lixia0417:
如果代理是使用命令行选项启动的,那么代理类还有一个要使用的 a ...
BTrace系列之五:实现原理 -
java_cache:
不错,讲得挺详细,果断收藏
Eclipse Debug不为人知的秘密 -
zhupeijun23:
有点懂了
HttpClient重定向 -
tss0823:
非常好的文章!
BTrace实际案例分析 -
763863446:
好好好,尽量不要用debug.
Eclipse Debug不为人知的秘密
BTrace工具简介
What is Btrace? |
Java进程诊断分析工具
安全的工具
无侵入性
不修改应用任何应用数据
限制跟踪行为,没能有循环
依赖组件
使用OjbectWeb ASM组件来完成字节码层面上的跟踪分析
开源组件
项目主页:http://btrace.dev.java.net
GPLv2 + CLASSPATH Exception
VisualVM 插件和开发时插件
BTrace应用较为广泛的原因应该是其安全性和无侵入性,已经热交互技术,使得我们无需启动Agent的情况下动态跟踪分析,其安全性不会导致对目标Java进程的任何破坏性影响,使得BTrace成为我们线上产品问题定位的利器。无侵入性无需我们对原有代码做任何修改,降低上线风险和测试成本,并且无需重启启动目标Java进程进行Agent加载即可动态分析和跟踪目标程序,可以说BTrace可以满足大部分的应用场景。
Probes and Actions |
通过注解来完成跟踪类型的支持
l 方法调用
l 方法返回
l 捕捉方法异常
l 行号
l 字段get/set
l 方法调用/返回(在指定的方法中)
l 异常抛出前后
l 同步进入/退出
l 定时器
BTrace脚本
为了保证trace语句只读, BTrace对trace脚本有一些限制(比如不能改变被trace代码中的状态),跟踪类中必须要有一个静态方法,主要是通过调用BTraceUtils类来完成一些动作,并且这些动作是安全的,是BTrace规定的一个子集,详见如下描述:
l BTrace禁止new类、数组,、抛异常、捕获异常
l 禁止调用除com.sun.btrace.BTraceUtil类的其他实例方法以及静态方法
l BTrace1.2前不能有实例字段和方法,只能有无返回值的静态方法,所有字段也都必须是静态的。
l 禁止定义外部、内部、匿名, 本地类
l 禁止有同步块和同步方法
l 禁止有循环(for, while, do..while)
l 禁止实现接口, 不能扩展类,直接超类必须是java.lang.Object
l 禁止使用assert语句, 不能使用class字面值
l 禁止使用class字节码
BTrace Class |
方法上的注解
l @ OnMethod 用来指定trace的目标类和方法以及具体位置, 被注解的方法在匹配的方法执行到指定的位置会被调用。"clazz"属性用来指定目标类名, 可以指定全限定类名, 比如"java.awt.Component", 也可以是正则表达式(表达式必须写在"//"中, 比如"/java\\.awt\\..+/")。"method"属性用来指定被trace的方法. 表达式可以参考自带的例子(NewComponent.java 和 Classload.java, 关于方法的注解可以参考MultiClass.java). 有时候被trace的类和方法可能也使用了注解. 用法参考自带例子WebServiceTracker.java. 针对注解也是可以使用正则表达式, 比如像这个"@/com\\.acme\\..+/ ",也可以通过指定超类来匹配多个类, 比如"+java.lang.Runnable"可以匹配所有实现了java.lang.Runnable接口的类. 具体参考自带例子SubtypeTracer.java。
l @OnTimer定时触发Trace,时间可以指定,单位为毫秒,具体参考自带例子 Histogram.java。
l @OnError 当trace代码抛异常或者错误时,该注解的方法会被执行. 如果同一个trace脚本中其他方法抛异常, 该注解方法也会被执行。
l @OnExit 当trace方法调用内置exit(int)方法(用来结束整个trace程序)时, 该注解的方法会被执行. 参考自带例子ProbeExit.java。
l @OnEvent 用来截获"外部"btrace client触发的事件, 比如按Ctrl-C 中断btrace执行时,并且选择2,或者输入事件名称,将执行使用了该注解的方法, 该注解的value值为具体事件名称。具体参考例子HistoOnEvent.java
l @OnLowMemory 当内存超过某个设定值将触发该注解的方法, 具体参考MemAlerter.java
l @OnProbe 使用外部文件XML来定义trace方法以及具体的位置,具体参考示例SocketTracker1.java和java.net.socket.xml。
参数上的注解
l @Self 用来指定被trace方法的this,可参考例子AWTEventTracer.java 和 AllCalls1.java
l @Return 用来指定被trace方法的返回值,可参考例子Classload.java
l @ProbeClassName (since 1.1) 用来指定被trace的类名, 可参考例子AllMethods.java
l @ProbeMethodName (since 1.1) 用来指定被trace的方法名, 可参考例子WebServiceTracker.java。
l @TargetInstance (since 1.1) 用来指定被trace方法内部被调用到的实例, 可参考例子AllCalls2.java
l @TargetMethodOrField (since 1.1) 用来指定被trace方法内部被调用的方法名, 可参考例子AllCalls1.java 和 AllCalls2.java。
非注解的方法参数
未使用注解的方法参数一般都是用来做方法签名匹配用的, 他们一般和被trace方法中参数出现的顺序一致. 不过他们也可以与注解方法交错使用, 如果一个参数类型声明为*AnyType[]*, 则表明它按顺序"通吃"方法所有参数. 未注解方法需要与*Location*结合使用:
l Kind.ENTRY-被trace方法参数
l Kind.RETURN- 被trace方法返回值
l Kind.THROW - 抛异常
l Kind.ARRAY_SET, Kind.ARRAY_GET - 数组索引
l Kind.CATCH - 捕获异常
l Kind.FIELD_SET - 属性值
l Kind.LINE - 行号
l Kind.NEW - 类名
l Kind.ERROR - 抛异常
属性上的注解
l @Export 该注解的静态属性主要用来与jvmstat计数器做关联. 使用该注解之后, btrace程序就可以向jvmstat客户端(可以用来统计jvm堆中的内存使用量)暴露trace程序的执行次数, 具体可参考例子ThreadCounter.java
l @Property 使用了该注解的trace脚本将作为MBean的一个属性, 一旦使用该注解, trace脚本就会创建一个MBean并向MBean服务器注册, 这样JMX客户端比如VisualVM, jconsole就可以看到这些BTrace MBean. 如果这些被注解的属性与被trace程序的属性关联, 那么就可以通过VisualVM 和jconsole来查看这些属性了. 具体可参考例子ThreadCounterBean.java 和 HistogramBean.java。
l @TLS 用来将一个脚本变量与一个ThreadLocal变量关联. 因为ThreadLocal变量是跟线程相关的, 一般用来检查在同一个线程调用中是否执行到了被trace的方法. 具体可参考例子OnThrow.java 和 WebServiceTracker.java
类上的注解
l @com.sun.btrace.annotations.DTrace 用来指定btrace脚本与内置在其脚本中的D语言脚本关联, 具体参考例子DTraceInline.java.
l @com.sun.btrace.annotations.DTraceRef 用来指定btrace脚本与另一个D语言脚本文件关联. 具体参考例子DTraceRefDemo.java.
l @com.sun.btrace.annotations.BTrace 用来指定该java类为一个btrace脚本文件.
BTrace Samples |
相关实例说明
BTrace自带的sample是学习BTrace的最后资料,熟练使用BTrace中提供的sample并且能够手动进行验证,可以快速的熟悉BTrace并加载应用,自带的sample也有很大一部分可以直接或者稍加修改就可以成为我们的定位脚本,方便使用。
l AWTEventTracer.java - 演示了对EventQueue.dispatchEvent()事件进行trace的做法, 可以通过instanceof来对事件进行过滤, 比如这里只针对focus事件trace.
l AllLines.java - 演示了如何在被trace的程序到达probe指定的类和指定的行号时执行指定的操作(例子中指定的行号是-1表示任意行).
l AllSync.java - 演示了如何在进入/退出同步块进行trace.
l ArgArray.java - 演示了打印java.io包下所有类的readXXX方法的输入参数.
l Classload.java - 演示打印成功加载指定类以及堆栈信息.
l CommandArg.java - 演示如何获取btrace命令行参数.
l Deadlock.java - 演示了@OnTimer注解和内置deadlock()方法的用法
l DTraceInline.java - 演示@DTrace注解的用法
l DTraceDemoRef.java - 演示@DTraceRef 注解的用法.
l FileTracker.java - 演示了如何对File{Input/Output}Stream构造函数中初始化打开文件的读写文件操作进行trace.
l FinalizeTracker.java - 演示了如何打印一个类所有的属性, 这个在调试和故障分析中非常有用. 这里的例子是打印FileInputStream类的close() /finalize() 方法被调用时的信息.
l Histogram.java - 演示了统计javax.swing.JComponent在一个应用中被创建了多少次.
l HistogramBean.java - 同上例, 只不过演示了如何与JMX集成, 这里的map属性通过使用@Property注解被暴露成一个MBean.
l HistoOnEvent.java - 同上例, 只不过演示了如何在通过按ctrl+c中断当前脚本时打印出创建次数, 而不是定时打印.
l JdbcQueries.java - 演示了聚合(aggregation)功能. 关于聚合功能可参考DTrace.
l JInfo.java - 演示了内置方法printVmArguments(), printProperties() 和printEnv() 的用法
l JMap.java - 演示了内置方法dumpHeap()的用法. 即将目标应用的堆信息以二进制的形式dump出来
l JStack.java - 演示了内置方法jstackAll()的用法, 即打印所有线程的堆栈信息.
l LogTracer.java - 演示了如何深入实例方法(Logger.log)并调用内置方法(field() )打印私有属性内容.
l MemAlerter.java - 演示了使用@OnLowMememory 注解监控内存使用情况. 即堆内存中的年老代达到指定值时打印出内存信息.
l Memory.java - 演示每隔4s打印一次内存统计信息.
l MultiClass.java - 演示了通过使用正则表达式对多个类的多个方法进行trace.
l NewComponent.java - 使用计数器每隔一段时间检查当前应用中创建java.awt.Component的个数.
l OnThrow.java - 当抛出异常时, 打印出异常堆栈信息.
l ProbeExit.java - 演示@OnExit注解和内置exit(int)方法的用法
l Profiling.java - 演示了对profile的支持. // 我执行没成功, BTrace内部有异常
l Sizeof.java - 演示了内置的sizeof方法的使用.
l SocketTracker.java - 演示了对socket的creation/bind方法的trace.
l SocketTracker1.java - 同上, 只不过使用了@OnProbe.
l SysProp.java - 演示了使用内置方法获取系统属性, 这里是对 java.lang.System的getProperty方法进行trace.
l SubtypeTracer.java - 演示了如何对指定超类的所有子类的指定方法进行trace.
l ThreadCounter.java - 演示了在脚本中如何使用jvmstat 计数器. (jstat -J-Djstat.showUnsupported=true -name btrace.com.sun.btrace.samples.ThreadCounter.count 需要这样来从外部通过jstat来访问)
l ThreadCounterBean.java - 同上, 只不过使用了JMX.
l ThreadBean.java - 演示了对预编译器的使用(并结合了JMX).
l ThreadStart.java - 演示了脚本中DTrace的用法.
l Timers.java - 演示了在一个脚本中同时使用多个@OnTimer
l URLTracker.java - 演示了在每次URL.openConnection成功返回时打印出url. 这里也使用了D语言脚本.
l WebServiceTracker.java - 演示了如何根据注解进行trace.
其他相关博文
BTrace工具简介http://mgoann.iteye.com/blog/1409667
BTrace实例应用http://mgoann.iteye.com/blog/1409676
BTrace实际案例分析http://mgoann.iteye.com/blog/1409685
发表评论
-
BTrace实际案例分析
2012-02-17 17:24 6408BTrace实际案例分析 问题表象 问题描述 ... -
BTrace工具实例应用
2012-02-17 17:18 3956BTrace工具使用简介 “Hello World” ... -
使用JDI调试多线程程序
2012-02-09 11:17 0前几天写了一篇Eclipse的debug技巧,引来不少童鞋的口 ... -
Eclipse Debug不为人知的秘密
2012-02-07 15:54 39181Debug视图 认识debug视图,红色部分框为线程堆栈视 ... -
PIM系统架构浅析
2010-06-20 15:43 2205PIM系统架构浅析 我们真的需要分 ... -
日志打印
2010-06-20 15:26 1751日志打印 ü 日志重要性 ü ... -
JSON简介
2010-06-20 15:22 2517JSON简介 ü JSON简介及其应用场景 ... -
Java编程中汉字问题的初探
2010-06-20 15:09 12471. 前言 在基于Java语言 ... -
接口模块的定义
2010-06-20 14:35 1195接口模块的定义 1 作为接口模块,必须要在设计时仔细逐 ... -
JDBC当中的批处理
2010-06-20 14:33 1490JDBC当中的批处理 在对数据库进行批量操作时,应分析操作的 ... -
大批量工具的思考
2010-06-20 14:32 914大批量工具的思考 大批量工具的思考:大批量处理工具,适用于数 ... -
Unicode、GBK、UTF-8、ASCII的编码简介
2010-06-20 14:30 3471Unicode、GBK、UTF-8、ASCII的编码简介 ... -
java中乱码问题解决方法
2010-02-04 13:01 1633通过TCP码流识别编码 前几天和北京的MM在联调时候出现一个 ... -
java中的编码简介
2010-01-16 16:48 1385Unicode、GBK、UTF-8、ASCII的编码简介 ... -
大批量工具的思考
2010-01-15 19:51 995大批量工具的思考 大批量工具的思考:大批量处理工具,适用于数 ... -
java当中的批处理
2010-01-15 19:44 10717在对数据库进行批量操作时,应分析操作的前后相关性,如果属于大批 ... -
接口模块的定义
2010-01-15 19:34 12621 作为接口模块,必须要在设计时仔细逐一分析消息的类型。包括: ...
相关推荐
【描述】"btrace btrace btrace btrace" 的重复提及,暗示了这个压缩包的核心内容是关于BTrace工具的。这可能意味着用户可以在这个版本中找到关于如何使用BTrace的信息,包括示例、文档以及许可信息。 【标签】...
### 一、Btrace 简介 Btrace 是由Sun Microsystems(现已被Oracle收购)开发的一款开源项目,适用于JDK 1.6及更高版本。它通过使用Java代理技术(Java Instrumentation API)动态插入代码来实现对目标应用程序的...
**Btrace简介** Btrace是由Sun Microsystems开发的一个开放源码的Java运行时分析工具。它的主要功能是能够在运行中的Java应用程序中动态地插入监视代码,用于收集有关程序运行时信息,如方法调用、对象创建、线程...
BTrace,全称为“Berkeley Trace”,是一款强大的Java生产环境性能诊断工具。它以其无需修改代码、动态跟踪代码执行的能力而备受开发者青睐。本文将围绕“btrace-bin-1.3.11.tgz.tar.gz”这一最新版本的BTrace bin包...
**一、BTrace简介** BTrace是基于字节码注入技术的,它通过在JVM层面上动态插入监控代码,来收集关于程序运行的信息。这种技术的优势在于,它不需要对源代码进行任何修改,也不需要重新编译或重启应用。只需要在...
#### 二、BTrace简介 BTrace是一种用于Java应用程序的动态追踪工具,主要特点包括: - **安全追踪**:BTrace旨在观察而不干扰目标应用程序的正常运行。这意味着它只读取数据而不会写入任何数据,确保了追踪操作...
标题中的“Btrace非侵入式调试Java程序神奇linux版”指出,这是一个专为Linux系统设计的工具,名为Btrace,它主要用于非侵入式的Java程序调试。非侵入式意味着Btrace可以在不修改或重新编译原始Java代码的情况下,对...
1. **BTrace简介**:BTrace是一个动态代码插桩工具,它允许开发者在运行时添加和修改Java代码,以便进行性能监控、日志记录、问题诊断等。BTrace使用安全的字节码注入技术,确保不会破坏程序的正常运行。 2. **工作...
4. BTrace:文档中提到了BTrace这一神器,BTrace是一个动态追踪工具,它允许Java开发者在不重启应用的情况下,通过Java代码来跟踪调试正在运行的Java程序。BTrace可以用于追踪生产环境中的问题,从而减少停机时间。 ...
该工具结合了BTrace和DTrace的优势,为用户提供了一种全新的、高效的性能分析手段。 #### 二、DFrame的核心功能 DFrame的核心功能在于它能够动态地生成性能收集脚本,并通过这些脚本对WebLogic服务器进行实时监控...
5. **Dtrace/Btrace**:这些工具可以帮助开发者深入了解其应用程序的运行情况,从而进行性能优化或调试。 #### 三、Oracle的服务和支持策略 为了确保客户能够获得最佳的支持和服务体验,Oracle提供了多种服务选项:...