/k6-cloud-grafana-datasource

Grafana data source plugin for accessing load tests and results from k6 Cloud

Primary LanguageTypeScriptApache License 2.0Apache-2.0

k6 Cloud Grafana Data Source Plugin

CircleCI Marketplace Downloads License Known Vulnerabilities Maintainability Test Coverage

This Grafana data source plugin allows you to view your tests results stored in k6 Cloud in Grafana.

k6 Cloud Test Run Result Dashboard

Installation

This plugin requires Grafana 7.1.0 or newer as of version 0.1.0.

Grafana Cloud

If you do not have a Grafana Cloud account, you can sign up for one here.

  1. Click on the Install Now button on the K6 Cloud Data Source page on Grafana.com. This will automatically add the plugin to your Grafana instance. It might take up to 30 seconds to install.

  2. Login to your Hosted Grafana instance (go to your instances page in your profile): https://grafana.com/orgs/<yourUserName>/instances/ and the K6 Cloud data source will be installed.

Installing on a local Grafana instance

The plugin is installed using the Grafana CLI and instructions can be found on the installation page.

Restart your Grafana server after installing the plugin.

Configure the data source

Accessed from the Grafana main menu, newly installed data sources can be added immediately within the Data Sources section.

Next, click the Add data source button in the upper right. The K6 Cloud data source will be available for selection in the Type select box.

Copy your K6 Token and paste into the API Token field. Click the Save and Testbutton to check that your Token is valid and that you have a connection to the K6 Cloud.

Sample Dashboard

There are two sample dashboards included with the data source and they can be imported from the Dashboards tab (beside the Settings tab) in the Data Source config.

They can also be found in the GitHub repository in the dashboards directory.

Contributing and local development

Instructions for building the plugin from source can be found at Contributing.

Learn more