全部产品
阿里云办公

双引擎接入使用文档

更新时间:2018-09-25 13:40:08

原理介绍

平台介绍

适用范围

云效上的java应用可直接申请直接使用。也支持非云效上的其他任何java应用使用,前提是您的应用服务器可以正常访问域名:doom.rdc.aliyun.com 。如果因网络问题无法使用可联系我们进一步沟通解决方案。

联系方式(email): mufeng.qcg@alibaba-inc.com

接入文档

平台入口

入口链接

1. 企业设置

1.1 新建或加入企业

访问 云效并根据提示新建企业,如果已经存在企业请忽略。您也可以接收企业管理员要邀请加入企业。

1.2 数据存储设置

OSS配置

录制流量将保存到oss中,因此企业使用前需要先进行购买和设置。请预先评估好需要容量,oss 申请地址

警告:若流量不够请申请扩容,如果更换oss将导致原录制的数据无法使用。

设置方法:

oss设置

2. 应用接入申请

rdc中的应用需要申请后才能正常接入使用,目前公测需要联系相关技术支持同学开通使用,一个企业限制接入5个应用。

2.1 申请方法

2.1.1 云效应用接入申请方式

01

2.1.2 非云效应用接入申请方式

02

2.2 审批结果

目前公测阶段由产品后台方审批,审批完成后会通过用户在rdc绑定的邮箱发送审核结果。如果在3个工作日后还未收到通知结果,请发邮箱咨询我们。 联系人: 穆风 mufeng@aibaba-inc.com

公测结束后,会把权限下放到企业管理员。

3. 快速入门

3.1 首次接入进入引导配置

当应用申请完毕后,请联系相关同学审核。审核完成后在申请页或者应用管理页进入刚申请好的应用进行配置。首次接入时会自动弹出接入配置引导页面,如下图:1

3.2 设置IP

完成引导页提示后会自动弹出引导配置框,如下图2

注意事项

测试流程通常是从日常->预发(灰度)->线上可以支持线上采集的流量跨环境回放,取决于你回放任务设置的数据采集源的环境。

3.2 设置流量入口

3

3.3 客户端配置

客户端配置是埋点客户端运行需要的一些参数配置,一般生成一个默认的即可。

3

5

  • 不支持的中间件请先联系我们。我们根据评估为你们应用做适配。
  • 作为隔离环境,服务端提供者将不再提供服务,例如dubbo隔离后,dubbo provider不会注册服务到注册中心。原因是回放因为隔离了环境,提供服务明显程序运行不完整,会产生程序错误等。

3.4 引流配置

6

3.5 创建并选择流量分组

7

8

9

3.5.1 什么是流量分组

流量分组(分组环境)是针对流量录制和回放两种场景设置的相关管理机制,分组会管理相应的服务器ip、流量入口配置以及相关客户端配置信息。利用流量分组可以实现流量的分配管理以及多项目协作管理。

3.5.2 流量分组类型

流量分组有3种类型,录制分组、回放分组、录制&回放 分组。

录制分组

仅负责录制数据,对应用的影响和侵入最小。

回放分组

仅负责数据回放,会对应用的对外请求进行隔离,也就是它不能直接对外提供服务,线上或者beta回放请选择此分组。

‘录制&回放’分组

既支持录制也支持回放,也支持一台机器同时录制和回放(便于接入调试)。不会对应用的对外请求隔离,请谨慎用于线上或者预发回放。

3.6 创建以及开启任务

10

3.7 安装doom客户端

11

如果采用免变更模式接入,如果引导程序发现有多个java进程,那么请选择应用程序对应的进程12

3.8 客户端部署状态检查

13

3.9 添加流量入口

当客户端部署成功后,会主动采集流量入口。针对http流量入口,需要用户去触发相关的http请求才能正常采集。针对java流量入口,启动后会上传应用中的一些可用于配置流量入口的java bean。配置方法如下图:

14

15

3.10 检查引流回放情况

3.10.1 检查录制情况

16

3.10.2 检查回放情况

1718

其他文档

4.1 变更接入模式

如果是在线上环境进行回放,推荐使用变更模式接入。

4.1.1 sdk下载

sdk.zip

将sdk下载并解压后得到 doom-common-client-xxx.jar,clouddoom-loader.jar 两个文件。

doom-common-client-xxx.jar 添加到应用依赖中。(可以将doom-common-client-xxx.jar 文件作为三方库上传到自己的私用maven库,这样就可以直接依赖了)

4.1.2 JVM配置项添加

1)将 clouddoom-loader.jar 放到服务器中某个目录例如 /home/admin/doom 中

2)新增jvm启动项:

//‘appId:1#clientKey:KsvU…#endPoint:http://doom.rdc.aliyun.com/’ 此参数可以从管理后台的【应用配置】-> 【权限管理】的ClientParam参数中获取。

-javaagent:/home/admin/doom/clouddoom-loader/target/clouddoom-loader.jar=appId:1#clientKey:KsvU…#endPoint:http://doom.rdc.aliyun.com/

jvm启动项

4.1.3 系统初始化BEAN配置

在应用spring配置文件中新增一个配置

  1. <bean class="com.alibaba.doom.client.ClientInitialBean" lazy-init="false"/>

针对spring boot应用没有xml配置可以如下配置

  1. import com.alibaba.doom.client.ClientInitialBean;
  2. @SpringBootApplication
  3. public class DemoApplication {
  4. @Bean
  5. public ClientInitialBean getDoomClient() {
  6. return new ClientInitialBean();
  7. }
  8. public static void main(String[] args) {
  9. SpringApplication.run(DemoApplication.class, args);
  10. }
  11. }

4.2 回放失败分析

进入查看失败原因

查看失败原因

进入查看失败具体列表

查看失败列表

查看具体对比失败原因,查看是否回放失败,如果没有回放失败则查看不一致字段,判断是否为噪音,如果是的话可以点击排除

查看失败原因

排除噪音字段后保存

排除保存

重跑验证(重跑的前提是回放机器客户端要正常运行)

重跑验证

4.3 录制流量的检索与收藏(用例管理)

4.3.1 原理

支持录制流量通过opensearch进行搜索并收藏感兴趣的流量来回放。当opensearch相关配置设置完成后,当客户端录制到流量的入参以及返回结果会通过opensearch进行索引,通过控制台可供搜索和查看。并支持添加到用例集,通过新建回放任务并关联相关用例集实现用例回归。

4.3.2 步骤

  • 开通opensearch&新建应用&设置数据表
  • doom平台配置

4.3.3 开通opensearch&设置数据表

字段名称 类型 主键
id LITERAL
invoke_identity LITERAL
timestamp INT
source_id LITERAL
container_id INT
trace_id LITERAL
item_key LITERAL
data_key LITERAL
request_json TEXT
response_json TEXT
data_record_id INT
  • 字段索引设置
索引名称 包含字段 分词方式
id id 不分词
default request_json、response_json 中文-基础分词
invoke_identity invoke_identity 不分词
trace_id trace_id 不分词
item_key item_key 不分词
data_key data_key 不分词
time_stamp timestamp 不分词
source_id source_id 不分词
data_record_id data_record_id 不分词
  • 在数据源设置也直接点击完成

数据源

  • 设置默认展示字段默认opensearch字段

  • 结果摘要设置

结果摘要

  • 回到应用列表,激活应用(根据需求合理选择容量大小,也可以申请免费容量试用)

回到应用列表

4.3.4 平台opensearch配置(仅企业管理员可设置)

opensearch

4.3.5 流量收藏

方法一:进入【用例中心】->【录制流量】选择其中一个流量点击‘查看’,在流量列表页选择‘收藏’方法二:进入【用例中心】->【流量搜索】选择其中一个流量点击‘收藏’。

4.3.6 收藏分组的新建

在点击收藏后显示收藏对话框。点击‘加号进行分组添加’添加收藏分组

4.3.7 新建收藏分组任务并执行回归

在回放分组新建一个回放任务,并关联当前新建的收藏分组即可收藏回放