Grafana K6 现代负载测试入门

Grafana K6 是一款代码优先的开源负载测试工具,用 JavaScript 编写测试脚本。本文讲解 K6 的安装、脚本结构、负载曲线配置、用户旅程建模与结果分析方法。

最佳实践
测试检测与质量验证插画

本文依据官方文档整理,未执行 k6 负载验证或性能基准。代码片段展示局部用法,业务接口、数据和环境需按项目补齐;版本与配置以所引文档为准。

直接回答:Grafana k6 是一款面向开发者与测试工程师的开源负载测试工具,重要特点是用 JavaScript 编写测试脚本(代码优先),通过虚拟用户或到达率模型施压,并输出测试指标。 引擎由 Go 实现,现代版本也支持 TypeScript,但脚本不在 Node.js 中运行;能承载多少负载取决于脚本、协议与施压机资源,不能预先保证“轻松模拟成千用户”。它在 2021 年被 Grafana Labs 收购,测试结果可通过相应后端在 Grafana 中查看。

为什么是 K6

K6 把测试脚本当普通代码对待:可以进 Git、可以 code review、可以在 CI 里跑。JMeter、Locust 等也有非 GUI 或脚本化执行方式,不能把版本管理与 CI 当作 k6 独有优势;应按语言、协议、运行模型与维护方式比较。

k6 有自己的 JS/TS 运行环境,不能直接把依赖 Node.js 内置 API 的包当作可用模块。本文示例是协议层 HTTP 请求,不执行页面 JavaScript 或浏览器渲染;浏览器测试需要对应模块和额外资源预算。

安装

保存下文为 script.js,运行前将获授权测试环境的接口基址导出为 BASE_URL,不要附查询参数或片段。api.example.com 一类地址只是占位说明,不是可用的压测 API。

# macOS 安装
brew install k6

# 准备好 script.js 与 BASE_URL 后在本机执行
k6 run script.js

# 或用 Docker:转入已导出的 BASE_URL,并从标准输入读取脚本
docker run --rm -i -e BASE_URL grafana/k6:2.3.0 run - < script.js

Docker 示例固定使用核验时的 2.3.0 标签;标签不是内容不可变的保证,需要时可用核验过的 digest 固定镜像。-i 保留脚本的标准输入,读取其他本地文件或相对模块时还需配置挂载路径。Homebrew 安装的版本可能不同,先以 k6 version 核对。安装 · 运行脚本

第一个脚本

import http from 'k6/http';
import { check, sleep } from 'k6';

if (!__ENV.BASE_URL) throw new Error('Set BASE_URL to an authorized test API');
const baseUrl = __ENV.BASE_URL.replace(/\/+$/, '');

export const options = {
    vus: 20,          // 20 个虚拟用户,不是 20 RPS
    duration: '30s',  // 固定 VU 场景的运行时长
    thresholds: {
        http_req_failed: ['rate<0.01'],
        http_req_duration: ['p(95)<500'],
        checks: ['rate>0.99'],
    },
};

export default function () {
    const res = http.get(`${baseUrl}/users`);
    check(res, {
        '状态码是 200': (r) => r.status === 200,
        '响应小于 500ms': (r) => r.timings.duration < 500,
    });
    sleep(1);
}

vus 与 duration 是固定 VU 场景的简写,每个 VU 反复执行请求与 sleep,不是承诺固定 RPS;结束时还受 graceful stop 等设置影响。接口 /users 与返回 200 的约定须由项目提供。

check 记录通过/失败,单独失败不会使进程以失败码退出;CI 门禁需设置 thresholds。例中 rate<0.01 要求请求失败比例严格小于 1%,p(95)<500 要求该时长指标的 P95 严格小于 500ms,checks 则是两项检查合在一起的通过率,要求严格大于 99%,不是每项检查各自达到 99%。若要分别约束,需要按检查或请求标签设置相应阈值。

http_req_failed 根据预期响应判定,默认将 200–399 视为预期;这与 status === 200 的自定义检查不是同一口径。未筛选的 http_req_duration 阈值覆盖该指标的所有请求样本,不只成功请求或某个接口,也不是用户耗时比例;其时长为发送、等待与接收之和,不含最初 DNS 查询、连接建立等时间。

这些数值仅演示语法,不是通用 SLO。仅压测自己拥有或获授权的隔离环境,先用少量 VU 检查脚本、数据与施压机余量。普通 threshold 默认不是即时中止开关;提前退出需明确配置 abortOnFail 等机制,资源与费用限制还需相应数据或外部控制。订单用例必须使用测试订单和支付沙箱。Checks 与 thresholds · 预期响应

负载曲线:不只是"固定并发"

K6 的 stages 可以刻画 VU 数量随时间的变化。下面是替换前面 options 的另一种配置;不要在同一脚本里重复声明 options,也不要把固定场景的 vus/duration 简写直接叠上去:

export const options = {
    stages: [
        { duration: '2m', target: 100 },  // 2 分钟内增加到 100 VU
        { duration: '5m', target: 100 },  // 保持 100 VU 5 分钟
        { duration: '2m', target: 0 },    // 2 分钟内降到 0 VU
    ],
};

target 是 VU 数,不是请求/秒。响应变慢、每次迭代请求数或思考时间改变时,即便 VU 相同,实际吞吐也会变化。这类配置可组合阶梯、尖峰(spike)、浸泡(soak)等模式;替换示例并没有保留前面的 thresholds,需要按同一测试目标补回所需阈值。Ramping VUs

建模真实用户旅程

用户行为流适合检查跨接口的业务过程,单个接口测试仍适合定位容量或回归。下面是独立脚本,按一套示例 API 契约编写:登录接收 JSON user/pass,成功返回 200 和字符串 token;商品返回含 sku 的数组;测试订单返回 201 和字符串 id。这些路径与字段不是 k6 提供的公共接口,要与项目逐项对应。

除 BASE_URL 外,还需提供 TEST_USER、TEST_PASS、TEST_SKU;使用 Docker 时须显式传入这些环境变量。示例只执行一次旅程,扩成并发测试前还要准备隔离的账户、SKU 和测试数据。

import http from 'k6/http';
import { check, sleep } from 'k6';

const required = ['BASE_URL', 'TEST_USER', 'TEST_PASS', 'TEST_SKU'];
if (required.some((key) => !__ENV[key])) {
    throw new Error('Set BASE_URL, TEST_USER, TEST_PASS, and TEST_SKU for your test API');
}
const baseUrl = __ENV.BASE_URL.replace(/\/+$/, '');
export const options = { vus: 1, iterations: 1, thresholds: { checks: ['rate==1'] } };

function jsonOrNull(response) {
    try { return response.json(); } catch (_) { return null; }
}

export default function () {
    const login = http.post(`${baseUrl}/login`, JSON.stringify({
        user: __ENV.TEST_USER, pass: __ENV.TEST_PASS,
    }), { headers: { 'Content-Type': 'application/json' } });
    const loginBody = jsonOrNull(login);
    const token = typeof loginBody?.token === 'string' ? loginBody.token : '';
    if (!check(login, { '登录返回 200 和 token': (r) => r.status === 200 && token.length > 0 })) {
        sleep(1);
        return;
    }
    const params = { headers: {
        Authorization: `Bearer ${token}`, 'Content-Type': 'application/json',
    } };
    const products = http.get(`${baseUrl}/products`, params);
    const catalog = jsonOrNull(products);
    if (!check(products, { '商品列表含测试 SKU': (r) => r.status === 200
        && Array.isArray(catalog) && catalog.some((item) => item?.sku === __ENV.TEST_SKU) })) {
        sleep(1);
        return;
    }
    const order = http.post(`${baseUrl}/orders`, JSON.stringify({
        sku: __ENV.TEST_SKU, qty: 1,
    }), params);
    const created = jsonOrNull(order);
    check(order, { '测试订单已创建': (r) => r.status === 201
        && typeof created?.id === 'string' && created.id.length > 0 });
    sleep(2);
}

jsonOrNull 将非 JSON 响应转成失败检查,避免登录响应解析异常直接中断后续判断。认证或商品检查失败就返回,不继续发依赖它们的订单请求;订单本身也检查结果。这里的 checks 阈值要求全部已执行检查通过,不能代替业务正确性、清理测试数据或吞吐目标的定义。

结果怎么看

K6 默认输出一组核心指标;应区分请求、迭代与检查:

指标 含义
http_req_duration HTTP 请求发送、等待、接收的时长分布,不含最初 DNS/连接时间;P90/P95 是请求样本的分位数
http_req_failed 按预期响应规则判定的失败请求比例,不等同所有业务错误
vus / iterations 当前活动 VU 数 / 累计迭代数;一次旅程可有多次 HTTP 请求,也可能提前返回
checks 所有已执行检查的通过率;细分结果与请求、用户数不是同一统计口径

按对应输出配置结果后端,例如当前文档中的实验性 experimental-prometheus-rw,发送到支持且已配置的 Prometheus remote-write 接收端。Grafana 查询这个存储后端做可视化,并非任意 --out 都能直接写入的时序存储。接收端地址、认证、TLS 与所用版本仍需匹配。内置指标 · Prometheus remote write

记录每轮压测起止时间、目标版本与测试标识,将延迟上升区间与应用日志、资源水位对齐。需要进一步拆分服务端耗时时,可为受测应用埋点并按 OpenTelemetry 接入观测云,检查同一窗口的下游 Span;这与 k6 结果输出是两条独立数据路径。k6 标签不会自动变成应用日志或 Span 字段;传测试标识需要项目约定的请求头和应用记录方式,链路关联还要核对上下文传播、采样、保留期与访问权限,不能用未收集的链路补全整轮负载。

常见问题(FAQ)

Q:K6 和 JMeter、Locust 怎么选?
A:可按脚本语言、协议支持与团队经验比较:k6 使用其自己的 JS/TS 运行环境,并不等同 Node.js;Locust 使用 Python;JMeter 可用非 GUI 模式执行负载。性能须按同一场景评估,不能保证某工具在任意脚本下承载更多 VU。

Q:K6 脚本里的 sleep 是必须的吗?
A:取决于负载模型。模拟用户会话时使用思考时间;arrival-rate executor 已控制迭代到达率,通常不在迭代末额外 sleep。迭代到达率也不是 HTTP RPS,一次旅程可能有多个请求。VU 数不等于固定 RPS,施压机也可能成为瓶颈。

Q:压测环境怎么选?
A:尽量用与生产同构的预发环境;直接压生产需严格评估风险,并做好限流兜底与随时中止预案。预发的资源、数据量与依赖若不同,也不能把结果直接当作生产容量保证。

官方参考

资料核对日期:2026-11-05。示例镜像版本为 2.3.0;后续版本应重新核对运行行为和输出支持。

延伸阅读

获取专属方案

联系我们

加入社区

微信扫码
加入官方交流群

立即体验

在线开通,按量计费,真正的云服务!

立即开始

选择观测云版本

代码托管平台