前言

在去年 repeater 刚出来的时候，就已经简单体验了一下，也有在公司试用。但由于各种原因，最终没有落地。现在刚好有机会再研究一下，看官方记录 console 终于加上了界面，所以也试用并记录下来。

其它文章链接传送门：

通用流量录制回放工具 jvm-sandbox-repeater 尝鲜记录 (0716 跑通基于 console 的录制回放)
通用流量录制回放工具 jvm-sandbox-repeater 尝鲜 (二)——repeater-console 使用 (已完成)
通用流量录制回放工具 jvm-sandbox-repeater 尝鲜 (三)—— repeater plugin 开发 (完成度 50%)

步骤

由于官方源码有做了比较多调整，所以这次记录还是从零开始。

1、安装 repeater

运行官方仓库下的 bin/install-repeater.sh 即可

2、调整 repeater 模式配置，改为用 console

修改 ~/.sandbox-module/cfg/repeater.properties 的值，repeat.standalone.mode 改为 false

3、调整 console 工程中对应配置

在 repeater-console/repeater-console-start/src/main/resources/application.properties ，调整 mysql 相关配置，改为和自己本地 mysql 数据库一致

同时请初始化数据库内容，初始化的 sql 文件在：repeater-console/repeater-console-dal/src/main/resources/database.sql

初始化成功，应该会创建了 repeater 这个数据库，且包括下面四个表：

4、启动 console 和被测服务

启动被测服务：

4.1、下载示例项目：https://github.com/chenhengjie123/gs-rest-service
4.2、启动示例项目：

# 在示例项目 clone 后的根目录中运行
cd complete 
mvn install && java -jar target/*.jar

启动成功后，应该有类似如下日志：

...
2020-12-28 07:40:45.949  INFO 32158 --- [           main] o.s.b.w.embedded.tomcat.TomcatWebServer  : Tomcat started on port(s): 8080 (http) with context path ''
2020-12-28 07:40:45.952  INFO 32158 --- [           main] hello.Application                        : Started Application in 2.062 seconds (JVM running for 2.448)

4.3、修复官方仓库里 console 一些代码问题。

4.3.1、把 repeater-console/repeater-console-start/src/main/resources/velocity 下面的所有文件，查找 #parse("/blocks ，统一改替换为 #parse("blocks 。原有代码最前面带上 / 会导致引用找不到报错
4.3.2、修改 repeater-console/repeater-console-start/src/main/java/com/alibaba/repeater/console/start/controller/page/ReplayController.java 中的 return "/replay/detail"; ，改为 return "replay/detail"; ，去掉双引号里面第一个 /
4.3.3、修改 repeater-console/repeater-console-start/src/main/java/com/alibaba/repeater/console/start/controller/test/RegressPageController.java 中的 return "/regress/index"; ，改为 return "regress/index";，去掉双引号里面第一个 /

4.4、启动 console：

# 在 repeater 项目根目录进行
mvn install -DskipTests && java -jar repeater-console/repeater-console-start/target/*.jar

启动成功，应该出现类似下面的日志：

...
2020-12-28 07:40:27.259  INFO 32116 --- [           main] s.b.c.e.t.TomcatEmbeddedServletContainer : Tomcat started on port(s): 8001 (http)
2020-12-28 07:40:27.265  INFO 32116 --- [           main] c.a.repeater.console.start.Application   : Started Application in 7.532 seconds (JVM running for 8.065)

5、使用界面化的 console 进行录制回放

打开此 url 即可打开 console 的界面：http://127.0.0.1:8001/regress/index.htm

现在，借助界面来做一次录制回放吧。基本套路还是一样的：

5.1、在 console 增加配置，用于对接应用（注意这个和之前纯命令行有点不同，命令行是先完成第二步）
5.2、让 repeater 注入到被测应用，上报数据到 console
5.3、在 console 中操作，进行录制和回放

接下来，一步一步操作。

5.1、在 console 增加配置，用于对接应用

点击左侧的【配置管理】，添加如下配置：

应用名：unknown
环境：unknown
配置信息

{
  "useTtl" : true,
  "degrade" : false,
  "exceptionThreshold" : 1000,
  "sampleRate" : 10000,
  "pluginsPath" : null,
  "httpEntrancePatterns" : [ "^/greeting.*$" ],
  "javaEntranceBehaviors" : [ {
    "classPattern" : "hello.GreetingController",
    "methodPatterns" : [ "greeting" ],
    "includeSubClasses" : false
  } ],
  "javaSubInvokeBehaviors" : [],
  "pluginIdentities" : [ "http", "java-entrance", "java-subInvoke", "mybatis", "ibatis" ],
  "repeatIdentities" : [ "java", "http" ]
}

点击【保存】，存下配置

5.2、让 repeater 注入到被测应用

sh ~/sandbox/bin/sandbox.sh -p `ps -ef | grep "target/gs-rest-service-0.1.0.jar" | grep -v grep | awk '{print $2}'` -P 12580

然后进入 console 的【在线模块】，应该能看到增加了当前这个被测应用的心跳记录：

5.3、开始录制。给这个被测应用输送一些流量

# 手动发出2条请求
$ curl -s 'http://localhost:8080/greeting'
{"id":1,"content":"Hello, World!"}%
$ curl -s 'http://localhost:8080/greeting?name=User'
{"id":2,"content":"Hello, User!"}%

然后打开 console 的【在线流量】，能看到刚发出的两条请求已经录制下来了：

5.4、回放请求。直接点击第一行末尾的回放按钮，进行回放：

然后，就可以看到回放结果了。稍等几秒后刷新下回放结果界面，就能看到执行结果

由于被测应用实际上 id 自增逻辑没有依赖任何外部服务，每次请求都会自动 +1 ，所以回放记录是失败的。

总结

官方的文档还是一如既往的少，代码里面也有点坑（对 velocity 不熟悉，上面的代码只是按自己理解改的，如果有更正确的修改姿势欢迎分享），界面和技术栈都用的比较小众和比较久远的的（spring-boot 17 年已经去掉对 velocity 模板引擎的支持了）。而且一个批量回放功能还是只有按钮实际没做的。。。

不过也算是给到大家一个真正示例控制台该有的样子，把需要的元素和界面设计都基本给出了。如果想要开箱即用，对 http 接口进行简单的录制回放，可以使用这个带界面的 console 来试用一下。

附录：过程中的报错及解决

1、注入 repeater 到被测应用后，console 报错：

2020-12-28 23:37:28.822 ERROR 39333 --- [nio-8001-exec-4] o.a.c.c.C.[.[.[/].[dispatcherServlet]    : Servlet.service() for servlet [dispatcherServlet] in context with path [] threw exception [Request processing failed; nested exception is java.lang.NullPointerException] with root cause

java.lang.NullPointerException: null
    at com.alibaba.repeater.console.start.controller.api.ConfigFacadeApi.getConfig(ConfigFacadeApi.java:34) ~[classes!/:na]
    at sun.reflect.GeneratedMethodAccessor77.invoke(Unknown Source) ~[na:na]
    at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43) ~[na:1.8.0_25]

原因：上报心跳包后，appName 和 environment 和配置对不上。
解决：请确认有至少一个配置，appName 和 environment 都是 unknown

2、报错 org.apache.velocity.exception.ResourceNotFoundException: Unable to find resource '/blocks/pager.vm'] with root cause ，且界面打不开

原因：没有按照前面所述修改 console 源码，导致引用其他模板的部分根目录不正确。
解决：按照前面描述，把 #parse("/blocks ，统一改替换为 #parse("blocks 即可。

↙↙↙阅读原文可查看相关链接，并与作者交流