k6 指标的使用

(Grafana k6 登堂入室, Part 4)

指标

指标用于衡量系统在测试条件下的表现。默认情况下，k6 会自动收集内置指标。除此之外还可以创建自定义指标。

指标主要分四类：

• 计数器指标（Counters）用于累加数值。
• 仪表指标（Gauges）跟踪最小值、最大值和最新值。
• 速率指标（Rates）记录非零值的发生频率。
• 趋势指标（Trends）计算多组值的统计信息（如平均值、众数或百分位数）。

若要让测试因未满足特定条件而失败，可以通过基于指标条件编写阈值（Threshold）实现（具体表达式形式取决于指标类型）。要筛选指标，可使用标签（Tags）和分组（groups）。你还可以将指标以多种汇总或精细格式导出。

内置指标

每个 k6 测试都会生成内置和自定义指标。每个支持的协议也都有其特定的指标。

标准内置指标

HTTP 专用内置指标

对于所有 http_req_* 指标，其时间戳会在请求结束时记录。换句话说，当 k6 接收到响应体末尾或请求超时时，就会生成该时间戳。

内置 WebSocket 指标

内置 gRPC 指标

自定义指标

除了内置指标外，你还可以创建自定义指标。每种指标类型都有一个用于创建自定义指标的构造函数，该构造函数会生成声明类型的指标对象，每种类型都提供 add 方法来实现指标测量。

创建自定义指标

自定义指标必须在初始化阶段创建。这一限制既控制了内存占用，又能确保 k6 验证所有阈值时对应的指标均已正确定义。下面是详细步骤：

import http from 'k6/http';
// 1. 导入 k6/metrics 模块。也可以通过命名导入的方式指定要创建的指标类型
import { Trend } from 'k6/metrics';

// 2. 创建自定义趋势指标 myTrend，在结果输出中对应的指标名称显示为 waiting_time
const myTrend = new Trend('waiting_time');

export default function () {
  const r = http.get('https://quickpizza.grafana.com/');
  // 3. 使用 add 方法，将数据加入指标中
  myTrend.add(r.timings.waiting);
  console.log(myTrend.name); // waiting_time
}

查看自定义指标结果

自定义指标会出现在测试结果输出中，既包含测试结束时的总结，也包含详细的数据点。每种指标类型都有特定的聚合方法。你还可以为自定义指标的任意值添加标签，这些标签可用于筛选测试结果。

以下是前面脚本的输出可能在测试结束摘要中的显示方式。由于该指标是趋势型指标，k6 会根据数值数量及其总和计算各类趋势数据。

$ k6 run script.js

  ...
  INFO[0001] waiting_time                                  source=console

  ...
  iteration_duration.............: avg=1.15s    min=1.15s    med=1.15s    max=1.15s    p(90)=1.15s    p(95)=1.15s
  iterations.....................: 1     0.864973/s
  waiting_time...................: avg=265.245396 min=265.245396 med=265.245396 max=265.245396 p(90)=265.245396 p(95)=265.245396
``