1、Agent 探针配置

1.1、解压Agent
解压Agent到任意目录路径,后续配置应用的启动文件时需要用到该 DIR 路径。

1.2、配置日志路径
在simulator-agent包下,修改agent.properties文件的simulator.log.path值为所需的日志路径,方便后续问题定位。

2.应用接入

启动参数
${DIR} 改为agent的路径
jdk8及以上启动参数
-Xbootclasspath/a:$JAVA_HOME/lib/tools.jar
-javaagent:/${DIR}/bootstrap/transmittable-thread-local-2.12.1.jar
-javaagent:/${DIR}/target/simulator-agent/simulator-launcher-instrument.jar
-Dpradar.project.name=xiaobin-test
-Dsimulator.agentId=xxxx
-Djdk.attach.allowAttachSelf=true

jdk9及以上启动参数
–add-exports=java.base/jdk.internal.loader=ALL-UNNAMED
–add-exports=java.base/jdk.internal.module=ALL-UNNAMED
–add-exports=java.base/jdk.internal.misc=ALL-UNNAMED
-javaagent:/${DIR}/bootstrap/transmittable-thread-local-2.12.1.jar
-javaagent:/${DIR}/target/simulator-agent/simulator-launcher-instrument.jar
-Dpradar.project.name=xiaobin-test
-Dsimulator.agentId=xxxx
-Djdk.attach.allowAttachSelf=true

避免应用重复,其中应用名Dpradar.project.name,需要按照自己定义的新应用名,避免和其他试用用户重复
虽然不指定 simulator.agentId 系统也会生成一个 agentId,但是为了保证唯一性和可读性,还是推荐显示指定一个 agentId(-Dsimulator.agentId)
-Dpradar.project.name=xiaobin-test
-Dsimulator.agentId=xxxx

tip:
agent 启动默认延迟300秒后加载,delay 默认为300,unit 默认为 SECONDS,如果需要自定义启动延迟时间可以通过
-Dsimulator.delay 来指定延迟时间,通过-Dsimulator.unit 来指定延迟的时间单位(默认 SECONDS,可选参数请参考 TimeUnit 的枚举定义名称 DAYS/HOURS/MINUTES/SECONDS/MILLISECONDS/MICROSECONDS/NANOSECONDS)
这两个参数只供开发在调试时使用,在实际的客户接入中不要去配置这两个参数,如果要配置请与开发人员联系

执行启动命令启动应用:
启动应用之后,可以通过simulator.log日志查看是否成功加载 Agent
如看到下图内容,表示应用成功加载 Agent启动 :

应用接入agent成功就可以在压测控制台的”应用管理“看到应用

文档更新时间: 2021-09-24 16:49   作者:ShuLieOpenSource