APM Agent 之 动态注入 agent

APM agent在sprint 17加入了“动态注入”的新特性。使得agent可以在监控的目标应用不需要重启和额外配置的情况下，就能够注入到目标应用。

agent动态注入特性支持JDK6及以上版本。

一、动态注入agent的命令：

 假设APM agent的路径是$AGENT_HOME；目标应用已经启动，其进程号(pid)是 22814；jdk路径是$JAVA_HOME。

java -Xbootclasspath/a:$JAVA_HOME/lib/tools.jar -DAPM.agentId=<agent id> -DAPM.applicationName=<app name> -DcollectorIp=<collector ip> -DlogstashIp=<logstash ip> -jar $AGENT_HOME/APMbootstrap.jar 22814

下面解释一下其原理。

动态注入agent的特性使用了从JDK6开始加入的JDK的特性“虚拟机启动后的动态 instrument”。它允许在jvm启动后注入agent。与jvm启动前在命令行中设置agent类似，jvm启动后执行的agent有一些特殊的代码和打包的要求：


   1. 必须存在agentmain入口：public static void agentmain (String agentArgs, Instrumentation inst); 或者public static void agentmain (String agentArgs); 两者都存在时，jvm选择前者执行；

  2. 必须在 manifest 文件里面设置“Agent-Class”来指定包含 agentmain 函数的类，例如：Agent-Class: com.test.AgentMain ；

 动态注入agent的特性使用了JDK的非标准api：Attach API。该api需要使用tools.jar，存在与$JAVA_HOME/lib/tools.jar。Attach API使得agentmain进程能够根据目标应用的pid获取到目标应用的jvm实例，并通知目标应用jvm加载agent，完成agent的注入；
动态注入agent完成后，由于APMagent是基于字节码动态修改的原理开发的，所以需要再次获取目标应用jvm已经加载的class，并再次触发修改其字节码；

二、在APM agent中实际的应用及代码摘录和解释如下：

新增入库main函数，其接受1个参数：目标应用的pid，并调用DynamicAgentLoader.load(pid)为目标进程注入agent：

public static void main(String[] args) {
    if (args ==