Grafana Cloud Prometheus

注意
此页面包含有关运行本地测试并将测试结果发送到 Grafana Cloud 中 Prometheus 实例的说明。
要在 Grafana Cloud 中运行和管理云测试，请查阅Grafana Cloud k6。

您可以将您的 k6 结果发送到运行在Grafana Cloud中的 Prometheus 实例，以便进行可视化和分析。将 k6 指标导入 Grafana 后，您可以将其与其他可观测性指标进行关联。

虽然本主题以 Grafana Cloud 为例，但此方法兼容任何支持远程写入的 Prometheus 安装。

设置 Grafana Cloud Prometheus

在开始之前，您需要具备以下条件

一个 Grafana Cloud 帐户（注册）。免费计划包含 10,000 个 Prometheus 指标序列。
您的 Grafana Cloud Prometheus 实例的 URL、用户名和密码，用于配置集成。

设置好您的帐户后，请按照以下步骤操作

登录Grafana.com并访问Cloud Portal。选择您的 Prometheus 服务的详情。
复制远程写入端点 (Remote Write Endpoint) 的 URL 以及用户名 (Username) 和实例 ID (Instance ID)。
在密码 / API 令牌部分，创建并复制一个Grafana Cloud Access Policy Token，具有metrics:write范围（权限）。该令牌将用作密码。

运行测试

现在，将 Grafana Cloud Prometheus 配置的用户名、Access Policy Token 和远程写入端点传递给 k6 二进制文件

K6_PROMETHEUS_RW_USERNAME=USERNAME \
K6_PROMETHEUS_RW_PASSWORD=ACCESS_POLICY_API_TOKEN \
K6_PROMETHEUS_RW_SERVER_URL=REMOTE_WRITE_ENDPOINT \
k6 run -o experimental-prometheus-rw script.js

可视化测试结果

要在 Grafana 中可视化测试结果，您可以导入由 Grafana k6 提供的k6 Prometheus 仪表盘。

在仪表盘 UI 上

点击新建并选择导入。
粘贴仪表盘的 Grafana URL 或 ID，然后点击加载。
选择 Prometheus 数据源，然后点击导入。

（可选）运行测试时，您可以将testid标签设置为测试范围标签，以便在此仪表盘（或 PromQL 查询）中过滤特定测试运行的结果。testid可以是任何用于标识测试运行的唯一字符串。

K6_PROMETHEUS_RW_USERNAME=USERNAME \
K6_PROMETHEUS_RW_PASSWORD=ACCESS_POLICY_API_TOKEN \
K6_PROMETHEUS_RW_SERVER_URL=REMOTE_WRITE_ENDPOINT \
k6 run -o experimental-prometheus-rw --tag testid=TEST_ID script.js

此外，您还可以使用探索 UI查询 k6 时间序列，设计您的可视化面板，并将其添加到您现有的任何仪表盘中。

所有 k6 时间序列都带有k6_前缀。更多详情请参阅有关k6 指标与 Prometheus 指标映射的文档。

理解默认的趋势指标转换过程以及格式和查询限制也非常重要。K6_PROMETHEUS_RW_TREND_STATS选项允许您将趋势指标转换为多个 Prometheus 时间序列。例如，K6_PROMETHEUS_RW_TREND_STATS=p(95),p(99),max,min将每个 k6 趋势指标转换为以下四个 Prometheus 指标