Java相关

Java - agent探针

2020-04-03  本文已影响0人  万福来

Java - agent探针

介绍

使用 Instrumentation，使得开发者可以构建一个独立于应用程序的代理程序（Agent），用来监测和协助运行在 JVM 上的程序，甚至能够替换和修改某些类的定义。有了这样的功能，开发者就可以实现更为灵活的运行时虚拟机监控和 Java 类操作了，这样的特性实际上提供了 一种虚拟机级别支持的 AOP 实现方式，使得开发者无需对 JDK 做任何升级和改动，就可以实现某些 AOP 的功能了。

JVM启动前静态Instrument

Instrumentation 的最大作用，就是类定义动态改变和操作。在 Java SE 5 及其后续版本当中，开发者可以在一个普通 Java 程序（带有 main 函数的 Java 类）运行时，通过 -javaagent参数指定一个特定的 jar 文件（包含 Instrumentation 代理）来启动 Instrumentation 的代理程序。

编写premain方法

  1. 定义一个java类，实现如下两个方法当中的一个：

    public static void premain(String agentArgs, Instrumentation inst);  [1]
public static void premain(String agentArgs); [2]

    其中，[1] 的优先级比 [2] 高，将会被优先执行（[1] 和 [2] 同时存在时，[2] 被忽略）。在这个 premain 函数中，开发者可以进行对类的各种操作。

    • agentArgs 是 premain 函数得到的程序参数，随同 “-javaagent”一起传入。与 main 函数不同的是，这个参数是一个字符串而不是一个字符串数组，如果程序参数有多个，程序将自行解析这个字符串。
    • Inst 是一个 java.lang.instrument.Instrumentation 的实例，由 JVM 自动传入。java.lang.instrument.Instrumentation 是 instrument 包中定义的一个接口，也是这个包的核心部分，集中了其中几乎所有的功能方法，例如类定义的转换和操作等等。

  2. 打包jar
    将这个java类打包成一个jar文件，并在其中的META-INF/MAINFEST.MF属性当中加入”Premain-Class“来指定步骤1中编写的带有premain的类。maven打包方式可以参考配置如下

     <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-jar-plugin</artifactId>
            <version>2.3.2</version>
            <configuration>
                <!--<archive>-->
                    <!--<index>true</index>-->
                    <!--<manifestFile>-->
                        <!--src/main/resources/META-INF/MANIFEST.MF-->
                    <!--</manifestFile>-->
                    <!--<manifest>-->
                        <!--<addDefaultImplementationEntries/>-->
                    <!--</manifest>-->
                <!--</archive>-->
               <archive>
                <manifest>
                    <addClasspath>true</addClasspath>
                </manifest>
                <manifestEntries>
                    <!-- 参数方式启动agent需要这个 -->
                    <Premain-Class>
                        ${permain}
                    </Premain-Class>
                    <!-- 启动后附加启动agent需要这个 -->
                    <Agent-Class>
                        com.demo.XXX
                    </Agent-Class>
                    <!-- 是否可以重新转换类 -->
                    <Can-Retransform-Classes>
                        true
                    </Can-Retransform-Classes>

                    <!-- 是否可以重新定义类 -->
                    <Can-Redefine-Classes>
                        true
                    </Can-Redefine-Classes>

                </manifestEntries>
            </archive>
            </configuration>
        </plugin>

  3. 运行
    用如下方式运行带有Instrumenttation的java程序

    java -javaagent:jar路径 [= 传入 premain 的参数 ] 其他参数

JVM启动后动态Instrument

在java6之前，开发者只能在程序main函数执行前，启动Instrumentation，java6之后提供了一个与premain类似的agentmain方法，该方法可以在程序main函数运行之后在执行。写法与premain函数类似。

public static void agentmain (String agentArgs, Instrumentation inst); [1] 
public static void agentmain (String agentArgs);[2]

同样，[1] 的优先级比 [2] 高，将会被优先执行（[1] 和 [2] 同时存在时，[2] 被忽略）。跟 premain 函数一样，开发者可以在 agentmain 中进行对类的各种操作。其中的 agentArgs 和 Inst 的用法跟 premain 相同。
打包方法与premain类类似，唯一区别是MANIFEST文件的Agent-Class替换Premain-Class。
启动方式与premain类也不相同，agentmain实现类可以通过Attach API来触发。

 String pid = "34534";// 目标JVM进程ID
 VirtualMachine virtualMachine = VirtualMachine.attach(pid);
 virtualMachine.loadAgent(jar);
 virtualMachine.detach();
 System.out.println("load success");

Instrument核心API

热部署，其实就是动态或者说运行时修改类，大的方向说有2种方式：

上一篇下一篇

猜你喜欢

热点阅读