通用压测平台操作手册

平台概览与主流程

通用压测平台是京东云鼎提供的一站式自助性能压测 Web 控制台，用户通过「维护接口 → 准备参数文件（可选）→ 编排场景 → 发起任务 → 实时监控 → 查看 AI 报告」的闭环流程，即可对 HTTP 接口完成并行 / 串行发压、动态参数、断言校验、被压资源监控与容量稳定性验证，支撑大促、活动等高并发场景的上线前评估。 使用路径：云鼎控制台-云服务-监控与运维-通用压测平台

https://yd-performance-testing.jdcloud.com/overview

一次压测需依次经过四步：

1. 维护接口定义：定义要压测的 HTTP 接口，配置请求、断言与变量绑定，一个应用下可维护多个接口；
2. 准备参数文件（可选）：上传 CSV 动态参数数据，让每次请求携带不同数据，接口通过 ${变量} 引用；
3. 编排场景：选择接口并设置并行或串行发压方式，配置施压模型与被压资源监控；
4. 发起任务：分配压测机并启动任务，实时查看各接口 QPS/RT/成功率，结束后查看 AI 报告。

名词解释

维护接口定义

压测前先定义要压测的 HTTP 接口，配置请求、断言与变量绑定。一个应用下可维护多个接口。

进入接口管理

在顶部标签选择「接口管理」进入接口列表页。列表按应用维度展示接口，包含接口名、请求路径（前缀为请求方法）、用途。支持「编辑」「删除」操作；支持按「搜索接口名/请求路径」检索，点击右上角「新建接口」开始创建。

接口维护规则：需要完整维护应用下的核心接口，做到应压尽压

新建接口：填写基础信息与请求定义

点击「新建接口」弹出配置窗口，先填写基础信息，再配置请求定义：

1. 基础信息：必填项包括「归属应用」（选择接口所属应用）、「接口名」「用途」；
2. 请求定义：配置「请求方法」（GET/POST 等）、「请求 URL」（完整地址，支持 ${变量}，如 https://api.xxx.com/coupon/list）、「Query 参数」「Header」「Content-Type」「超时时间（ms）」（默认 3000）与「Body」（请求体模板，支持 ${变量名}）；
3. Body 编辑器支持「格式化」「校验 JSON」，便于检查模板合法性。

注意：Body 模板上限 256KB，超大内容请改用参数文件引用。一个接口配置包含「请求定义」「断言」「变量绑定」，按需逐项配置。

从 curl 导入请求

已有 curl 命令时，可点击「从 curl 导入」，粘贴命令后点击「解析并填充」，自动完成请求 URL、Query 与 Header 的填充。

注意：仅支持 bash/shell 格式的 curl 命令，不支持 PowerShell 的 curl.exe / Invoke-WebRequest；导入后将覆盖当前填写的请求 URL、Query 与 Header。

调试请求

请求定义填写完成后，点击「发送调试请求」验证配置。页面展示返回状态码、耗时与响应体，确认接口连通、请求参数正确后再保存接口。

调试变量：若请求中包含未绑定参数文件的变量，点击「发送调试请求」会弹出「填写调试变量」，需填写单次调试样例值后再发送；已绑定参数文件的变量按参数文件首行取值。

配置断言

「断言」用于判断请求是否成功，规则为全部断言通过才算请求成功。配置项包括：

• 类型：状态码、JSON 等；
• 提取路径/表达式：如 ${data.pageSize}；
• 判断条件与期望值：如 == 200 或 == 'success'。

调试过接口后，可点击「根据调试真实响应生成」或「生成断言」，基于真实响应自动生成断言规则；「+添加断言规则」可配置多条。

断言配置明细：类型支持 STATUS（状态码）、JSON_PATH（JSON 字段，提取路径如 $.code）、REGEX（正则）；判断条件支持 eq（等于）/ ne（不等于）/ gt（大于）/ lt（小于）/ contains（包含）/ exists（存在）；勾选「必过」后，该断言不通过即判定整条请求失败，直接影响报告成功率。新建时默认提供一条 STATUS eq 200。

配置变量绑定

「变量绑定」用于把参数文件列或请求取值绑定为变量，供请求中 ${变量} 引用：

• 快速绑定：枚举 Query/Header 所有可绑定值，下拉选择参数列直接写入 ${变量}；
• 选用参数文件列：通过「+ 绑定全局参数文件」绑定已上传的参数文件，请求中即可引用参数文件列；
• 变量来源体检（当前请求引用）：展示当前请求引用的变量名、引用位置与匹配来源。

注意：变量仅做字面量替换，不支持任何表达式或函数（例如禁止写 ${userId+1}），防止注入风险。

变量来源体检状态：绿色=命中参数文件列；红色=未绑定任何来源（保存时拦截）；橙色=来源冲突（需重命名后方可保存）。

准备参数文件（可选）

需要每次请求携带不同数据（如多账号、多订单）时，先上传 CSV 参数文件，再在接口的变量绑定中引用。

参数文件列表

选择「参数文件」标签进入列表页，支持按名称搜索；点击「上传参数文件」开始上传。

预览：只读弹窗展示文件前 100 行，内容不可在线编辑；删除：需二次确认，若被接口引用（引用数大于0）会展示红色风险提示「该文件被N个接口引用，删除后这些接口的变量将失效」。参数文件为全局资源，跨应用复用。

上传参数文件

1. 选择文件：仅支持 .csv 格式，文件大小不超过 100MB，选择后将自动解析；
2. 数据集名称：必填，用于后续绑定引用（最多 64 字符）；
3. 文件格式：CSV；
4. 读取模式：顺序循环或随机，决定每次请求的取数方式；
5. 点击「确认上传」完成。

编排压测场景

场景将多个接口组织为一次压测，选择并行或串行发压方式，并配置施压模型与被压资源监控。

压测场景列表

选择「压测场景」标签进入场景列表，操作列提供「发起任务」「查看任务」「编辑」「删除」；支持按应用筛选、按场景名称或 ID 搜索。

状态说明：当前时间早于执行区间开始时间=「未到执行区间」（灰），晚于结束时间=「已过期」（红），位于区间内=「就绪」（绿）；仅「就绪」场景可发起任务，其余状态按钮置灰并提示原因。同一场景同时仅允许 1 个运行中任务

新建场景：并行压测

点击「+新建场景」，按以下步骤配置：

1. 场景基础信息：填写「场景名称」（必填）、选择「关联应用」（必填）、设置「执行区间」（必填，快捷选择默认 5 分钟后开始）；
2. 压测编排：选择「并行压测」或「串行压测」，两者对比如下；
3. 接口配置：点击「选择接口」添加接口，并设置「压测模式」（固定 QPS-按时长 / 阶梯加压 / 业务峰谷模拟）、「目标 QPS」「持续时长（秒）」；
4. 页面自动汇总「总峰值 QPS」，平台单场景上限 2000 QPS。

选择接口：场景选接口仅限关联应用下的接口，不支持跨应用混选；同一接口可在同一场景重复选择（尤其串行多步骤场景）。 施压模式参数：恒定 QPS·按时长（目标 QPS、时长）；阶梯递增（起始 QPS、目标 QPS、梯度时长、总时长）；业务峰谷（起始 QPS、峰值 QPS、脉冲时长、总时长）。并行模式下每个接口可独立选择施压模式并填写对应参数。

新建场景：串行压测与链路条件

选择「串行压测」后，接口按序号顺序执行。串行场景下压测模式为「链路施压」，统一作用于整条链路，按顺序对每个接口施加相同强度；可设置目标 QPS 与持续时长。 链路接口可配置「返回校验表达式」（联合条件），校验上一接口的返回后再请求下一接口：设置条件（如 code）、判断条件（如 == 与期望值 'success'），多条条件可用「且（&&）」组合，支持「+添加联合条件」；配置完成后可点击「链路试运行」验证整条链路。

串行步骤卡：每个步骤包含「请求入参 / 通过条件 / 出参提取」三段。 链路试运行：串行链路需至少 2 个步骤且入参就绪后方可发起；以 1 个虚拟用户跑一遍链路，逐步更新各 Step 状态，可展开查看请求/响应/提取结果/断言结果。串行链路 QPS 语义为「每秒完整链路数」，同样受单场景 2000 QPS 上限约束。

配置被压资源监控

在新建场景弹窗中配置「被压资源监控」，选择本次压测要观测的服务端资源，压测报告将展示这些资源的 CPU/内存/连接使用率等水位。提供两种方式：

• 关联应用拓扑：直接沿用该应用在稳定性平台维护的资源拓扑；支持「前往稳定性平台维护」「刷新」；这些资源的水位将出现在压测报告的「服务端指标」章节；
• 自定义选择资源：从云鼎全部资源中按需勾选云主机、缓存、数据库等，可按区域筛选、搜索名称/IP，右侧「已选」列表可移除。

发起任务与查看结果

发起压测任务

在场景列表点击「发起任务」，弹窗确认场景名称、总峰值 QPS、关联应用等信息，点击「确认发起」后平台分配压测机并启动任务。

注意：发起前请确认执行区间已到、场景状态为「已生效」。

发起前置条件：场景状态须为「就绪」（位于执行区间内），未到或已过期不可发起；确认发起后进入实时监控。

任务实时监控

任务运行中可实时查看：

• 任务信息、核心进展：已运行时长/总时长、完成进度、关键压测指标：QPS、成功率、TP99 耗时、错误数；接口维度指标：各接口的平均 QPS、成功率、平均 RT、TP99、错误数；关键趋势：整体响应时间（TP50/TP90/TP99）与接口 TP99 响应时间折线图。

任务运行期间可点击「暂停」「终止」控制任务；切换「云资源监控」标签查看被压资源水位。

任务状态与操作：任务状态包括预热中、运行中、已暂停、已完成、已终止；运行中可「暂停」，已暂停可「恢复」，运行中与已暂停均可「终止」。 云资源监控：展示被压资源水位，如主机内存使用率、主机 CPU 平均使用率折线，数据库 CPU/内存/磁盘、Redis 内存等（多实例）。数据加载失败时展示错误提示并可重试，监控无数据时展示占位提示。

场景详情：概览

点击场景名称进入场景详情，概览页展示接口数、总峰值 QPS、单场景 QPS 上限（2,000）、最近任务状态，以及各接口的请求路径、施压模式与目标峰值 QPS；右上角可「编辑场景」「发起任务」。

场景详情：压测任务

切换「压测任务」标签查看该场景的历史任务列表，包含任务 ID、状态（待执行/运行中/已完成）、开始时间、结束时间；已完成任务可点击「查看监控」「查看报告」，其他状态任务可「查看监控」。

任务详情（已完成）

任务结束后进入任务详情，可查看完整运行数据：核心进展、关键压测指标（QPS/成功率/TP99 耗时/错误数）、接口维度指标与关键趋势图表，点击「查看压测报告」进入 AI 报告。

压测报告

报告页展示：

• 报告信息；
• 智能解读：稳定性自动验收结论与优化建议（如全局成功率、平均响应时间、TP99、系统整体 QPS 与准入标准对比）；
• 关键压测指标：压测总时长、总请求量、峰值 QPS、平均 RT、TP99 耗时、总体成功率；
• 接口维度诊断：各接口的 QPS、成功率、平均 RT、TP99、错误数与主要错误，并附每接口的智能建议（诊断概述/风险项/优化建议）。

支持「导出 PDF」留存报告，或「已标记为最优报告」作为历史最优记录。