通过工具自动梳理相关应用的依赖。压测场景相关应用全部都需要进行部署包扫描,PTS会根据扫描报告给出对应的探针版本。本文介绍如何梳理应用依赖、查看梳理结果以及查看探针兼容性分析报告。

背景信息

目前支持JAR包和WAR包的依赖梳理,其他格式的部署包请提交工单

工具上报的数据说明如下:

表 1. 采集的数据说明
文件类型 上报内容 数据示例
*.jar 文件名、Maven坐标 dubbo-2.7.5.jar org.apache.dubbo:dubbo:2.7.5
pom.propetties Maven坐标 groupId=org.apache.dubbo; artifactId=dubbo; version=2.7.5
*.properties 配置项的Key,不上报配置项的值 spring.redis.host,spring.redis.port,spring.redis.database,...
*.yaml, *.yml 配置项的Key,不上报配置项的值 spring.redis.host,spring.redis.port,spring.redis.database,...
注意 工具上传扫描结果之前会列出待上传的数据清单,请仔细核对文件内容是否涉及敏感信息,确认无误后请输入Y。然后工具开始执行上传,输入其他字符则表示放弃上传。

示例如下:

java -jar pts-scanner.jar [扫描路径] [licenseKey]
...
是否确认上传扫描结果 (Y/N): N
已取消上传

梳理依赖工具

  1. 下载最新版本依赖梳理工具
  2. 执行以下命令,将下载的压缩包解压至任意工作目录下。
    unzip pts-scanner.zip -d /[user.workspace]/
    说明 [user.workspace]替换为实际路径。
  3. 执行以下命令,扫描应用部署包。
    java -jar pts-scanner.jar [部署包路径] [LicenseKey]
    说明 LicenseKey在压测流量隔离控制台的产品文档 > 应用依赖梳理中查询。

    扫描应用部署包命令示例如下:

    • 示例1:扫描单个应用部署包。例如需要扫描/home/admin/packages/app-gateway.jar,扫描命令如下:
      java -jar pts-scanner.jar /home/admin/packages/app-gateway.jar fa3f6600771911aa5da2a2c90axxxx //(LicenseKey已自动生成)
    • 示例2:批量扫描多个应用部署包。例如需要扫描/home/admin/packages/目录下的所有JARr包和WAR包,扫描命令如下:
      java -jar pts-scanner.jar /home/admin/packages/ fa3f6600771911aa5da2a2c90a9xxxx //(LicenseKey已自动生成)
  4. 登录PTS控制台,在左侧导航栏选择压测流量隔离 > 依赖梳理,查看工具的扫描结果。

    您还可以提交工单获取兼容性分析报告。

查看应用部署包

应用依赖梳理完毕后,可以在控制台查看梳理结果。

  1. 登录PTS控制台,在左侧导航栏选择压测流量隔离 > 依赖梳理
  2. 应用部署包页面,单击操作列的详情

    依赖组件页签,可以查看其依赖的RPC调用、数据库、日志框架等信息。

查看探针兼容性分析报告

应用依赖梳理完毕后,可以在控制台查看相关应用部署包的探针兼容性报告。

  1. 登录PTS控制台,在左侧导航栏选择压测流量隔离 > 依赖梳理
  2. 应用部署包页面,选中文件名称(可多选),然后单击探针兼容性分析
    说明 文件名称可多选,支持一次最多选择20个。
  3. 探针兼容性分析报告页面,查看探针适配情况。
    • 若报告显示探针已基本适配您的压测场景,您可以提供子账号信息给PTS研发人员,进一步确认探针适配情况,如下图所示。探针分析
    • 若该文件中存在部分中间件尚未适配探针,您可以在未适配组件列表页签查看具体的未适配组件,单击更多图标.png图标,查看该组件的信息。如下图所示。未适配组件.png

后续步骤

接入应用探针