Merge branch 'gh-pages' of github.com:mchr3k/org.intrace into gh-pages

This commit is contained in:
Martin 2011-11-13 21:55:25 +00:00
commit b4d458eb32
2 changed files with 11 additions and 11 deletions

View File

@ -9,16 +9,16 @@ title: Eclipse Plugin
<p>I have developed this against Eclipse Helios (3.6.2).</p>
<ul>
<li>Within Eclipse, open Help ? Install New Software</li>
<li>Within Eclipse, open Help -&gt; Install New Software</li>
<li>Enter the following URL: http://intracesite.appspot.com/
<ul>
<li>This site relies on a free traffic quota. If this site is down you should download the .zip update site: <a href="https://github.com/downloads/mchr3k/org.intrace/intrace.ecl.site.zip">intrace.ecl.site.zip</a>
</li>
<li>To use this file, click the “Add…” button and then the “Archive…” button and navigate to the downloaded file.</li>
<li>To use this file, click the ""Add" button and then the "Archive" button and navigate to the downloaded file.</li>
</ul>
</li>
<li>Choose the “InTrace Eclipse” plugin</li>
<li>Choose the "InTrace Eclipse" plugin</li>
<li>Click Next and continue until the plugin has been installed</li>
</ul><h2>Using the plugin</h2>
<p>The Eclipse plugin brings the full <a class="internal present" href="/mchr3k/org.intrace/wiki/Docs%3A-InTrace-UI">Docs: InTrace UI</a> into Eclipse and makes it quick and easy to launch java code with the InTrace agent. The following types of launch are currently supported:</p>
@ -26,12 +26,12 @@ title: Eclipse Plugin
<li>Java Application</li>
<li>JUnit Test</li>
</ul><p>Launching is performed using the new “InTrace” lunch button.</p>
</ul><p>Launching is performed using the new "InTrace" launch button.</p>
<p><img src="img/eclipse_launch.jpg" alt=""></p>
<p>Once your program has been started the InTrace UI is opened within eclipse and automatically connects to the running program. The Connection tab of the InTrace UI is hidden as the Eclipse plugin handles the connection automatically.</p>
<p>Once your program has been started the InTrace UI is opened within eclipse and automatically connects to the running program.</p>
<p>The InTrace agent pauses the startup of the launched program to allow you to perform any initial configuration of the agent.</p>
<p><img src="img/eclipse_paused.jpg" alt=""></p>
<p>When you are ready you should click “Start Program” to resume the normal execution. Any collected trace is shown on the Output tab.</p>
<p>When you are ready you should click "Start Program" to resume the normal execution. Any collected trace is shown on the Output tab.</p>
<p><img src="img/eclipse_active.jpg" alt=""></p>
<p>If you close the InTrace window you can open a new one by right clicking the launch from the Debug view and choosing Open InTrace Output.</p>

View File

@ -11,20 +11,20 @@ title: Related Projects
<ul>
<li><a href="kenai.com/projects/btrace">BTrace</a></li>
</ul>
<p>From the BTrace site: <EFBFBD>BTrace can be used to dynamically trace a running Java program (similar to DTrace for OpenSolaris applications and OS). BTrace dynamically instruments the classes of the target application to inject tracing code (<28>bytecode tracing"). Tracing code is expressed in Java programming language. There is also integration with DTrace for the OpenSolaris platform."</p>
<p>This tool let<EFBFBD>s you write simple blocks of java code and then use the BTrace agent to insert your code into existing class files at runtime. It would be very easy to port the InTrace Callers analysis to run in BTrace. However, there is currently no support in BTrace for inserting code into basic block entry. This is something which the InTrace agent does support.</p>
<p>From the BTrace site: "BTrace can be used to dynamically trace a running Java program (similar to DTrace for OpenSolaris applications and OS). BTrace dynamically instruments the classes of the target application to inject tracing code (<28>bytecode tracing"). Tracing code is expressed in Java programming language. There is also integration with DTrace for the OpenSolaris platform."</p>
<p>This tool let's you write simple blocks of java code and then use the BTrace agent to insert your code into existing class files at runtime. It would be very easy to port the InTrace Callers analysis to run in BTrace. However, there is currently no support in BTrace for inserting code into basic block entry. This is something which the InTrace agent does support.</p>
<ul>
<li><a href="http://www.jboss.org/byteman">Byteman</a></li>
</ul>
<p>From the Byteman site: <EFBFBD>Byteman is a tool which simplifies tracing and testing of Java programs. Byteman allows you to insert extra Java code into your application, either as it is loaded during JVM startup or even after it has already started running. The injected code is allowed to access any of your data and call any application methods, including where they are private. You can inject code almost anywhere you want and there is no need to prepare the original source code in advance nor do you have to recompile, repackage or redeploy your application. In fact you can remove injected code and reinstall different code while the application continues to execute.<EFBFBD></p>
<p>From the Byteman site: "Byteman is a tool which simplifies tracing and testing of Java programs. Byteman allows you to insert extra Java code into your application, either as it is loaded during JVM startup or even after it has already started running. The injected code is allowed to access any of your data and call any application methods, including where they are private. You can inject code almost anywhere you want and there is no need to prepare the original source code in advance nor do you have to recompile, repackage or redeploy your application. In fact you can remove injected code and reinstall different code while the application continues to execute."/p>
<p>This is very similar to BTrace but allows you to write scripts in a different language. The project site features very details docs about what you can do with the tool.</p>
<ul>
<li><a href="http://www.eclipse.org/aspectj/">AspectJ</a></li>
</ul>
<p>From the aspectj site: <EFBFBD>A seamless aspect-oriented extension to the Javatm programming language<67></p>
<p>Aspectj allows you to write <EFBFBD>aspects<EFBFBD> which are a more generalised form of what BTrace allows. However, there is currently no support in AspectJ for inserting code into basic block entry. This is something which the InTrace agent does support.</p>
<p>From the aspectj site: "A seamless aspect-oriented extension to the Javatm programming language"</p>
<p>Aspectj allows you to write "aspects" which are a more generalised form of what BTrace allows. However, there is currently no support in AspectJ for inserting code into basic block entry. This is something which the InTrace agent does support.</p>
<p>There is also a commercial tool which does much more than InTrace.</p>
<h2>Execution Recording</h2>