Want some graphs? It's simpler than you think, using InfluxDB for data storage and Grafana for visualization.
First, you need to install InfluxDB.For Ubuntu users:
sudo apt-get install influxdb
For MacOS users:
brew install influxdbThen you need to install Grafana also.Ubuntu users:
sudo apt-get install grafana
brew install grafanaAfter this, you should have an InfluxDB server running on localhost, listening on port 8086, and a Grafana server on http://localhost:3000
k6 has built-in support for outputting results data directly to an InfluxDB database using the
k6 run --out influxdb=http://localhost:8086/myk6db script.js
docker run -i loadimpact/k6 run --out influxdb=http://localhost:8086/myk6db - <script.js
The above command line makes k6 connect to a local influxdb instance and send results data from the test to a database named
myk6db. If this database does not exist, k6 will create it automatically.Once you have k6 results in your InfluxDB database, you can use Grafana to create results visualizations.
- Open http://localhost:3000 (or wherever your Grafana installation is located) in your browser.- Create a data source:
click picture to enlarge
- Now create a dashboard. Here is the newly created dashboard:
Graphto create a new graph panel:
- Click the
Panel titleand then
Editto set up the graph panel:
- Set the panel data source to your
myk6dbdatabase and click the
SELECT mean(value)...statement to edit the metric:
select measurement text lets you choose a metric to plot
To make all the above even simpler, we have created a docker-compose setup that will:
- Start a Docker container with InfluxDB
- Start a Docker container with Grafana
- Make available a k6 container that you can use to run load tests.
Make sure you have at least docker-compose version v1.12.0 installed.
You just need to do the following:
git clone 'https://github.com/loadimpact/k6' cd k6 docker-compose up -d influxdb grafana docker-compose run --rm k6 run /scripts/es6sample.js
Now you should be able to connect to
http://localhost:3000 with your browser and access the Grafana installation in the Docker container.
It is important to note that a volume is in place binding
/scripts. And to re-run the test use the command
docker-compose run --rm k6 run /scripts/es6sample.js again.
Here we will list premade Grafana dashboard configurations contributed by users, for use with k6. To enable a contributed Grafana dashboard is simple: you just choose to "import" a dashboard in the Grafana UI and then specify the ID number of the dashboard you want, see http://docs.grafana.org/reference/export_import/ for more details.
ID 2587, by Dave Cadwallader -