Dynamic Java Tracing with Instrumentation, BTrace, and ASM

The article explores Java runtime tracing techniques that allow modifying class behavior without restarting the JVM.

It starts with a dialogue illustrating common debugging challenges and introduces JSP as an example where code changes take effect instantly because the web container recompiles the JSP into a new servlet class using a fresh ClassLoader.

It then discusses how Java objects consist of attributes (per‑instance) and behavior (shared methods) stored in the JVM's method area, and how changing behavior at runtime requires redefining classes.

The java.lang.instrument.Instrumentation API provides redefineClasses and retransformClasses methods to replace or transform existing class bytecode, albeit with safety restrictions.

public class Person {

  private int age;

  private String name;

  public void speak(String str) {
    System.out.println(str);
  }

  public Person(int age, String name) {
    this.age = age;
    this.name = name;
  }
}

Direct bytecode manipulation can be performed with frameworks such as ASM, which underlies many tools like cglib and Spring AOP.

BTrace is presented as a safe, annotation‑driven tracing tool built on ASM, the Attach API, and Instrumentation. Sample BTrace scripts are shown that intercept methods in java.io and count thread creations.

package com.sun.btrace.samples;

import com.sun.btrace.annotations.*;
import com.sun.btrace.AnyType;
import static com.sun.btrace.BTraceUtils.*;

@BTrace
public class ArgArray {
    @OnMethod(clazz="/java\\.io\\..*/", method="/read.*/")
    public static void anyRead(@ProbeClassName String pcn, @ProbeMethodName String pmn, AnyType[] args) {
        println(pcn);
        println(pmn);
        printArray(args);
    }
}

Arthas, an Alibaba open‑source diagnostic tool, is mentioned as a higher‑level solution that wraps similar instrumentation capabilities.

The article concludes that, despite limitations, runtime instrumentation has become a powerful means for developers to diagnose and monitor Java applications.