btrace-all

Tooling for distributed application development in Java

License

License

GPLv2 /w Classpath Exception
GroupId

GroupId

org.gridkit.3rd.btrace
ArtifactId

ArtifactId

btrace-all
Last Version

Last Version

2.0.1-nimble
Release Date

Release Date

Type

Type

pom
Description

Description

btrace-all
Tooling for distributed application development in Java
Project URL

Project URL

http://code.google.com/p/gridkit/btrace-all
Source Code Management

Source Code Management

https://github.com/gridkit/btrace2

Download btrace-all

How to add to project

<!-- https://jarcasting.com/artifacts/org.gridkit.3rd.btrace/btrace-all/ -->
<dependency>
    <groupId>org.gridkit.3rd.btrace</groupId>
    <artifactId>btrace-all</artifactId>
    <version>2.0.1-nimble</version>
    <type>pom</type>
</dependency>
// https://jarcasting.com/artifacts/org.gridkit.3rd.btrace/btrace-all/
implementation 'org.gridkit.3rd.btrace:btrace-all:2.0.1-nimble'
// https://jarcasting.com/artifacts/org.gridkit.3rd.btrace/btrace-all/
implementation ("org.gridkit.3rd.btrace:btrace-all:2.0.1-nimble")
'org.gridkit.3rd.btrace:btrace-all:pom:2.0.1-nimble'
<dependency org="org.gridkit.3rd.btrace" name="btrace-all" rev="2.0.1-nimble">
  <artifact name="btrace-all" type="pom" />
</dependency>
@Grapes(
@Grab(group='org.gridkit.3rd.btrace', module='btrace-all', version='2.0.1-nimble')
)
libraryDependencies += "org.gridkit.3rd.btrace" % "btrace-all" % "2.0.1-nimble"
[org.gridkit.3rd.btrace/btrace-all "2.0.1-nimble"]

Dependencies

There are no dependencies for this project. It is a standalone project that does not depend on any other jars.

Project Modules

  • btrace-parent
  • core
  • core-api
  • runtime
  • client
  • asm
  • instr
  • compiler
  • maven-plugin
  • agent
  • boot
  • extensions
  • extensions/default
  • extensions/collections
  • extensions/aggregations
  • extensions/sys
  • extensions/profiling
  • extensions/export

BTrace

Version

2.0

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

Building BTrace

Setup

You will need the following applications installed

Build

cd <btrace>
mvn --also-make --projects dist install verify

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

Using BTrace

Installation

Explode a 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.

Running

  • <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.

org.gridkit.3rd.btrace

Versions

Version
2.0.1-nimble