2009-06-02T08:38:31Z

2045 Home 9

448

= BTrace = BTrace is a safe, dynamic tracing tool for the Java platform. BTrace can be used to dynamically trace a running Java program (similar to [http://opensolaris.org/os/community/dtrace/ DTrace for OpenSolaris] applications and OS). BTrace dynamically instruments the classes of the target application to inject tracing code ("bytecode tracing"). Tracing code is expressed in Java programming language. There is also integration with DTrace for the OpenSolaris platform. You can enhance [https://visualvm.dev.java.net/ VisualVM] with the [[BTrace plugin]] to be able to write and deploy BTrace scripts directly from VisualVM. Alternatively, if you'd prefer you can run BTrace from command line shells as well. There is also a [http://www.netbeans.org/ NetBeans] plugin that makes it easier to write and deploy BTrace scripts. You can get it [http://plugins.netbeans.org/PluginPortal/faces/PluginDetailPage.jsp?pluginid=10920 here]. == License == BTrace is available under [https://visualvm.dev.java.net/legal/gplv2+ce.html GNU Public License v.2 w/Classpath Exception]. == Download == Actual BTrace binary realease is available for download from Documents & files link. == Maven == BTrace binaries are available as Maven artifacts as well. You can get them [http://download.java.net/maven/2/com/sun/tools/btrace/ here] == User Guide == [[UserGuide|BTrace User's Guide]] == Building from the sources == BTrace sources are available from Mercurial repository. After checking out the sources, you can use NetBeans to build BTrace using the [[NetBeans project setup instructions]]. There is also a [[DeveloperGuide|BTrace Developer's Guide]]. == Known Issues == *JVM crash: We have seen JVM crashes with BTrace. We have fixed few such crashes as well. JVM could crash due to the following reasons: # BTrace submits invalid .class file to VM (bug in BTrace instrumentor) # Hotswap bug in HotSpot JVM. To enable debugging such scenarios, please turn on the following options in $BTRACE/bin/btrace (or btrace.bat) script. By default, the System properties com.sun.btrace.debug amd com.sun.btrace.dumpClasses are set to false in the scripts. Please change these to true. Also, you may want to add -verify:all option as well - which will force bytecode verification of all loaded classes. When you report a JVM crash with BTrace, please attach/send the following: # BTrace trace class that caused the crash. # hs_err_pidXXX log produced by JVM. # *.class file(s) saved by BTrace setting the com.sun.btrace.dumpClasses option. # debug output from BTrace by setting the com.sun.btrace.debug option. == How to contribute to BTrace? == If you like BTrace and want to contribute fixes/features to BTrace, your are always welcome! You (or your company) have to sign the [http://www.sun.com/software/opensource/contributor_agreement.jsp Sun Contributor Agreement]. Then, please join this project as "developer" using your kenai.com id. === BTrace on the web === * [http://netbeans.dzone.com/articles/debugging-netbeans-with-visualvm-and-btrace Using VisualVM, BTrace & Good Old Web Search] * [http://ice09.wordpress.com/2009/07/12/analysing-memory-leaks-with-btrace Analysing Memory Leaks with BTrace] * [http://www.devwebsphere.com/devwebsphere/2009/06/btrace-for-performance-tuning.html btrace for performance tuning] * [http://blog.scalablej.com/2009/05/btrace-ultimate-jvm-probe.html BTrace the ultimate JVM probe] * [http://www.dzone.com/links/socket_monitoring_now_using_btrace.html Socket Monitoring: Now Using BTrace] * [http://kensipe.blogspot.com/2009/02/btrace-fix-on-mac.html BTrace Fix on the Mac] * [http://raymondtay.blogspot.com/2008/06/using-btrace-in-java-6.html Using BTrace in Java 6] * [http://http//blog.igorminar.com/2008/06/btrace-dtrace-for-java.html BTrace == DTrace for Java] * [http://blogs.sun.com/theaquarium/entry/btrace_showing_promises BTrace showing promises] * [http://weblogs.java.net/blog/binod/archive/2008/06/sailfin_work_an.html SailFin work and BTrace] * [http://www.carlobonamico.com/blog/tag/btrace/ Runtime profiling and monitoring Java apps with btrace]

<h1><a name='BTrace'></a> BTrace </h1> <p> BTrace is a safe, dynamic tracing tool for the Java platform. BTrace can be used to dynamically trace a running Java program (similar to <a class='external' href="http://opensolaris.org/os/community/dtrace/">DTrace for OpenSolaris</a> applications and OS). BTrace dynamically instruments the classes of the target application to inject tracing code ("bytecode tracing"). Tracing code is expressed in Java programming language. There is also integration with DTrace for the OpenSolaris platform. </p><p>You can enhance <a class='external' href="https://visualvm.dev.java.net/">VisualVM</a> with the <a href='<?url_for_page BTrace plugin?>' class='internal'>BTrace plugin</a> to be able to write and deploy BTrace scripts directly from VisualVM. Alternatively, if you'd prefer you can run BTrace from command line shells as well. </p><p>There is also a <a class='external' href="http://www.netbeans.org/">NetBeans</a> plugin that makes it easier to write and deploy BTrace scripts. You can get it <a class='external' href="http://plugins.netbeans.org/PluginPortal/faces/PluginDetailPage.jsp?pluginid=10920">here</a>. </p><h2><a name='License'></a> License </h2> <p> BTrace is available under <a class='external' href="https://visualvm.dev.java.net/legal/gplv2+ce.html">GNU Public License v.2 w/Classpath Exception</a>. </p><h2><a name='Download'></a> Download </h2> <p> Actual BTrace binary realease is available for download from Documents & files link. </p><h2><a name='Maven'></a> Maven </h2> <p> BTrace binaries are available as Maven artifacts as well. You can get them <a class='external' href="http://download.java.net/maven/2/com/sun/tools/btrace/">here</a></p><h2><a name='User_Guide'></a> User Guide </h2> <p><a href='<?url_for_page UserGuide?>' class='internal'>BTrace User's Guide</a> </p><h2><a name='Building_from_the_sources'></a> Building from the sources </h2> <p> BTrace sources are available from Mercurial repository. After checking out the sources, you can use NetBeans to build BTrace using the <a href='<?url_for_page NetBeans project setup instructions?>' class='internal'>NetBeans project setup instructions</a>. There is also a <a href='<?url_for_page DeveloperGuide?>' class='internal'>BTrace Developer's Guide</a>. </p><h2><a name='Known_Issues'></a> Known Issues </h2> <ul><li>JVM crash: We have seen JVM crashes with BTrace. We have fixed few such crashes as well. JVM could crash due to the following reasons: </li></ul><ol><li> BTrace submits invalid .class file to VM (bug in BTrace instrumentor) </li><li> Hotswap bug in HotSpot JVM. </li></ol><p> To enable debugging such scenarios, please turn on the following options in $BTRACE/bin/btrace (or btrace.bat) script. By default, the System properties com.sun.btrace.debug amd com.sun.btrace.dumpClasses are set to false in the scripts. Please change these to true. Also, you may want to add -verify:all option as well - which will force bytecode verification of all loaded classes. When you report a JVM crash with BTrace, please attach/send the following: </p><ol><li> BTrace trace class that caused the crash. </li><li> hs_err_pidXXX log produced by JVM. </li><li> *.class file(s) saved by BTrace setting the com.sun.btrace.dumpClasses option. </li><li> debug output from BTrace by setting the com.sun.btrace.debug option. </li></ol><h2><a name='How_to_contribute_to_BTrace?'></a> How to contribute to BTrace? </h2> <p> If you like BTrace and want to contribute fixes/features to BTrace, your are always welcome! You (or your company) have to sign the <a class='external' href="http://www.sun.com/software/opensource/contributor_agreement.jsp">Sun Contributor Agreement</a>. Then, please join this project as "developer" using your kenai.com id. </p><h3><a name='BTrace_on_the_web'></a> BTrace on the web </h3> <ul><li> <a class='external' href="http://netbeans.dzone.com/articles/debugging-netbeans-with-visualvm-and-btrace">Using VisualVM, BTrace & Good Old Web Search</a></li><li> <a class='external' href="http://ice09.wordpress.com/2009/07/12/analysing-memory-leaks-with-btrace">Analysing Memory Leaks with BTrace</a></li><li> <a class='external' href="http://www.devwebsphere.com/devwebsphere/2009/06/btrace-for-performance-tuning.html">btrace for performance tuning</a></li><li> <a class='external' href="http://blog.scalablej.com/2009/05/btrace-ultimate-jvm-probe.html">BTrace the ultimate JVM probe</a></li><li> <a class='external' href="http://www.dzone.com/links/socket_monitoring_now_using_btrace.html">Socket Monitoring: Now Using BTrace</a></li><li> <a class='external' href="http://kensipe.blogspot.com/2009/02/btrace-fix-on-mac.html">BTrace Fix on the Mac</a></li><li> <a class='external' href="http://raymondtay.blogspot.com/2008/06/using-btrace-in-java-6.html">Using BTrace in Java 6</a></li><li> <a class='external' href="http://http//blog.igorminar.com/2008/06/btrace-dtrace-for-java.html">BTrace == DTrace for Java</a></li><li> <a class='external' href="http://blogs.sun.com/theaquarium/entry/btrace_showing_promises">BTrace showing promises</a></li><li> <a class='external' href="http://weblogs.java.net/blog/binod/archive/2008/06/sailfin_work_an.html">SailFin work and BTrace</a></li><li> <a class='external' href="http://www.carlobonamico.com/blog/tag/btrace/">Runtime profiling and monitoring Java apps with btrace</a></li></ul>

2009-08-20T12:29:01Z

8601