Notion 与 k6 / Locust 全链路性能压测基线、P99 延迟回写及发布前容量门禁治理实战:从接口 SLA 契约台账、CI 压测结果幂等入库到 Formula 2.0 性能回归熔断闭环
2026 年 11 月 19 日
一、为什么性能压测报告只留在 CI 日志里会导致“上线即雪崩”? #
在电商大促备战、SaaS 核心网关迭代与高并发 API 重构过程中,k6(基于 Go 协程的高性能现代压测工具)与 Locust(基于 Python 编写的分布式用户行为压测框架)是产研团队最常使用的负载测试引擎。然而,许多团队虽然在 CI/CD 中接入了脚本,却依然在真实流量洪峰下频繁遭遇接口超时甚至雪崩,核心症结在于以下三点:
- 压测历史指标与版本基线断裂:某次发布前将核心下单接口的 P99 延迟从
120ms劣化到了290ms,但由于压测结果只躺在某次 CI Job 的终端日志里,研发与发布经理缺乏跨版本的纵向基线比对能力,轻易放行了性能退化代码。 - 压测环境口径与 SLA 契约缺乏统一台账:测试脚本里的并发 VU 数、目标 QPS、是否开启缓存预热、压测集群规格等信息散落在各项目仓库中,导致不同时间测出的数据无法横向对比。
- 瓶颈定位后的优化整改缺少追踪闭环:一次压测暴露出的慢 SQL、连接池打满或下游超时问题,口头同步给开发后石沉大海,下个迭代无人复测验收。
| 评估维度 | 本地临时执行 + 截图发群 | 仅依赖 CI 控制台日志 / 监控曲线 | Notion + k6 / Locust 容量治理中枢 |
|---|---|---|---|
| 接口 SLA 基线与版本追溯 | 随群消息过期丢失,无法形成历史曲线 | 日志按流水保留期过期,难跨月比对基线 | 为每个压测场景建立不可变基线 P99 与目标 RPS 台账,长期留痕 |
| 性能回归(Regression)卡点 | 完全依赖测试人员肉眼比对数字 | 需要手写复杂脚本解析历史文件做对比 | Formula 2.0 自动对比最新 P99 与基线红线及错误率,超标即亮红灯阻断 |
| 测试环境与脚本口径对齐 | 经常出现“换了个并发参数结果对不上” | 参数硬编码在 YAML 中,非研发难以查阅 | 台账统一登记脚本路径、压测环境、目标 VU 与数据构造前置条件 |
| 性能瓶颈修复闭环 | 缺少工单跟踪,复测验证容易遗漏 | 监控只反映现象,不承载优化任务分配 | 劣化流水直接关联瓶颈整改单,必须完成复测绿灯才允许闭环 |
二、Notion 性能压测与容量治理三表数据库架构 #
遵循“Notion 仅沉淀压测场景基线、每次汇总的 P95/P99/RPS 摘要快照及瓶颈整改工单,海量秒级采样点保留在 Prometheus / Grafana 或对象存储中”的原则,在团队空间构建三表关联模型(多表关联与汇总规范可参阅 关系和汇总官方指南 与 数据库架构速查表):
| 数据库名称 | 核心属性(字段名与类型) | 角色职责与权威来源(SSOT) |
|---|---|---|
DB_LoadTest_Scenarios(压测场景与容量基线主档) | Scenario_Key (Title,如 checkout-create-order-prod-like)、压测引擎 (Select:k6/Locust/JMeter)、目标环境 (Select:Staging-全链路/Perf-独立压测池)、基线_P99_ms (Number,如 180)、容忍劣化比例_百分比 (Number,如 20)、目标最低_RPS (Number)、最大允许错误率_百分比 (Number,如 0.5)、负责人 (Person)、关联压测流水 (Relation -> DB_LoadTest_Runs)、关联性能瓶颈 (Relation -> DB_Bottleneck_Issues)、容量发布门禁 (Formula 2.0) | 登记全公司核心接口与关键业务流量的性能验收红线与基线标准 |
DB_LoadTest_Runs(CI 压测执行与 P99 回写台账) | Run_UID (Title,如 PERF-checkout-create-order-gh9421)、关联场景 (Relation -> DB_LoadTest_Scenarios)、Git_Commit_SHA (Text)、并发VU数 (Number)、实测_RPS (Number)、P95_ms (Number)、P99_ms (Number)、错误率_百分比 (Number)、执行时间 (Date)、详细报告链接 (URL) | 接收 GitHub Actions / GitLab CI 压测结束后回写的汇总指标快照 |
DB_Bottleneck_Issues(性能瓶颈定位与调优台账) | Issue_UID (Title,如 BOTTLE-20261119-01)、关联场景 (Relation -> DB_LoadTest_Scenarios)、瓶颈分类 (Select:慢SQL与索引缺失/连接池耗尽/外部依赖阻塞/JVM或内存GC抖动)、整改状态 (Status:待排查/优化中/待压测复验/已达标关闭)、负责人 (Person) | 闭环管理压测中暴露的性能缺陷,在未复测通过前阻断场景门禁 |
三、五步搭建 k6 / Locust 自动化压测回写与性能基线对比流水线 #
结合 创建 Notion API 集成指南 与 Notion API 速率限制与容错实战,按以下五步将压测结果自动化沉淀至 Notion(可与 Notion 与 Playwright / Cypress E2E 端到端自动化测试治理实战 及 Notion 与 Datadog / Grafana / Prometheus 云原生可观测性巡检实战 联动构成完整质量门禁):
- 创建最小权限 Integration 并锁定场景主键:在 Notion 建立
Perf_Governance_Reporter集成并仅授权上述三张数据库;统一约定以小写短横线格式的Scenario_Key作为脚本环境变量标识。 - 输出结构化压测 Summary 文件:在 k6 中通过
--summary-export=k6-summary.json导出精确分位数(或 Locust 使用--csv/ JSON reporter 汇总p95、p99、rps与fail_rate)。 - 部署带
429退避与Run_UID幂等查重的 Node.js 回写脚本:CI 重试任务不会在 Notion 中产生重复压测流水记录:
import fs from 'node:fs';
import { setTimeout as sleep } from 'node:timers/promises';
const NOTION_TOKEN = process.env.NOTION_TOKEN;
const SCENARIOS_DB_ID = process.env.NOTION_LOADTEST_SCENARIOS_DB_ID;
const RUNS_DB_ID = process.env.NOTION_LOADTEST_RUNS_DB_ID;
async function notionCall(path, method, body) {
for (let attempt = 0; attempt < 5; attempt++) {
const res = await fetch(`https://api.notion.com/v1${path}`, {
method,
headers: {
Authorization: `Bearer ${NOTION_TOKEN}`,
'Notion-Version': '2022-06-28',
'Content-Type': 'application/json',
},
body: body ? JSON.stringify(body) : undefined,
});
if (res.status === 429) {
const waitSec = Number(res.headers.get('retry-after') || '2');
await sleep(waitSec * 1000);
continue;
}
if (!res.ok) {
throw new Error(`Notion API ${res.status}: ${await res.text()}`);
}
return res.json();
}
throw new Error('Notion API 退避重试次数耗尽');
}
export async function reportK6SummaryToNotion({
scenarioKey,
summaryPath,
ciRunId,
commitSha,
reportUrl,
}) {
const normalizedKey = String(scenarioKey).trim().toLowerCase();
const scenarioQuery = await notionCall(`/databases/${SCENARIOS_DB_ID}/query`, 'POST', {
filter: { property: 'Scenario_Key', title: { equals: normalizedKey } },
page_size: 1,
});
const scenarioPageId = scenarioQuery.results?.[0]?.id;
if (!scenarioPageId) {
throw new Error(`未在 DB_LoadTest_Scenarios 登记的压测场景: ${normalizedKey}`);
}
const raw = JSON.parse(fs.readFileSync(summaryPath, 'utf8'));
const durationMetrics = raw.metrics?.http_req_duration?.values || {};
const reqsMetrics = raw.metrics?.http_reqs?.values || {};
const failedMetrics = raw.metrics?.http_req_failed?.values || {};
const vusMax = raw.metrics?.vus_max?.values?.max || 0;
const p95Ms = Math.round((durationMetrics['p(95)'] || 0) * 10) / 10;
const p99Ms = Math.round((durationMetrics['p(99)'] || 0) * 10) / 10;
const rps = Math.round((reqsMetrics.rate || 0) * 10) / 10;
const errorRatePct = Math.round((failedMetrics.rate || 0) * 10000) / 100;
const runUid = `PERF-${normalizedKey}-${ciRunId}`.slice(0, 180);
const existingRun = await notionCall(`/databases/${RUNS_DB_ID}/query`, 'POST', {
filter: { property: 'Run_UID', title: { equals: runUid } },
page_size: 1,
});
const props = {
Run_UID: { title: [{ text: { content: runUid } }] },
关联场景: { relation: [{ id: scenarioPageId }] },
Git_Commit_SHA: { rich_text: [{ text: { content: String(commitSha || '').slice(0, 40) } }] },
并发VU数: { number: Number(vusMax) },
实测_RPS: { number: rps },
P95_ms: { number: p95Ms },
P99_ms: { number: p99Ms },
错误率_百分比: { number: errorRatePct },
执行时间: { date: { start: new Date().toISOString() } },
详细报告链接: reportUrl ? { url: reportUrl } : undefined,
};
if (existingRun.results?.length > 0) {
await sleep(350);
await notionCall(`/pages/${existingRun.results[0].id}`, 'PATCH', { properties: props });
} else {
await sleep(350);
await notionCall('/pages', 'POST', {
parent: { database_id: RUNS_DB_ID },
properties: props,
});
}
}
- 将详细时序报告持久化外链:将 Grafana 快照面板或归档 HTML 报告上传至企业对象存储后填入
详细报告链接,避免直接引用会在 7 天后过期的 CI Artifact 下载地址。 - 配置自动化回归阻断告警:通过 Notion Automations 自动化触发器详解,当某压测场景的
容量发布门禁变为红灯熔断状态时,自动 @ 通知场景负责人与发布值班经理介入排查。
四、Formula 2.0 P99 延迟回归与错误率熔断门禁公式 #
在 DB_LoadTest_Scenarios 中添加 Formula 2.0 属性 容量发布门禁(更多函数语法可参阅 Notion 公式核心指南 与 Formula 2.0 实战速查表),自动对比最新一次压测流水的实测 P99 延迟、RPS 吞吐量、错误率以及尚未复验关闭的性能瓶颈工单:
lets(
baseP99, if(empty(prop("基线_P99_ms")), 200, prop("基线_P99_ms")),
maxDegPct, if(empty(prop("容忍劣化比例_百分比")), 20, prop("容忍劣化比例_百分比")),
minRps, if(empty(prop("目标最低_RPS")), 0, prop("目标最低_RPS")),
maxErrPct, if(empty(prop("最大允许错误率_百分比")), 0.5, prop("最大允许错误率_百分比")),
runs, prop("关联压测流水"),
sortedRuns, runs.sort(current.prop("执行时间")),
latestRun, sortedRuns.last(),
latestP99, if(empty(latestRun), 0, latestRun.prop("P99_ms")),
latestRps, if(empty(latestRun), 0, latestRun.prop("实测_RPS")),
latestErr, if(empty(latestRun), 0, latestRun.prop("错误率_百分比")),
p99Limit, round(baseP99 * (1 + maxDegPct / 100)),
openBottlenecks, prop("关联性能瓶颈").filter(
current.prop("整改状态") != "已达标关闭"
).length(),
ifs(
runs.length() == 0,
style("⚪ 尚无压测执行记录 · 禁止直接上线", "gray"),
latestErr > maxErrPct,
style("🛑 错误率熔断 (" + latestErr + "% > " + maxErrPct + "%) · 阻断发布", "red", "bold"),
latestP99 > p99Limit,
style("🚨 P99 严重回归 (" + latestP99 + "ms > 红线 " + p99Limit + "ms)", "red", "bold"),
minRps > 0 && latestRps < minRps,
style("🔥 吞吐量未达标 (" + latestRps + " RPS < 目标 " + minRps + ")", "orange", "bold"),
openBottlenecks > 0,
style("⚠️ 有 " + openBottlenecks + " 项瓶颈未复验关闭", "yellow"),
style("🟢 容量基线达标 · P99 " + latestP99 + "ms / " + latestRps + " RPS", "green")
)
)
五、性能压测与 Notion 协同常见故障排查清单 #
| 常见故障现象 | 根本原因 | 标准化工程修复方案 |
|---|---|---|
| CI 重跑同一流水线后,Notion 生成两条相同的压测流水记录 | Run_UID 拼接了毫秒级执行时间戳而非 CI 不可变构建号 | 统一以 PERF-{scenarioKey}-{ciRunId} 作为幂等 Run_UID 主键,先查询后 PATCH 更新 |
k6 压测报告 p(99) 字段在脚本中读取为 undefined | k6 默认仅计算 p(90) 和 p(95),未在命令行或脚本配置开启 p(99) 统计 | 启动压测时显式传入 --summary-trend-stats="avg,min,med,max,p(90),p(95),p(99)" |
| 压测场景被误改名后,回写脚本报“未登记的压测场景”中断 CI | 将可变的中文描述写入 Scenario_Key 并被后续人工润色修改 | 严格将英文小写短横线代号设为 Scenario_Key 不可变主键,中文说明单独放在备注字段 |
Notion 中部分历史 详细报告链接 打开提示 404 或签名过期 | 回写了 CI 平台临时产物(Artifact)受限下载链接或带有效期签名的对象存储 URL | 在 CI 上传阶段将报告发布至永久内网静态报告站点或长期存储桶路径再回写 URL 属性 |
- 全链路质量治理延伸阅读:若需要打通接口功能回归与发布前自动拦截,可结合 Notion 与 Postman / Bruno / Newman API 自动化测试及接口契约回归治理实战;遇到 Notion API 速率限制或公式属性异常,请参阅 Notion 常见报错与故障诊断手册。
核心手册与速查工具矩阵
高频速查手册与生产力工具直达常见问题与答疑 (FAQ)
高频疑难解析与避坑指南A
完全不需要。绝大多数核心功能在免费 Free 计划中均可完整体验与实操练习,无需额外付费购买 Plus 或团队版。