Correlate results in Grafana
A unique advantage of combining k6 with Grafana is that you can compare data from both sides of the test―server-side and client-side metrics―in one place. Add test results data to your Grafana dashboards for easy correlation between test results and other system metrics.
Placing your test results alongside other panels can be a powerful tool for test analysis. For example, you could compare CPU utilization with built-in k6 HTTP metrics such as:
http_reqs
, to measure traffic arrival in requestshttp_req_duration
, to measure latency in request durationhttp_req_failed
, to measure availability in terms of successful requests.
In this example, with only four measurements, you could graphically explore the relationships between something like the four golden signals.
Explore
Use Grafana Explore to query metrics and show test results as graph and a table. You can query distinct data types from multiple sources and visualize them together for comparison and correlation.
To work directly with the k6 queries of a panel on Explore:
Navigate to a test result view.
Find a panel to query their metrics.
Click the actions menu (three dots).
Click Explore.
Explore displays the metric or group of metrics.
Copy a Grafana Cloud k6 panel to a dashboard
Add a k6 panel to a dashboard when you want to visualize k6 results with other existing visualizations, such as observability data of the system under test.
- Find the k6 panel.
- Click the actions menu (three dots).
- Click Copy to Clipboard.
- Navigate to the dashboard that you want to add the panel.
- At the top of the dashboard, click Add and select Paste panel.
After you add the k6 panel to a dashboard, you can edit and customize the panel options.
Change the panel visualization
To change the panel visualization:
- Hover over any part of the panel to display the actions menu (three dots) on the top right corner.
- Click the menu and select Edit.
- Click the name of the current visualization to see a list of all visualizations, and select the one you want.
The majority of the k6 panels are Time series
visualizations.
For details, refer to query types.
Add a panel for the Grafana Cloud k6 data source
To add k6 metrics as a panel, follow these steps:
- Open the dashboard that you want to add the panel to.
- At the top of the dashboard, click Add and select Visualization.
- For Data source, choose
k6
. - Filter for your Test, Test run, Project, and Query type.
- Save.
Analyze test trends
You can analyze test trends across multiple test runs by using Grafana Explore. To do that:
- Log in to your Grafana Cloud account.
- Click Explore on the main menu.
- Select grafanacloud-k6 as the data source.
- Select Metrics as the Query Type.
- Select a project and a test. Leave the Test Run field empty.
- Select a metric from the Metric drop-down menu.
- Depending on the metric you choose, you can see different options for the Aggregation and Group by fields.
- Click Run query at the top right.
After you run the query, you can see a preview of the graph and table views for the selected data. You can then click Add > Add to dashboard to add this panel to a dashboard, and continuously analyze metrics from your performance tests over time.