接入应用探针后,才能检测到相关应用,进行全链路压测的相关操作。本文介绍如何在全链路压测的应用中接入探针和相关的常见问题。

接入探针

  1. 下载最新版本Java探针
  2. 安装探针。
    1. 执行以下命令,进入探针压缩包所在目录并将其解压至任意工作目录下。
      unzip pts-agent.zip -d /<user.workspace>/
      说明 <user.workspace>是示例路径,请根据具体环境修改。
    2. 选择以下任意一种方式添加AppName、Namespace、LicenseKey参数。
      • 方法1:在应用服务器的启动脚本中添加以下JVM参数。
        -javaagent:/<user.workspace>/pts/pts-agent.jar
        -Dpts.licenseKey=<licenseKey> //(LicenseKey在控制台已自动生成)
        -Dpts.namespace=<YourNamespace> //(自定义的环境名称)
        -Dpts.appName=<YourAppName> //(自定义的应用名称)
        说明 请将<licenseKey>、<YourNamespace>、<YourAppName>替换为实际值。
      • 方法2:
        1. 修改/[user.workspace]/pts/pts-agent.properties,替换对应的配置项。
          pts.licenseKey=<licenseKey> //(LicenseKey已自动生成)
          pts.namespace=<YourNamespace> //(自定义的环境名称)
          pts.appName=<YourAppName>//(自定义的应用名称)
          说明 请将<licenseKey>、<YourNamespace>、<YourAppName>替换为实际值。
        2. 在应用服务器的启动脚本中添加以下JVM参数。
          -javaagent:/[user.workspace]/pts/pts-agent.jar
          说明 [user.workspace]是示例路径,请根据具体环境修改。
  3. 重启应用。

    请在本地重新启动应用,大约3分钟后探针将会安装完毕。

    安装成功后,登录PTS控制台,在左侧导航栏选择全链路压测 > 应用管理 > 探针列表,在探针列表页面选择环境,即可查看在线的探针。

体验Demo

您可以通过接入Demo应用,体验压测流量隔离的基本调用链功能和Mock功能。

  1. 下载最新版本Java探针
  2. 将探针压缩包解压至任意工作目录下。
  3. 您可以通过以下任意方式获取Demo包。
    • 下载Demo包
    • 执行以下命令获取Demo包。
      wget https://public-holo-demo.oss-cn-zhangjiakou.aliyuncs.com/pts-httpclient4-demo.jar
  4. 执行以下命令,启动Demo。
    java -javaagent:/[user.workspace]/pts/pts-agent.jar -Dpts.namespace=test -Dpts.appName=pts-httpclient4-demo
    -Dpts.licenseKey=fa3f6600771911aa5da2a2c90a94853e -jar pts-httpclient4-demo.jar
    说明 [user.workspace]请替换为探针所在目录的实际路径。
  5. 登录PTS控制台,在左侧导航栏选择压测流量隔离 > 应用管理 > 应用列表
  6. 应用列表页面右上角,从当前环境下拉列表中选择目标环境。
    应用列表页面,即可看到接入的Demo应用pts-httpclient4-demo。

接入Demo后您可以进行以下操作:

  • 打开探针开关和调用链监控开关进行体验。具体操作,请参见管理配置
  • 您可以通过Postman或者执行curl http://localhost:8099/test命令发起正常流量,然后在压测流量隔离 > 应用监控 > 调用链路中查看调用链信息。具体操作,请参见查看调用链路
  • 您可以通过压测流量隔离 > 应用管理 > 配置管理中的Mock规则设置页签,新建如下Mock Http调用规则体验Mock功能。具体操作,请参见管理配置Mock规则.png

常见问题

应用启动成功,控制台为什么看不到在线探针?

  • 请检查应用机器是否允许连接公网。
  • 请检查配置的Namespace、AppName是否与控制台查询条件中选择的Namespace、AppName一致。
  • 如果是通过-jar命令行启动的,请检查命令行设置,确保-javaagent参数在-jar之前。
  • 请检查pts/logs/目录下的最新日志文件中是否存在异常日志。