导入场景_性能测试(PTS)-阿里云帮助中心

PTS支持将JMeter（JMX）、Postman（JSON）、HTTP Archive Format（.har）、YAML和Swagger脚本（.yml，.json）转换为PTS原生的能力进行压测，提供RPS压测模式，支持实时调速、细致到单接口的监控等。

脚本说明

对HTTP或HTTPS协议的压测，PTS支持将JMeter（JMX）、Postman（JSON）、HTTP Archive Format（.har）、YAML和Swagger脚本（.yml，.json）中有关请求的基础信息解析为压测场景中的API。

JMeter脚本与PTS API压测的字段对应关系如下：

JMeter脚本字段		PTS API压测字段

JMeter脚本字段		PTS API压测字段
Test Plan（测试计划）		压测场景
Thread Group（线程组）		串联链路
Sampler（采样器）说明仅支持HTTP Request。	Name	压测API名称
	Server Name or IP Path Port Number	压测URL
	Method	请求方法
	Parameters/Body Data	Body定义下的内容
HTTP Header Manager（HTTP Header管理）	Headers	Header定义下的Key和Value。全局或者区域生效的Header会填充到对应区域的API中。
HTTP Cookie Manager（HTTP Cookie管理）	User-Defined Cookies	Header定义下的Cookie。全局或者区域生效的Cookie会填充到对应区域的API中。

说明

HTTP Header Manager、HTTP Cookie Manager和HTTP Request Default会取所有的并集导入到每个API中。
Cookie相关的设置中，暂不支持导入domain和path。
导入时Content-Type默认都为x-www-form-urlencoded，如果需要切换为raw请先复制，否则会清空Body的内容。
对于不支持导入的信息，您可以使用PTS提供的功能实现，例如检查点（断言）、指令（思考时间、集合点等）、参数化等。

Postman与PTS API压测的字段对应关系如下：

Postman脚本字段		PTS API压测字段

Postman脚本字段		PTS API压测字段
info.name		串联链路名
item[]		为多个API
item[0].name		API名称
item[0].request.method		请求方法
item[0].request.url.raw		请求URL
item[0].request.header	key	header的key
	value	对应的value值
item[0].request.body		请求体- POST类型下，需要看是什么Content-Type来决定展示形式。

说明

JSON脚本中，可以有多个info.name（串联链路），但info平级的只能是info不可以是item。
若从Postman中Collections导出JSON脚本，建议使用V2.1。
Postman（JSON）脚本仅支持GET、POST、PUT或DELETE方法。
Postman（JSON）脚本中不支持File模式。
暂未支持同时上传及二进制类的Content-Type，无法进行转换。

YAML与PTS API压测的字段对应关系如下：

YAML脚本字段	PTS API压测字段

表 1. 基本概念类型
YAML脚本字段	PTS API压测字段
Relations	串联链路的集合
Relation	单个串联链路
Disabled	串联链路是否被禁用
ID	串联链路ID
Name	串联链路名称
Nodes	节点集合
Name	节点名称
NodeId	节点ID
NodeType	节点类型
Config	节点配置

YAML脚本字段	PTS API压测字段

表 2. 节点类型
YAML脚本字段	PTS API压测字段
chain	API节点
wait	思考时间节点
condition	条件跳转节点
dam	集合点
dataInit	数据配置节点
dataStore	数据导出节点
dataDefine	数据指令节点
delay	延时节点
repeatBegin	循环指令开始节点
repeatEnd	循环指令结束节点
ifBegin	判断指令开始节点
ifEnd	判断指令结束节点

类型	YAML脚本字段	PTS API压测字段

表 3. 节点配置类型
类型	YAML脚本字段	PTS API压测字段
chain	accessId	协议ID。
	beginStep	并发模式时表示串联链路上的起始并发；RPS模式时表示API上的起始RPS。
	checkPoints	检查点配置： checkers：单个检查点配置。 expectValue：期望值。 operator：操作符；有gt\|gte\|lt\|lte\|eq\|n_eq\|ctn\|n_ctn\|exist\|n_exist\|belong\|n_belong\|regex_match，分别表示：大于｜大于等于｜小于｜小于等于｜等于｜不等于｜包含｜不包含｜存在｜不存在｜属于｜不属于｜正则匹配。 point：检查对象。 type：检查点类型： BODY_TEXT表示文本响应体。 BODY_JSON表示JSON格式的响应体。 HEADER表示header。 COOKIE表示cookie。 STATUS_CODE表示响应状态码。 EXPORTED_PARAM表示出参。
	endStep	并发模式时表示串联链路上的最大并发；RPS模式时表示API上的最大RPS。
	headers	HTTP header配置： name：header的key。 value：header的value。
	method	请求方法，只支持 GET/POST/PUT/DELETE。
	postActions	后置操作： type：类型，目前只支持 export，表示出参。 params：出参配置： name：出参名。 value：出参表达式。 type：同检查点类型type。
	body	请求方法为POST｜PUT时，对应的请求body： contentType：类型。 value：body内容。
	preActions	前置操作。
	protocol	协议类型，默认http。
	redirectCountLimit	是否重定向，0表示否，10表示是。
	timeoutInMilliSeconds	以毫秒为单位的超时时间。
condition	defaultAction	默认行为： action：动作，jump\|continue\|return 分别表示跳转｜继续｜结束。 target：目标API的ID。 conditions：判断条件： param：参数名。 operator：运算符。 value：对比值。
condition	actions	叠加条件。
dam	type	配置类型，BY_TIME｜BY_USER 分别表示按时间、按用户集合。
dam	target	目标量级。
datalnit	definitions	键值对结构，对应自定义参数。
datalnit	references	引用的文件参数： column：列名。 fileKey：文件索引。 fileName：文件名。 useOnce：是否只轮询一次。 asBase：是否作为基准列。 accessMethod：读取方式，inOrder｜inRandom分别表示按顺序读取及随机读取。 index：列索引。
dataDefine	definitions	键值对结构。
dataStore	dataSize	数据导出量级。
dataStore	dataConfig	数据导出配置： type：COOKIE\|FILE\|PARAM\|INSTRUCTION 分别表示 cookie｜文件参数｜出参｜数据指令。 params：参数列表。
delay	duration	延时时长，单位为毫秒。
ifBegin	ifEndNodeId	匹配的判断结束指令节点ID。
	operator	操作符。
	param	表达式。
	value	对比值。
ifEnd	ifBeginNodeId	匹配的判断开始指令节点ID。
repeatBegin	repeatEndNodeId	匹配的循环结束指令节点ID。
repeatEnd	repeatBeginNodeId	匹配的循环开始指令节点ID。
repeatEnd	repeatCount	循环次数。
wait	type	FIXED\|NORMAL\|UNIFORM分别表示固定分布、均匀分布、正态分布。
	base	对于固定分布代表固定值，对于均匀分布代表延迟基准，对于正态分布代表均值。
	scope	对于固定分布无意义，对于均匀分布代表可变跨度，对于正态分布代表方差。

Swagger脚本与PTS API压测的字段对应关系如下：

Swagger脚本字段	PTS API压测字段

Swagger脚本字段	PTS API压测字段
paths.key	请求URL。
paths.key.key	请求方法。
paths.key.key.parameters	请求Query参数或请求体。
definitions	请求体中使用的Schema。
tags[0].name	串联链路名。

操作步骤

登录PTS控制台，在左侧导航栏选择性能测试 > 导入场景。
在导入场景页面选择脚本类型，并上传脚本，然后单击确认。
导入成功后，在创建PTS场景页面，您可以看到脚本内容已转化为对应的API压测信息。
说明
- 可选择的脚本类型有JMeter（JMX）、Postman（JSON）、HTTP Archive Format（.har）、YAML和Swagger脚本（.yml，.json）。一个压测场景仅能导入一个脚本，在未保存场景配置前，可重新上传脚本覆盖之前的导入内容。
- PTS支持导入的脚本说明及字段含义，请参见脚本说明。请勿导入包含PTS不支持的类型或协议的脚本，若导入的脚本不合规，控制台将弹出错误提示框。