用途:对 Grafana Cloud k6 的测试或某次运行做结构化调查,回答“这次运行为何失败”“最近运行情况如何”等问题。该技能本身只提供工作流,所有 API 调用通过 gcx api 走插件代理,REST 用 v6、指标用 v5;底层机制(gcx 认证、路径约定、端点发现、日志查询、脚本编辑、阈值语义、常见坑)参见 k6-manage 技能。
主要能力:按 9 步流程推进——1) 从 URL 识别测试或运行;2) 获取测试元数据与脚本;3) 分页列出运行历史;4) 校验日期范围与用户意图是否一致(“最近 7 天”不等于“最近 7 次运行”);5) 用三层判定通过/失败(result、status、逐 check 的 checks 指标);6) 拉取指标时序与聚合;7) 拉取日志;8) 按需安全编辑脚本;9) 按单次调查或多运行对比模板输出报告。
必要用法:需先安装并认证 gcx,可用 gcx --context <stack> config check 验证连通性。常用命令包括 gcx --context <stack> k6 load-tests get <test_id> -o json、gcx --context <stack> api /api/plugins/k6-app/resources/cloud/cloud/v6/test_runs/<run_id>,以及 v5 的 metrics、labels、query_range_k6、query_aggregate_k6 等端点。
限制与注意:写操作前必须先 GET,update-script 会替换线上脚本;枚举运行需分页,/test_runs 上限 1000 行且 --limit 0 不自动跟随 @nextLink;check() 不影响运行结果,只有阈值决定 result,且零观测的阈值会显示为通过;云端阈值每 60 秒评估一次,abortOnFail 可能延迟;调查历史运行应使用该次运行捆绑的脚本快照,而非当前脚本。具体端点细节与坑位参见 k6-manage 相关章节。