Java Agent这个技术,对于大多数同学来说都比较陌生,但是多多少少又接触过,实际上,我们平时用的很多工具,都是基于Java Agent实现的,例如常见的热部署JRebel,各种线上诊断工具(btrace, greys),还有阿里最近开源的arthas。
其实Java Agent一点都不神秘,也是一个Jar包,只是启动方式和普通Jar包有所不同,对于普通的Jar包,通过指定类的main函数进行启动,但是Java Agent并不能单独启动,必须依附在一个 Java 应用程序运行,有点像寄生虫的感觉。
如何动手写一个Java Agent
因为Java Agent的特殊性,需要一些特殊的配置,在META-INF目录下创建MANIFEST文件.
并在MANIFEST文件中指定Agent的启动类
这里需要解释下为什么要指定 Agent-Class
和 Premain-Class
,在加载Java Agent之后,会找到 Agent-Class
或者 Premain-Class
指定的类,并运行对应的 agentmain
或者 premain
方法。
/**
* 以vm参数的方式载入,在Java程序的main方法执行之前执行
*/
public static void premain(String agentArgs, Instrumentation inst);
/**
* 以Attach的方式载入,在Java程序启动后执行
*/
public static void agentmain(String agentArgs, Instrumentation inst);
如果不想手动创建MANIFEST文件,也可以通过Maven配置,在打包的时候自动生成,具体配置可以参数下面。
plugin>
<artifactId>maven-assembly-plugin</artifactId>
<configuration>
<archive>
<manifestEntries>
<Premain-Class>com.dianping.rhino.agent.AgentBoot</Premain-Class>
<Agent-Class>com.dianping.rhino.agent.AgentBoot</Agent-Class>
<Can-Redefine-Classes>true</Can-Redefine-Classes>
<Can-Retransform-Classes>true</Can-Retransform-Classes>
</manifestEntries>
</archive>
</configuration>
</plugin>
所以,我们需要在 agentmain
或者 premain
方法中实现具体的Agent逻辑,这里是你大显身手的地方,读取JVM的各种数据,修改类的字节码,只要你能想到的,一般都可以实现。
如何加载 Java Agent
前面说了,一个Java Agent既可以在程序运行前加载,也可以在程序运行后加载,两者有什么区别呢?
程序运行前加载
通过JVM参数 -javaagent:**.jar
启动,程序启动的时候,会优先加载Java Agent,并执行其 premain
方法,这个时候,其实大部分的类都还没有被加载,这个时候可以实现对新加载的类进行字节码修改,但是如果 premain
方法执行失败或抛出异常,那么JVM会被中止,这是很致命的问题。
程序运行后加载
程序启动之后,通过某种特定的手段加载Java Agent,这个特定的手段就是 VirtualMachine
的 attach api
,这个api其实是JVM进程之间的的沟通桥梁,底层通过socket进行通信,JVM A可以发送一些指令给JVM B,B收到指令之后,可以执行对应的逻辑,比如在命令行中经常使用的jstack、jcmd、jps等,很多都是基于这种机制实现的。
因为是进程间通信,所以使用 attach api
的也是一个独立的Java进程,下面是一个简单的实现。
// 15186表示目标进程的PID
VirtualMachine vm = VirtualMachine.attach("15186");
try {
// 指定Java Agent的jar包路径
vm.loadAgent(".../agent.jar");
} finally {
vm.detach();
}
首先,我们得知道目标进程的PID,这个可以通过jps指令方便得到,也可以通过 VirtualMachine
的list方法拿到本机所有Java进程的PID。通过 attach
连接上目标PID之后,可以获得表示目标进程的vm对象,执行 loadAgent
方法,对应的Java Agent会被加载,然后会找到指定的入口类,并执行agentmain方法,如果执行出现普通异常(除了oom和其它致命异常),目标JVM并不会受到影响。
通过这种方式,可以实现动态的加载Java Agent,而不需要修改JVM启动参数。
Java Agent 后续内容
- attach api 的实现原理
-
agentmain
和premain
方法中的Instrumentation参数是什么? - 如何自定义类加载器,避免污染目前进程
- 如何实现字节码的修改
- 如何实现字节码的多次修改
- 如何恢复被修改过的字节码
- 如何卸载Java Agent的类
- 卸载自定义类加载器遇到的一些坑