SaaS Ai 旧版(v3.x)到新版 Java 探针升级方法

faq
ai
java
apm

#1

1. 准备

1.1. 获取最新的探针介质,并上传到服务器

1.2. 获取新版探针对应的 LiceseKey(登录到 http://app.oneapm.com 获取)

1.3. 规划 appname(应用名称) 和 tiename(层名称)

建议:互相之间有调用的应用或服务使用相同的 appname,不同的 tiername(如 cas,user,推荐使用服务的英文名称)

2. 操作步骤

2.1. 登录 www.oneapm.com

2.2. 点击 Ai(Application Insight),进入 Ai 产品

2.3. 点击「探针下载」,选中 Java 图标,记录 Licensekey 并下载探针,并放到您服务器的OneAPM 安装目录下(如:/path/to/)

2.4. 备份旧版探针

登入您的业务系统服务器

cd /path/to/
mv /path/to/OneAPM /path/to/OneAPMbak

2.5. 安装新探针

unzip <javaagent-linux-x64-lastversion.zip> /path/to/
vi /path/to/OneAPM/oneapm.properties

修改 licenskey、appname、tiername,保存

2.6. 重启应用服务

3. 特殊说明

3.1. 关于 collector

collector 是新版 Ai Java 探针引入的模块,负责接收并简单处理 agent 的数据,上报到 OneAPM 后台服务,collector 支持 2 种部署方式:本地部署(LOCAL)和远程部署(REMOTE),collector 和 Java 探针在同一服务器下安装运行即为 collector 本地部署模式。将 collector 与探针分布到不同服务器的部署方式为远程部署。
如果同一个 OS 里部署多个探针,只需要保留一个探针的 collector 工作在 LOCAL 模式(或者修改 collector 使用不同的服务端口),其它均改为 REMOTE 模式(修改 oneapm.properties 的 collector_deployment_mode = REMOTE)

3.2. Docker 环境部署探针

方法一,集成进 docker image 里,直接参考上面的步骤安装后,保存 image 即可。
方法二,通过 Dockerfile 加载探针,参考:如何在 Docker 环境安装 OneAPM Ai Java 探针