请求录制与回放

更新时间:
复制 MD 格式

请求录制与回放功能支持录制一段时间内的真实请求,并按照指定倍率进行回放,用于在服务发布、配置变更或性能优化后验证线上服务表现。

功能概述

请求录制与回放适用于以下场景:

  • 服务发布后验证:录制发布前的线上流量,发布后回放对比性能指标。

  • 配置变更回归:修改调度策略、限流规则等配置后,回放真实流量验证配置效果。

  • 性能优化对比评测:优化推理引擎或模型后,回放相同流量对比优化前后的性能差异。

核心流程分为三步:录制 → 回放 → 观测。

重要

录制与回放数据均存储在服务所在节点的本地临时磁盘上,服务重启后所有数据将被清除。请及时备份重要数据,并注意磁盘占用,磁盘接近用满时将不允许发起录制。

录制

在线录制

  1. TokenWorks左侧导航栏,单击请求回放

  2. 单击开始录制,配置以下参数:

    • 名称(可选):录制任务的名称,如 production-baseline-2026-07。

    • 备注(可选):录制任务的备注信息,如 v2.3 发布前测试。

    • 最长录制时长(秒,0=不限):录制的最大持续时间,默认 300 秒。

    • 最大请求数(0=不限):录制的最大请求数量,默认 0(不限)。

    达到时长或请求数上限时自动停止录制。

  3. 单击开始,启动录制。

导入录制

支持上传已有的录制数据文件。在录制页签右上角单击上传录制按钮,选择本地录制文件上传。

回放

  1. 在请求回放页面,单击发起回放,配置以下参数:

    • 录制(必填):从下拉列表中选择已录制的任务。

    • 名称(可选):本次回放任务的名称。

    • 备注(可选):本次回放的备注信息。

    • 倍速(必填):通过滑块调节回放速度,范围 0.1x ~ 2x,默认 1.0x(原始速度)。0.1x 表示减速到原始速度的十分之一,2x 表示加速到原始速度的两倍。

  2. 回放完成后,可在回放列表查看任务状态和结果。

分析对比

回放完成后,可在回放列表中单击对比,进入录制与回放的分析对比页面。对比页面左右并列展示录制和回放的完整性能指标,帮助您判断服务变更前后性能是否一致。

对比目的

通过对比录制(变更前)和回放(变更后)的性能指标,验证服务变更是否引入性能退化:

  • 指标相近:变更未对性能产生明显影响,可放心上线。

  • 指标差异明显:需要排查变更内容,定位性能退化原因。

关键指标说明

指标

说明

TTFT(首 Token 延迟)

从用户发出请求到收到第一个 Token 的时间,反映模型的响应速度。值越小,用户感知等待越短。

E2E(端到端延迟)

完整请求的总耗时,从发送请求到收到完整响应。包含 TTFT 和所有 Token 的生成时间。

TPOT(每 Token 处理时间)

生成每个 Token 的平均时间,反映模型的生成速度。值越小,文本生成越快。

ITL(插值延迟)

相邻 Token 之间的间隔时间,与 TPOT 类似,用于衡量生成流畅度。

命中率

KV Cache 的缓存命中比例。实际命中率越高,说明缓存复用效果越好,推理效率越高。

Token 吞吐

单位时间内处理的 Token 数量(Token/s),反映系统的整体处理能力。

状态码分布

请求的 HTTP 状态码分布(如 200、500 等),用于判断请求成功率。