录制回放设置

选中某应用，点击页面中应用名右侧的设置（AppSetting）按钮，进入应用设置页面。

录制设置

AREX 支持对特定时间段的流量进行周期性录制，你可以根据自己的需要进行自定义设置。点击 Record，进入录制设置页面。

录制设置

提示

通常来说，如需使用流量录制回放功能，则需要在生产环境和测试环境的同个应用上分别搭载 Agent，生产环境的机器用于录制，测试环境的机器用于回放（回放的应用如果没有搭载 Agent，则将对外部依赖产生真实调用，产生脏数据），且回放的机器需要关闭录制，即录制频率调整为 0。

Agent 运行状态

运行状态（Running Status）此处显示被测试应用的 AREX Agent 的状态，方便测试人员查看当前服务的 Agent 是否正常运行，从而及时发现和解决问题，保证测试过程的可靠性和稳定性。

录制机器数量（Record Machine Count）：如果有两个及以上的机器需要进行录制，需在这里修改机器数量。
Host：配置了 AREX Agent 主机的 IP 地址。
Version：当前 Agent 版本。
Modified Time：修改时间。
Status：Agent 工作状态。
- SLEEPING: Agent 已注入，但不录制
- UNSTART: Agent 未注入
- WORKING: 正在录制

当仅有一个环境中的一台机器搭载了 Agent 后，在默认（Standard）页面中进行配置即可。

录制设置

录制频率设置

Duration：设置录制应用的时间，可以选择每天都进行录制，或者仅录制一周内的任意几天的流量。

Period：设置每天录制的时间段，00:00 ~ 24:00 任意时间段均可选择。

Frequency：设置录制频率，范围为“1~100”，单位为“次/分钟”，即每分钟执行录制的次数。

动态类配置

实际应用中会使用各式缓存来提升运行时的性能，为了避免由于缓存数据的差异导致的执行结果不一致的问题，AREX 也支持了本地缓存数据的采集和 Mock 功能。

实现方法是将访问本地缓存的方法配置成一个动态类，这样你可以自定义这个方法进行 Mock。在生产环境中，AREX 会记录你配置的这个动态类方法的数据，并在回放时返回匹配到的相应数据。匹配的顺序如下：

根据请求参数进行精确匹配，如果能够找到匹配的录制数据，就直接返回。
如果精确匹配不到数据，则进行模糊匹配。

动态类的模糊匹配规则如下：

必须是相同的方法签名，包括方法名、请求参数类型和参数个数。
如果相同方法签名的精确匹配不到数据，则会根据录制时间返回最新的录制数据。

除了缓存数据，也可以 Mock 各种内存数据。如有需要 Mock 的动态类数据，可点击 “+ Add” 进行配置。具体配置说明如下：

Full Class Name：本地缓存的类名，必须为全类名。以下是 AREX 中支持动态类配置的示例，用于模拟内存中的类数据。

- 中缀：在包路径中匹配任意包含 namic 的类，例如  io.arex.inst.dynamic.*namicTest*
- 后缀：在包路径中匹配以 namicTestClass 结尾的类，例如  io.arex.inst.dynamic.*namicTestClass
- 前缀：在包路径中匹配以 DynamicTest 开头的类，例如 io.arex.inst.dynamic.DynamicTest*
- 等于：在包路径中匹配类名为 DynamicTestClass 的类，例如 io.arex.inst.dynamic.DynamicTestClass
- 抽象类或接口：匹配抽象类或接口，其中 ac: 表示 abstract class 的缩写，例如 ac:io.arex.inst.dynamic.AbstractDynamicTestClass表示匹配 AbstractDynamicTestClass 抽象类。

这些配置用于指定需要 mock 的动态类的包路径和类名等信息。在配置完成后，AREX 将会自动 mock 这些类，在测试过程中使用。

Base：Base 表示基类，如果标注为基类，表示这个基类下面的子类或实现类都 Mock 生效。
Method Name：需要 Mock 的方法名。
Parameter Types：所有参数的类型，需为全类名，多个以“@”分隔。primitive 类型缩写即可，如 java.lang.String。
Key Formula：Key Formula（参数表达式）的使用场景是为了指定只录制参数的某个属性，避免录制整个对象，从而减少录制报文的大小。
举个例子，假设我们要将下面这个方法配置为动态类：
public String getOrder(Request req) { return result; }
如果我们只想录制参数 req 中的一个属性 name，那么参数表达式可以这样写： #req.getName()。在这里，#req 表示第一个 Request 参数声明的变量名。
参数表达式还可以解决一种问题场景，即某些参数不支持序列化，但你仍然需要录制这个动态类方法。通过参数表达式，你可以指定只序列化其中某个属性，从而避免序列化问题的发生。

如果使用的是开源缓存框架，如 Spring Cache、Guava Cache 或 Caffeine Cache，就无需配置动态类。只需在启动参数中添加-Darex.coverage.packages=com.your.package，并替换 com.your.package 为项目中实际使用缓存的包名。请注意，这里填写的包名不是缓存框架所在的包，而是业务代码中使用缓存的包名。

提示

这里以 System.currentTimeMillis()、UUID、泛型 为例说明如何进行动态类配置。

如代码中使用 java.lang.System#currentTimeMillis：

package com.your.service;
public class TestService {
public void testDemo(String s) {
...
  long l = System.currentTimeMillis();
  if (l > s) {
    ...
  }
...
}
}

FullClassName	MethodName	ParameterTypes	keyFormula
com.your.service.TestService	testDemo	java.lang.String	java.lang.System.currentTimeMillis

如代码中使用 UUID：

package com.your.service;
public class TestService {
  public void testDemo(String s) {
    ...
    String transId = UUID.randomUUID().toString();
    if (!qpsLimiter(transId)) {
      ...
    }
    ...
  }
}

FullClassName	MethodName	ParameterTypes	keyFormula
com.your.service.TestService	testDemo	java.lang.String	java.util.UUID.randomUUID

如代码中使用 泛型：

package com.your.entity;
public class ChangeResponseModel {
    private String field;
}
package com.your.service;
public class TestGenericService {
    public ProcessResult<ChangeResponseModel> testDemo(String s) {
        ChangeResponseModel model=new ChangeResponseModel();
        ...
        if (!qpsLimiter(s)) {
            ...
        }
        ...
        return ProcessResult.buildResult(model);
    }
}

FullClassName	MethodName	ParameterTypes	keyFormula
com.your.service.TestGenericService	testDemo	java.lang.String	T:com.your.entity.ChangeResponseModel

备注

动态类配置不需要配置 void 的方法，因为没有返回结果，Mock 了也没意义。

配置保存后，需要重启服务。或者在启动参数中加入：-Darex.retransform.instrumentation.module=dynamic-class，之后无需重启即可生效。

扩展阅读 —— 动态类 Mock 配置

Inclusion：下拉菜单中列出的是所有在录制过程中访问到的接口路径，勾选后将仅录制选中的路径。

录制白名单设置

Exclusion: 勾选后即可在之后的录制过程中跳过这些路径，不进行录制。

多环境录制设置

当有多个环境的机器搭载了 Agent 时，可以在多环境（Multi Environment）中对不同的环境进行自定义的录制配置。

提示

通常来说，如需使用流量录制回放功能，则需要在生产环境和测试环境的同个应用上分别搭载 Agent，生产环境的机器进行录制，测试环境的机器进行回放（用于回放的应用如果没有搭载 Agent，则将对外部依赖产生真实调用，产生脏数据），且回放的机器需要将录制频率调为 0。

录制设置

点击添加环境配置（Add Environment Config），在新增的配置标签页中选择需要进行配置的环境 Tag（即先前为区分环境在 Agent 启动参数中添加的 env 参数）。

录制设置

回放设置

点击 Replay，进入回放设置页面。

回放设置

Max QPS：为了减轻用户被测机器的负载，可以在应此根据需要修改最大回放 QPS 数量。

Case range：常规的回放任务可以在左侧菜单栏的 Replay 中通过手动开启，这里是为 CI (continuous integration) 设置用例自动回放范围，单位为 “days”。

Exclusion：对于某个接口，如果存在一些第三方依赖的路径不需要进行 Mock，可点击 “+ Add” 添加忽略路径，回放时 AREX 不会对这些依赖的路径进行 Mock，即会产生真实的调用。

备注

排除模板目前支持下面几种类型：

类型	path	value
database	数据库名	方法名（update、query、delete），不填则默认该库下所有方法
dubbo	服务名	接口名（不填则默认该服务下所有接口）
http	http（固定值）	接口名（不填则默认所有）
redis	clusterName（集群名）	command（不填则默认该集群下所有命令）
动态类	类名	方法名（不填则默认该类下所有方法）

修改 Owner

用户可以在应用配置中修改 Owners:

文件配置

删除应用

你可以在此删除不需要的应用。

删除应用

录制设置​

Agent 运行状态​

录制频率设置​

动态类配置​

多环境录制设置​

回放设置​

修改 Owner​

删除应用​

录制设置

Agent 运行状态

录制频率设置

动态类配置

多环境录制设置

回放设置

修改 Owner

删除应用