Slide 3 of 6

First test learning path

Learning path: Run your first k6 performance test

StepWhat you’ll doOutcome
1. Install k6Download and install the k6 CLIk6 available in your terminal
2. Write a test scriptCreate a JavaScript file with HTTP requests and checksA complete test script
3. Run locallyExecute k6 run test.js and read the outputTerminal metrics: latency, throughput, errors
4. Connect to Grafana CloudAuthorize the CLI with a Grafana Cloud k6 API token (k6 cloud login)Ready for Grafana Cloud k6
5. Run on Grafana Cloud k6Execute k6 cloud run test.jsStored run in Grafana Cloud k6 dashboards

Before you start

Have these ready before you open the path (the path itself installs k6 and walks through the script):

  • Terminal, code editor, and your Grafana Cloud account
  • Targets QuickPizza only in this path (not your production systems)
  • Optional — help with the script: In Grafana Cloud, use Grafana Assistant in k6 Script Authoring mode to draft or refine the JavaScript before you run locally. Refer to Use k6 Script Authoring mode; the Prerequisites slide summarizes access, when Assistant is not visible, and an example prompt you can paste. Use Assistant output as a draft and match the path’s script.js before k6 run.
Learning path

Run your first k6 performance test

Welcome to the Grafana learning path that shows you how to write, run, and analyze your first k6 performance test, from installation to visualizing results in Grafana Cloud.

15 min
Beginner
Docs & blog posts

Open in Grafana Cloud

Complete this learning path directly in your Grafana Cloud stack with an interactive learning experience.

Open in Grafana Cloud
View on website

Script

Time to put these concepts into practice. Before you open the path, have a terminal, a code editor, and your Grafana Cloud account ready. The path installs k6 and uses QuickPizza only, not your production systems.

The learning path walks you through every step: installing k6, writing a test script, running it locally, sending results to Grafana Cloud, and analyzing what the numbers mean. Work through each milestone in order.

/
Previous Next