Awesome

xk6-output-prometheus-remote

The xk6-output-prometheus-remote extension allows you to publish test-run metrics to Prometheus via Remote Write endpoint.

:warning: Be careful not to confuse this with the Prometheus Remote Write client extension which is used for load and performance testing of Prometheus itself.

As of k6 v0.42.0, this extension is available within k6 as an experimental module. This means that the extension is in the process of being fully merged into the core of k6 and doesn't require a special build with xk6 to use this feature. For further details, read the extension graduation guide.

Usage

Consult the Prometheus remote write guide in the k6 docs to explore the various methods and options for sending k6 metrics to a Prometheus remote-write endpoint.

Development

For developing or testing this extension, you can build a k6 binary with the local extension using xk6 with the following steps:

xk6 build --with github.com/grafana/xk6-output-prometheus-remote=. 

For more details, refer to the k6 docs:

• Build a k6 binary using Go
• k6 output extensions

Dashboards

<img src="./images/dashboard-k6-prometheus-upper-section.png" width="500"/>

This repo contains the source code of two Grafana dashboards designed to visualize test results: k6 Prometheus and k6 Prometheus (Native Histograms).

Visit the documentation to learn more about these dashboards. You can import them to your Grafana instance or with the docker-compose example on this repo.

🌟 Special thanks to jwcastillo for his contributions and dedication to improving the dashboards.