javaagent概述

概述

我们通过 Java Agent 字节码增强技术，将 Spring Cloud Tencent 的能力通过字节码增强的方式织入用户的程序中，方便用户能够在不修改原本 Spring Cloud 项目代码的情况下快速接入北极星，体验北极星的相关服务治理能力。

快速入门

前提条件

您需要先下载 Polaris Server，具体操作参见 Polaris 服务端安装

确定 Spring Cloud 版本

确认自己项目的 Spring Boot 版本

➜  mvn dependency:tree  | grep "org.springframework.boot:spring-boot-starter:jar"
[INFO] |  +- org.springframework.boot:spring-boot-starter:jar:2.6.9:compile

根据命令查询到的 spring boot 版本信息，我们在根据下面的版本列表对应关系选择合适的 Spring Cloud 以及 Polaris Java Agent Plugin 版本

版本列表

这里列出了不同 Spring Cloud 版本相对应的 Spring Cloud Tencent 版本。 您需要先查看您当前使用的 Spring Cloud 版本，从而确定需要引入的 Spring Cloud Tencent 版本。

Spring Boot 兼容版本	Spring Cloud 版本	Polaris Java Agent 版本	Spring Cloud Java Agent Plugin 版本
2.6.13	2021.0.4	1.3.0-beta	spring-cloud-2021-plugin-1.3.0-beta.jar

使用 Polaris Java Agent

下载 Polaris Java Agent 发布包

Polaris Java Agent 安装包

# 从 Github Release 中下载最新 Java Agent 发布包
wget https://github.com/polarismesh/polaris-java-agent/releases/download/${version}/polaris-java-agent-${version}.zip

# 解压
unzip polaris-java-agent-${version}.zip

Polaris Java Agent 目录结构

.
├── conf
│   └── plugin
│       └── springcloud2021
│           └── application.properties              # Spring Cloud Tencent Java Agent 的配置文件
├── plugins
│   └── spring-cloud-2021-plugin-${version}.jar # Spring Cloud Tencent Java Agent 插件
└── polaris-agent-core-bootstrap.jar                # Polaris Java Agent 主程序

使用 Polaris Java Agent

java -javaagent:xxx/polaris-agent-core-bootstrap.jar -jar {你的 Java 程序名称}.jar

如果你希望所用的程序公用一个 Polaris Java Agent，但是希望每个程序的配置不一样，则可以添加 VM 参数

 -Dpolaris.agent.user.application.conf=application-{服务名称}.properties