k6 v0.41.0 版本解读指标时序重构、高基数元数据支持与 gRPC 增强【免费下载链接】k6A modern load testing tool, using Go and JavaScript项目地址: https://gitcode.com/GitHub_Trending/k6/k6k6 v0.41.0 是 grafana/k6 项目在 Go JavaScript 压测引擎演进中的一个关键版本它面向用户的改动相对较少但内部完成了一次影响深远的指标子系统重构为后续的时间序列聚合与分布式追踪等功能铺平了道路。本文基于官方发布说明 release notes/v0.41.0.md结合当前仓库源码完整解读本版本的破坏性变更、新特性、Bug 修复与内部架构改进帮助你评估升级影响并理解 k6 指标系统的底层设计。升级前必读本版本的破坏性变更v0.41.0 的破坏性变更主要源于指标子系统的根本性重构官方在 v0.39.0、v0.40.0 发布说明中已提前预告虽然对 JavaScript API 暂无影响但以下三点需要在使用脚本与输出系统时特别注意。url、iter、vu系统指标标签的行为变化url标签与name标签统一对应 PR #2703当 HTTP 请求使用了 URL 分组即使用http.url()帮助函数或显式指定name指标标签时生成的http_req_*指标样本中的url标签将与name标签取相同的值。此前这一行为只在云输出cloud output中生效现在则在所有输出中统一生效。vu与iter标签转为高基数元数据对应 PR #2726vu虚拟用户编号和iter迭代序号两个系统标签默认处于禁用状态现在被改造为高基数high-cardinality指标元数据。这意味着它们不再可用于阈值thresholds表达式中各输出端可能以不同方式输出它们或完全忽略它们。Go 指标 API 的变化v0.41.0 对内部 Go API 做了大规模重构对应 PR #2594、#2726、#2727其中metrics.Sample和metrics.TagSet两个类型被彻底重写。虽然 JavaScript API 没有变化但任何直接使用这两个 Go 类型的外部代码如 xk6 扩展在升级后都需要适配。k6 convert正式弃用k6 convert是一个将 HAR 文件HTTP 流量录制格式转换为粗略等价请求的初步 k6 脚本的子命令。它长期缺乏维护官方一直建议使用功能更丰富的独立转换器 har-to-k6本次版本正式将其标记为弃用该命令仍然可用并且会在后续若干个 k6 版本中继续工作它不再出现在k6 --help帮助信息中使用时会产生弃用警告。官方建议迁移到独立的 har-to-k6 转换器若遇到问题可在其仓库中反馈。新特性与 UX 改进gRPCClient.connect()新增maxReceiveSize与maxSendSize参数PR #2679k6/net/grpc模块的Client.connect()方法新增了两个可选参数用于控制 gRPC 消息大小上限。在源码 internal/js/modules/k6/grpc/client.go 中可以看到其实现逻辑当参数值大于 0 时分别通过grpc.WithDefaultCallOptions(grpc.MaxCallRecvMsgSize(...))和grpc.MaxCallSendMsgSize(...)应用到拨号选项上import grpc from k6/net/grpc; const client new grpc.Client(); // 连接时指定接收与发送消息的最大字节数 client.connect(localhost:50051, { maxReceiveSize: 1024 * 1024, // 1 MiB maxSendSize: 512 * 1024, // 512 KiB });测试用例 internal/js/modules/k6/grpc/client_test.go 中对参数做了严格校验例如maxReceiveSize: error会报错invalid maxReceiveSize value: error, it needs to be an integermaxReceiveSize: -1会报错it needs to be a positive integer说明参数必须是正整数否则连接会失败。k6 archive新增--exclude-env-vars标志PR #2605k6 archive命令新增了--exclude-env-vars布尔标志启用后归档包metadata.json中将不包含任何环境变量无论是通过--env传入的还是真实环境中的。源码实现见 internal/cmd/archive.go逻辑非常直接——将归档对象中的环境变量字段置空if c.excludeEnvVars { c.gs.Logger.Debug(environment variables will be excluded from the archive) arc.Env nil }标志定义位于 internal/cmd/archive.go官方描述为不在归档元数据中嵌入任何环境变量无论是来自--env还是实际环境。# 归档但不包含环境变量 k6 archive --exclude-env-vars -O myarchive.tar script.js # 运行生成的归档 k6 run myarchive.tar这一能力对需要共享或分发测试归档、但不想泄露环境凭据的场景非常实用。支持加载 gRPC protoset 文件issue #2700v0.41.0 为k6/net/grpc增加了加载 protoset 文件的能力。protoset 是序列化后的FileDescriptorSetprotobuf 文件描述符集合。实现位于 internal/js/modules/k6/grpc/client.go 的LoadProtoset方法它会打开文件、读取内容并反序列化对应的测试用例 internal/js/modules/k6/grpc/client_test.go 验证了 protoset 加载与错误路径文件不存在、非法 protoset 等。这使得无需在测试机上安装.proto源码即可调用 gRPC 服务。Bug 修复一览本版本修复了以下问题修复内容对应 PR / Issue说明Docker 镜像标签错误PR #2678 / issue #2677修复镜像标签问题REST API 的Content-Type响应头错误PR #2689修复 API 响应头k6 version详细版本信息错误PR #2691修复发布包中内嵌的版本信息Promise rejection 未处理导致事件循环不可用PR #2693修复事件循环卡死问题HTTP 重定向空Location头导致的问题PR #2696 / issue #2474通过将编译 k6 的 Go 版本升级到 1.19.x 解决k6/net/grpc模块 panicPR #2705 / issue #2661修复 gRPC 模块崩溃Promise 以undefined原因拒绝时 panicPR #2738修复拒绝值为undefined时的崩溃部分源自 Go 代码的错误隐藏了堆栈跟踪PR #2739修复堆栈信息缺失其中值得注意的技术细节HTTP 重定向带空Location头的问题是通过升级 Go 编译版本1.19.x修复的这说明 Go 标准库net/http的后续版本已修正相关行为k6 只需跟进编译器版本即可获益。内部架构改进本版本的核心指标时间序列Metric time seriesPR #2594在 v0.41.0 之前k6 缺乏高效的手段将具有相同标签的指标样本进行分组这导致一整类指标处理与聚合应用几乎无法实现或者效率极低。本次重构在产生指标的动作发生时即指标测量时刻就完成了相同标签样本的分组代价是上述少数破坏性变更。现在k6 可以在时间维度上高效地对同一动作例如对某个特定 URL 的 HTTP 请求产生的样本进行分组并据此构建时间序列。这一能力为后续基于时间序列的聚合、存储与查询类功能奠定了基础。从当前仓库源码可以清楚看到这套设计。TimeSeries类型在 metrics/sample.go 中定义它唯一标识一个指标 一组指标标签的组合并且可用运算符直接比较、可作为 map 索引type TimeSeries struct { Metric *Metric Tags *TagSet }而Sample单次指标测量则内嵌了TimeSeries同时持有时间戳、数值以及可选的元数据type Sample struct { TimeSeries Time time.Time Value float64 // Optional high-cardinality metadata that wont be indexed in atlas. // It can be nil if it wasnt explicitly specified, reduce memory // allocations and GC overhead. Metadata map[string]string }内部支持高基数指标元数据PR #2726、#2727时间序列的高效分组适合低基数数据但 k6 还需要一种挂载高基数元数据的途径——用于那些唯一或随机的数据例如分布式追踪中的 Trace ID、Span ID或大数据量测试中的用户 ID。v0.41.0 为指标样本增加了高基数元数据挂载能力vu和iter系统标签即被改造为此类元数据。不过该能力目前尚未对用户脚本开放还没有 JavaScript API 可以修改这些元数据现阶段只有 k6 内置 Go 模块和 xk6 Go 扩展能够使用它。标签与元数据的分离TagSet与TagsAndMetaTagSet在 metrics/tags.go 中定义是一个不可变的指标标签集合底层基于atlas数据结构实现一种共享前缀的高效不可变树结构。所有标签集合都从同一个根节点Registry.RootTagSet()出发因此不同样本的*TagSet可以用直接比较是否拥有相同标签也可用于 map 索引和缓存type TagSet atlas.Node func (ts *TagSet) With(name, value string) *TagSet // 追加/覆盖标签返回新集合 func (ts *TagSet) Without(name string) *TagSet // 移除标签 func (ts *TagSet) Get(name string) (string, bool) // 读取标签值 func (ts *TagSet) Contains(other *TagSet) bool // 子集判断 func (ts *TagSet) IsEmpty() bool // 是否为空 func (ts *TagSet) Map() map[string]string // 转为普通 mapWith/Without都不会修改接收者而是复用已有节点或创建新节点——这正是时间序列高效分组的基础相同标签集合的样本共享同一TagSet实例比较与缓存成本极低。TagsAndMeta类型metrics/tags.go则把可索引的低基数 Tags 与不可索引的高基数 Metadata 放在一起管理主要由 VU 与 JS 代码在组装最终样本时使用。关键方法SetSystemTagOrMetametrics/tags.go会根据系统标签是否不可索引自动决定写入 Tag 还是 Metadatafunc (tm *TagsAndMeta) SetSystemTagOrMeta(tag SystemTag, value string) { if NonIndexableSystemTags.Has(tag) { tm.SetMetadata(tag.String(), value) } else { tm.SetTag(tag.String(), value) } }哪些系统标签不可索引NonIndexableSystemTags在 metrics/system_tag.go 中定义正是TagIter | TagVU——即iter与vu两个高基数标签// NonIndexableSystemTags are high cardinality system tags (i.e. metadata). var NonIndexableSystemTags SystemTagSet(TagIter | TagVU)同时metrics/system_tag.go 中的DefaultSystemTagSet明确列出了默认启用的系统标签集合proto、subproto、status、method、url、name、group、check、error、error_code、tls_version、scenario、service、expected_response并注释说明默认不启用的标签包括iter、vu、ocsp_status、ip。TagIter与TagVU的声明处也标注了// non-indexablemetrics/system_tag.go。VU 级别的元数据封装VUStateTags每个虚拟用户的状态对象Statelib/vu_state.go中Tags字段的类型为*VUStateTags——它用读写锁包装TagsAndMeta保证从 JS 脚本通过k6/execution内置模块的vu.tagsAPI 并发修改时线程安全type VUStateTags struct { mutex sync.RWMutex tagsAndMeta *metrics.TagsAndMeta }这印证了发布说明中的表述高基数元数据既存在于每个Sample中也存在于 VU 级别State对象中。当样本被组装时VU 级标签/元数据与请求级标签/元数据会被合并进最终的Sample。维护与依赖更新本版本还包含一批维护性改动日志测试改进PR #2687提升了日志相关测试的质量工具链升级PR #2696将编译 k6 使用的 Go 版本升级到 1.19.xDocker 镜像的 Alpine 基础镜像升级到 3.16依赖刷新PR #2707、#2708、#2709、#2710更新了大部分 Go 依赖自定义 JS 标签应用逻辑重构PR #2716重构了自定义 JS 标签如何应用到指标样本的流程并清理了对非法标签值的校验。升级建议与总结对于大多数 k6 用户v0.41.0 升级影响集中在两点一是使用 URL 分组时http_req_*样本的url标签取值发生变化与name一致二是vu/iter标签不再可用于阈值且各输出端对其处理方式可能不同。如果你使用了k6 convert请尽快规划迁移到独立的 har-to-k6 转换器。从架构角度看v0.41.0 是 k6 指标子系统换发动机的里程碑基于TimeSeries 不可变TagSetatlas 树的样本分组机制配合Sample.Metadata与TagsAndMeta/VUStateTags的高基数元数据通道为分布式追踪指标、大规模用户数据集等场景铺平了道路。虽然这些能力当前仅面向内置 Go 模块与 xk6 扩展但后续版本极有可能向 JavaScript 层开放——理解本版本的内部设计将有助于你预判 k6 指标体系未来的演进方向。【免费下载链接】k6A modern load testing tool, using Go and JavaScript项目地址: https://gitcode.com/GitHub_Trending/k6/k6创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
k6 v0.41.0 版本解读指标时序重构、高基数元数据支持与 gRPC 增强【免费下载链接】k6A modern load testing tool, using Go and JavaScript项目地址: https://gitcode.com/GitHub_Trending/k6/k6k6 v0.41.0 是 grafana/k6 项目在 Go JavaScript 压测引擎演进中的一个关键版本它面向用户的改动相对较少但内部完成了一次影响深远的指标子系统重构为后续的时间序列聚合与分布式追踪等功能铺平了道路。本文基于官方发布说明 release notes/v0.41.0.md结合当前仓库源码完整解读本版本的破坏性变更、新特性、Bug 修复与内部架构改进帮助你评估升级影响并理解 k6 指标系统的底层设计。升级前必读本版本的破坏性变更v0.41.0 的破坏性变更主要源于指标子系统的根本性重构官方在 v0.39.0、v0.40.0 发布说明中已提前预告虽然对 JavaScript API 暂无影响但以下三点需要在使用脚本与输出系统时特别注意。url、iter、vu系统指标标签的行为变化url标签与name标签统一对应 PR #2703当 HTTP 请求使用了 URL 分组即使用http.url()帮助函数或显式指定name指标标签时生成的http_req_*指标样本中的url标签将与name标签取相同的值。此前这一行为只在云输出cloud output中生效现在则在所有输出中统一生效。vu与iter标签转为高基数元数据对应 PR #2726vu虚拟用户编号和iter迭代序号两个系统标签默认处于禁用状态现在被改造为高基数high-cardinality指标元数据。这意味着它们不再可用于阈值thresholds表达式中各输出端可能以不同方式输出它们或完全忽略它们。Go 指标 API 的变化v0.41.0 对内部 Go API 做了大规模重构对应 PR #2594、#2726、#2727其中metrics.Sample和metrics.TagSet两个类型被彻底重写。虽然 JavaScript API 没有变化但任何直接使用这两个 Go 类型的外部代码如 xk6 扩展在升级后都需要适配。k6 convert正式弃用k6 convert是一个将 HAR 文件HTTP 流量录制格式转换为粗略等价请求的初步 k6 脚本的子命令。它长期缺乏维护官方一直建议使用功能更丰富的独立转换器 har-to-k6本次版本正式将其标记为弃用该命令仍然可用并且会在后续若干个 k6 版本中继续工作它不再出现在k6 --help帮助信息中使用时会产生弃用警告。官方建议迁移到独立的 har-to-k6 转换器若遇到问题可在其仓库中反馈。新特性与 UX 改进gRPCClient.connect()新增maxReceiveSize与maxSendSize参数PR #2679k6/net/grpc模块的Client.connect()方法新增了两个可选参数用于控制 gRPC 消息大小上限。在源码 internal/js/modules/k6/grpc/client.go 中可以看到其实现逻辑当参数值大于 0 时分别通过grpc.WithDefaultCallOptions(grpc.MaxCallRecvMsgSize(...))和grpc.MaxCallSendMsgSize(...)应用到拨号选项上import grpc from k6/net/grpc; const client new grpc.Client(); // 连接时指定接收与发送消息的最大字节数 client.connect(localhost:50051, { maxReceiveSize: 1024 * 1024, // 1 MiB maxSendSize: 512 * 1024, // 512 KiB });测试用例 internal/js/modules/k6/grpc/client_test.go 中对参数做了严格校验例如maxReceiveSize: error会报错invalid maxReceiveSize value: error, it needs to be an integermaxReceiveSize: -1会报错it needs to be a positive integer说明参数必须是正整数否则连接会失败。k6 archive新增--exclude-env-vars标志PR #2605k6 archive命令新增了--exclude-env-vars布尔标志启用后归档包metadata.json中将不包含任何环境变量无论是通过--env传入的还是真实环境中的。源码实现见 internal/cmd/archive.go逻辑非常直接——将归档对象中的环境变量字段置空if c.excludeEnvVars { c.gs.Logger.Debug(environment variables will be excluded from the archive) arc.Env nil }标志定义位于 internal/cmd/archive.go官方描述为不在归档元数据中嵌入任何环境变量无论是来自--env还是实际环境。# 归档但不包含环境变量 k6 archive --exclude-env-vars -O myarchive.tar script.js # 运行生成的归档 k6 run myarchive.tar这一能力对需要共享或分发测试归档、但不想泄露环境凭据的场景非常实用。支持加载 gRPC protoset 文件issue #2700v0.41.0 为k6/net/grpc增加了加载 protoset 文件的能力。protoset 是序列化后的FileDescriptorSetprotobuf 文件描述符集合。实现位于 internal/js/modules/k6/grpc/client.go 的LoadProtoset方法它会打开文件、读取内容并反序列化对应的测试用例 internal/js/modules/k6/grpc/client_test.go 验证了 protoset 加载与错误路径文件不存在、非法 protoset 等。这使得无需在测试机上安装.proto源码即可调用 gRPC 服务。Bug 修复一览本版本修复了以下问题修复内容对应 PR / Issue说明Docker 镜像标签错误PR #2678 / issue #2677修复镜像标签问题REST API 的Content-Type响应头错误PR #2689修复 API 响应头k6 version详细版本信息错误PR #2691修复发布包中内嵌的版本信息Promise rejection 未处理导致事件循环不可用PR #2693修复事件循环卡死问题HTTP 重定向空Location头导致的问题PR #2696 / issue #2474通过将编译 k6 的 Go 版本升级到 1.19.x 解决k6/net/grpc模块 panicPR #2705 / issue #2661修复 gRPC 模块崩溃Promise 以undefined原因拒绝时 panicPR #2738修复拒绝值为undefined时的崩溃部分源自 Go 代码的错误隐藏了堆栈跟踪PR #2739修复堆栈信息缺失其中值得注意的技术细节HTTP 重定向带空Location头的问题是通过升级 Go 编译版本1.19.x修复的这说明 Go 标准库net/http的后续版本已修正相关行为k6 只需跟进编译器版本即可获益。内部架构改进本版本的核心指标时间序列Metric time seriesPR #2594在 v0.41.0 之前k6 缺乏高效的手段将具有相同标签的指标样本进行分组这导致一整类指标处理与聚合应用几乎无法实现或者效率极低。本次重构在产生指标的动作发生时即指标测量时刻就完成了相同标签样本的分组代价是上述少数破坏性变更。现在k6 可以在时间维度上高效地对同一动作例如对某个特定 URL 的 HTTP 请求产生的样本进行分组并据此构建时间序列。这一能力为后续基于时间序列的聚合、存储与查询类功能奠定了基础。从当前仓库源码可以清楚看到这套设计。TimeSeries类型在 metrics/sample.go 中定义它唯一标识一个指标 一组指标标签的组合并且可用运算符直接比较、可作为 map 索引type TimeSeries struct { Metric *Metric Tags *TagSet }而Sample单次指标测量则内嵌了TimeSeries同时持有时间戳、数值以及可选的元数据type Sample struct { TimeSeries Time time.Time Value float64 // Optional high-cardinality metadata that wont be indexed in atlas. // It can be nil if it wasnt explicitly specified, reduce memory // allocations and GC overhead. Metadata map[string]string }内部支持高基数指标元数据PR #2726、#2727时间序列的高效分组适合低基数数据但 k6 还需要一种挂载高基数元数据的途径——用于那些唯一或随机的数据例如分布式追踪中的 Trace ID、Span ID或大数据量测试中的用户 ID。v0.41.0 为指标样本增加了高基数元数据挂载能力vu和iter系统标签即被改造为此类元数据。不过该能力目前尚未对用户脚本开放还没有 JavaScript API 可以修改这些元数据现阶段只有 k6 内置 Go 模块和 xk6 Go 扩展能够使用它。标签与元数据的分离TagSet与TagsAndMetaTagSet在 metrics/tags.go 中定义是一个不可变的指标标签集合底层基于atlas数据结构实现一种共享前缀的高效不可变树结构。所有标签集合都从同一个根节点Registry.RootTagSet()出发因此不同样本的*TagSet可以用直接比较是否拥有相同标签也可用于 map 索引和缓存type TagSet atlas.Node func (ts *TagSet) With(name, value string) *TagSet // 追加/覆盖标签返回新集合 func (ts *TagSet) Without(name string) *TagSet // 移除标签 func (ts *TagSet) Get(name string) (string, bool) // 读取标签值 func (ts *TagSet) Contains(other *TagSet) bool // 子集判断 func (ts *TagSet) IsEmpty() bool // 是否为空 func (ts *TagSet) Map() map[string]string // 转为普通 mapWith/Without都不会修改接收者而是复用已有节点或创建新节点——这正是时间序列高效分组的基础相同标签集合的样本共享同一TagSet实例比较与缓存成本极低。TagsAndMeta类型metrics/tags.go则把可索引的低基数 Tags 与不可索引的高基数 Metadata 放在一起管理主要由 VU 与 JS 代码在组装最终样本时使用。关键方法SetSystemTagOrMetametrics/tags.go会根据系统标签是否不可索引自动决定写入 Tag 还是 Metadatafunc (tm *TagsAndMeta) SetSystemTagOrMeta(tag SystemTag, value string) { if NonIndexableSystemTags.Has(tag) { tm.SetMetadata(tag.String(), value) } else { tm.SetTag(tag.String(), value) } }哪些系统标签不可索引NonIndexableSystemTags在 metrics/system_tag.go 中定义正是TagIter | TagVU——即iter与vu两个高基数标签// NonIndexableSystemTags are high cardinality system tags (i.e. metadata). var NonIndexableSystemTags SystemTagSet(TagIter | TagVU)同时metrics/system_tag.go 中的DefaultSystemTagSet明确列出了默认启用的系统标签集合proto、subproto、status、method、url、name、group、check、error、error_code、tls_version、scenario、service、expected_response并注释说明默认不启用的标签包括iter、vu、ocsp_status、ip。TagIter与TagVU的声明处也标注了// non-indexablemetrics/system_tag.go。VU 级别的元数据封装VUStateTags每个虚拟用户的状态对象Statelib/vu_state.go中Tags字段的类型为*VUStateTags——它用读写锁包装TagsAndMeta保证从 JS 脚本通过k6/execution内置模块的vu.tagsAPI 并发修改时线程安全type VUStateTags struct { mutex sync.RWMutex tagsAndMeta *metrics.TagsAndMeta }这印证了发布说明中的表述高基数元数据既存在于每个Sample中也存在于 VU 级别State对象中。当样本被组装时VU 级标签/元数据与请求级标签/元数据会被合并进最终的Sample。维护与依赖更新本版本还包含一批维护性改动日志测试改进PR #2687提升了日志相关测试的质量工具链升级PR #2696将编译 k6 使用的 Go 版本升级到 1.19.xDocker 镜像的 Alpine 基础镜像升级到 3.16依赖刷新PR #2707、#2708、#2709、#2710更新了大部分 Go 依赖自定义 JS 标签应用逻辑重构PR #2716重构了自定义 JS 标签如何应用到指标样本的流程并清理了对非法标签值的校验。升级建议与总结对于大多数 k6 用户v0.41.0 升级影响集中在两点一是使用 URL 分组时http_req_*样本的url标签取值发生变化与name一致二是vu/iter标签不再可用于阈值且各输出端对其处理方式可能不同。如果你使用了k6 convert请尽快规划迁移到独立的 har-to-k6 转换器。从架构角度看v0.41.0 是 k6 指标子系统换发动机的里程碑基于TimeSeries 不可变TagSetatlas 树的样本分组机制配合Sample.Metadata与TagsAndMeta/VUStateTags的高基数元数据通道为分布式追踪指标、大规模用户数据集等场景铺平了道路。虽然这些能力当前仅面向内置 Go 模块与 xk6 扩展但后续版本极有可能向 JavaScript 层开放——理解本版本的内部设计将有助于你预判 k6 指标体系未来的演进方向。【免费下载链接】k6A modern load testing tool, using Go and JavaScript项目地址: https://gitcode.com/GitHub_Trending/k6/k6创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
`：用 HSL 色轮生成四色配色方案)
