A safe, dynamic tracing tool for the Java platform

1.3.9 (Release Page)

BTrace is a safe, dynamic tracing tool for the Java platform.

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 ("bytecode tracing").

• Based on ASM
• Powered by JCTools
• Powered by hppcrt
• Optimized with JProfiler Java Profiler

You will need the following applications installed

• JDK (preferrably JDK8)
• Git
• Gradle
• (optionally) Ant
• (optionally) Maven3

cd <btrace>
./gradlew build
./gradlew buildDistributions

The binary dist packages can be found in <btrace>/build/distributions as the *.tar.gz, *.zip, *.rpm and *.deb files.

cd <btrace>/make
ant dist

The binary dist packages can be found in <btrace>/dist as the *.tar.gz and *.zip files

Download a distribution file from the release page. Explode the binary distribution file (either *.tar.gz or *.zip) to a directory of your choice.

You may set the system environment variable BTRACE_HOME to point to the directory containing the exploded distribution.

You may enhance the system environment variable PATH with $BTRACE_HOME/bin for your convenience.

Or, alternatively, you may install one of the *.rpm or *.deb packages

• <btrace>/bin/btrace <PID> <trace_script> will attach to the java application with the given PID and compile and submit the trace script
• <btrace>/bin/btracec <trace_script> will compile the provided trace script
• <btrace>/bin/btracer <compiled_script> <args to launch a java app> will start the specified java application with the btrace agent running and the script previously compiled by btracec loaded

For the detailed user guide, please, check the Wiki.

The maven plugin is providing easy compilation of BTrace scripts as a part of the build process. As a bonus you can utilize the BTrace Project Archetype to bootstrap developing BTrace scripts.

These mailing lists are hosted at http://librelist.com

• [email protected]
• [email protected]
• [email protected]

Pull requests can be accepted only from the signers of Oracle Contributor Agreement

Using the command line, add the following to your /etc/apt/sources.list system config file:

echo "deb http://dl.bintray.com/btraceio/deb trusty universe" | sudo tee -a /etc/apt/sources.list

Or, add the repository URLs using the "Software Sources" admin UI:

deb http://dl.bintray.com/btraceio/deb trusty universe

Grab the *.repo file wget https://bintray.com/btraceio/rpm/rpm -O bintray-btraceio-rpm.repo and use it.