jvmlocals

使用 jvmti, 注册异常回调, 在抛出异常的地方, 获取线程的上下文变量信息 .

想法来源于 python 的 locals()函数, 返回当前栈帧的局部变量信息

1. 获取线程的变量信息. 测试环境排查问题非常有用
2. TODO 异常时候自动获取线程的变量信息

如何运行本项目

请确保已经安装make和gradle
windows确保已经安装mingw

以上工具确保已经配置好path

linux || mac

# 执行测试代码
make test

# 清理动态库和class文件
make clean

# 编译动态库
make

windows

mingw32-make test

mingw32-make clean

mingw32-make

TODO

• 使用JNI接口获取当前函数的局部变量信息
• 动态attach到服务器, 不需要添加到参数中
• 传入多个frame, 获取多个frame的局部变量信息
• 使用asm在编译的时候, 捕获局部变量信息. 不同于JNI的运行时捕获.
• 使用asm在异常的地方, 捕获局部变量信息
• 上述使用asm的方式, 也可以通过运行时的retransform来实现, 无需在编译期间修改字节码
• 增加测试代码

演示

1. 测试代码, 未经过生产验证.

package github.elroy93.jvmlocals;

import java.util.HashMap;
import java.util.Map;

/**
 * @author elroysu
 * @date 2024/10/11 20:52
 */
public class JvmLocals {
    static {
        System.loadLibrary("JvmLocalsAgent");
    }

    // jni接口
    public native static Object getLocals(Map varHolder);

    public static void main(String[] args) {
        execute();
    }
    public static void execute() {
        final byte _byte_a = 1;
        final short _short_b = 2;
        final int _int_c = 3;
        final long _long_d = 4;
        final float _float_e = 5;
        final double _double_f = 6;
        final char _char_g = 'g';
        final boolean _boolean_h = true;
        int[] _arr_int = new int[]{1, 2, 3};
        var _string_y = "y";
        String _string_z = "z";

        // 获取变量信息, 返回的string类型
        String result = (String)getLocals(new HashMap());
        //
        String string_null = null;

        var varArr = result.split(",");
        System.out.println(">>>>>>>>>>> jvmlocals start <<<<<<<<<<<<");
        for (String item : varArr) {
            System.out.println(item);
        }
        System.out.println(">>>>>>>>>>> jvmlocals done <<<<<<<<<<<<");
    }

}

Frame 1: Lgithub/elroy93/jvmlocals/JvmLocals;.execute()V
>>>>>>>>>>> jvmlocals start <<<<<<<<<<<<
_arr_int: [I@2a139a55
_boolean_h: bool_1
_byte_a: 1
_char_g: char_103
_double_f: 6.000000
_float_e: 5.000000
_int_c: 3
_long_d: 4
_short_b: 2
_string_y: y
_string_z: z
>>>>>>>>>>> jvmlocals done <<<<<<<<<<<<