btrace

by btraceio

btraceio / btrace

BTrace - a safe, dynamic tracing tool for the Java platform

4.2K Stars 779 Forks Last release: 5 months ago (v2.0.2) 1.2K Commits 50 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

Download Build Status codecov.io Join the chat at https://gitter.im/jbachorik/btrace Project Stats

btrace

A safe, dynamic tracing tool for the Java platform

Version

2.0.2

Quick Summary

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").

Credits

Building BTrace

Setup

You will need the following applications installed

  • Git
  • JDKs - JDK 8, Java 9 and Java 11 are required to be available
  • (optionally, the default launcher is the bundled
    gradlew
    wrapper) Gradle

In order to ease the pre-build config the

config_build.sh
script is provided. You should run it first as
source config_build.sh
to automatically download all required JDKs and set up the corresponding
JAVA_*_HOME
env variables.

Build

Java

Your JAVA_HOME must point to JDK 11 (eg. JAVA11HOME)

Gradle

cd 
./gradlew build
./gradlew buildDistributions

The binary dist packages can be found in

/btrace-dist/build/distributions
as the *.tar.gz, *.zip, *.rpm and *.deb files. The exploded binary folder which can be used right away is located at
/btrace-dist/build/resources/main
which serves as the BTRACE_HOME location.

Using BTrace

Installation

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

Running

  • /bin/btrace  
    will attach to the java application with the given PID and compile and submit the trace script
  • /bin/btracec 
    will compile the provided trace script
  • /bin/btracer  
    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.

Maven Integration

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.

Contributing - !!! Important !!!

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

Deb Repository

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

echo "deb http://dl.bintray.com/btraceio/deb xenial 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 xenial universe

RPM Repository

Grab the *.repo file

wget https://bintray.com/btraceio/rpm/rpm -O bintray-btraceio-rpm.repo
and use it.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.