No results for

Powered byAlgolia

Grafana App

The k6 Cloud app for Grafana simulates the k6 Cloud UI in your dashboard. While the Grafana App does not yet support all the features of k6 Cloud we are actively working on reaching feature parity.

Currently supported features:

  • manage and visualize your k6 Cloud tests in Grafana.
  • add k6 visualizations to your existing Grafana dashboards.
  • correlate k6 metrics with other metrics to find root causes quickly.
  • create new and update existing tests using the script editor
  • use dashboard variables to quickly switch between test runs

Installing the Grafana App

To install the k6 app

  1. In Grafana Cloud, select the Install plugin button on the k6 Cloud app installation page. This automatically adds the app to your Grafana stack.

    For local Grafana instances, follow the grafana-cli instructions.

  2. After you install, log in to your Grafana instance, and check that the k6 icon appears in the sidebar menu.

  3. To add the k6 Cloud app data source to use the application, select Data sources and then k6 Cloud app data source.

k6 data source configuration

The k6 Cloud app needs your API token to connect to your k6 Cloud account.

  1. Head to your k6 Cloud API token and copy your API token.
  2. Paste the token into the API Token field.
  3. Test that your token is valid and connection is up with Save & test.

The k6 Cloud app for Grafana, like the k6 Cloud web app, provides a dashboard including all your tests for a particular project. This view will be familiar for k6 Cloud users. Here, you can select any project and navigate to any test or test runs.

k6 project overview

Enhanced visualizations of k6 results

The k6 results view mirrors its counterpart on the k6 Cloud. In this first version, you'll find an overview of important performance testing metrics and the results of the most relevant k6 reports, such as HTTP requests, thresholds, and checks.

k6 test results

The k6 Cloud app for Grafana is still in beta. The k6 Cloud currently supports more features than the Grafana app.

If you want to visualize your test results on the k6 Cloud, select Open in k6 Cloud to jump quickly to the same page on the k6 Cloud and explore from there.

k6 cloud test result visualization

Correlate testing results with other metrics

You can copy relevant metrics from your test result to a Grafana dashboard. In this dashboard, you can visualize k6 metrics with other metrics of your application or systems and bring QA data to any of your existing dashboards. To copy a metric:

  1. Next to a chart on the test results view, select Copy to clipboard.
  2. Head to a dashboard, and paste same time-series panel in.

k6 grafana dashboard

Add dashboard variables to switch between test runs

Dashboard variables are useful when you need to switch between test runs often, without editing panel's query. You can select test run using the dropdown at the top of the dashboard, all your panels which use the variables will update automatically.

To setup open dashboard settings -> variables

  1. Add organization variable k6 grafana add org

  2. Add project variable k6 grafana add project

  3. Add test variable k6 grafana add test

  4. Add testrun variable k6 grafana add testrun

  5. Update panel to use variables k6 grafana use variables in panel