用途:与 Grafana Cloud k6(GCk6)交互,管理负载测试、测试运行、脚本、项目、计划、环境变量,获取指标或日志,并在本地运行脚本。
主要能力:默认路径为 gcx CLI,优先使用 gcx k6 ... 子命令(可用 gcx help-tree k6 发现),无对应子命令时回退到 gcx api。覆盖 REST(/cloud/v6、/cloud/v5、/cloud-resources/v1、/insights)、Loki 日志与 Tempo 追踪查询。
认证:gcx 模式下执行 gcx login --context <ctx> 完成 OAuth,之后调用自动继承认证,不要自行设置认证头。未安装 gcx 时可用 curl 直连:REST 走 https://api.k6.io,日志与追踪走 https://cloudlogs.k6.io,需手动设置 Authorization: Bearer <k6_token> 与 X-Stack-ID: <int>;仅 /cloud/v6/auth 使用 X-Stack-Url 换取 stack_id。
用法要点:gcx api 的响应体输出到 stdout,-o 用于选择输出格式而非保存文件;请求体用 -d;可用 --json 做字段筛选;大响应会溢出到临时文件并返回信封,建议加 -o json 或读取 spilled_to。列表端点支持 OData 参数 $orderby、$top、$skip、$count,默认升序且每页上限 1000,可用 @nextLink 翻页。日志查询必须带 {test_run_id="<run_id>"} 选择器,并手动设置 X-K6TestRun-Id。
限制:插件代理会把 multipart Content-Type 改写为 JSON,导致创建测试等需要 multipart 的端点返回 415,需改用 curl 直连 api.k6.io。指标查询位于 v5 API,语义与 v6 OpenAPI 不同。资料未提供具体收费、价格与平台支持信息。