菜单
开源

Dynatrace

借助 Dynatrace k6 扩展,您可以将性能测试指标可视化并与您在 Dynatrace 中监控的其他指标关联起来。

构建 k6 版本

要构建带有扩展的 k6 二进制文件,首先请确保您的机器上已安装 GoGit

然后,打开您的终端并运行以下命令

bash
# Install xk6
go install go.k6.io/xk6/cmd/xk6@latest

# Build the k6 binary
xk6 build --with github.com/Dynatrace/xk6-output-dynatrace

... [INFO] Build environment ready
... [INFO] Building k6
... [INFO] Build complete: ./k6

xk6 将在本地文件夹中创建新的 k6 二进制文件。

注意

要了解更多关于如何构建自定义 k6 版本的信息,请查看 xk6

运行测试

创建 Dynatrace API token 以发送数据。

注意

Dynatrace API Token 必须具有“metrics.ingest”作用域名称(作用域类型为 API v2)。

您可以使用 Dynatrace UI

Dynatrace API token

或者使用 curl 命令(替换 `` 和 `Api-Token`)

bash
curl -X POST "https://<environment-id>.live.dynatrace.com/api/v2/apiTokens" -H "accept: application/json; charset=utf-8" -H "Content-Type: application/json; charset=utf-8" -d "{\"name\":\"\",\"scopes\":[\"metrics.ingest\"]}" -H "Authorization: Api-Token XXXXXXXX"

使用先前构建的 k6 二进制文件并按如下方式运行测试,传递 Dynatrace URL 和 API token

bash
# export dynatrace variables
export K6_DYNATRACE_URL=https://<environmentid>.live.dynatrace.com
export K6_DYNATRACE_APITOKEN=<Dynatrace API token>

# run the test
./k6 run script.js -o output-dynatrace

在您的 Dynatrace 环境中检查指标,按 k6 过滤

Dynatrace Test result

Dynatrace Test result

选项

将 k6 结果流式传输到 Dynatrace 时,您可以配置以下 Dynatrace 选项

名称
K6_DYNATRACE_APITOKEN用于写入指标的 Dynatrace API token。该 token 必须具有 `metrics.ingest API v2` 作用域。
K6_DYNATRACE_FLUSH_PERIOD定义向 Dynatrace 发送指标的频率。默认值为 1 秒。
K6_DYNATRACE_URLDynatrace URL。默认值为 `https://dynatrace.live.com`。
K6_DYNATRACE_INSECURE_SKIP_TLS_VERIFY如果为 `true`,HTTP 客户端将跳过端点上的 TLS 验证。默认值为 `true`。
K6_DYNATRACE_HEADER_要包含在 HTTP 请求中的附加头部。`K6_DYNATRACE_HEADER_COOL_HEADER="header的值"`