Documentationbreadcrumb arrow Learning pathsbreadcrumb arrow Run your first k6 performance test
Run your first k6 performance test
11 min
Milestone 1
Understand the value
1 min
Milestone 2
Install k6
1 min
Milestone 3
Write test script
2 min
Milestone 4
Run locally
1 min
Milestone 5
Send to Grafana Cloud
1 min
Milestone 6
Analyze results
2 min
Milestone 7
Destination reached
1 min

Open in Grafana Cloud

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

Open in Grafana Cloud

Run your first k6 performance test

k6 is a modern performance testing tool that helps developers simulate realistic user behavior and test how their systems behave under load. By writing k6 test scripts, you can identify potential issues such as slow response times or system failures before they occur in production.

This journey guides you through the complete process of creating and running a k6 performance test, from understanding the value of performance testing to analyzing results in Grafana Cloud. You’ll learn how to write test scripts, run them locally, send results to Grafana Cloud, and visualize metrics in dashboards.

Grafana Cloud users: you can also explore the Performance home page. Go to Testing & synthetics > Performance to open projects from Recent activity or Starred, click Create a test or Run a test, see Active test runs, and open Resources for support and learning links. Every stack includes a Default project, so you can run tests without creating a project first.

This guide complements the in-product experience with step-by-step CLI instructions you can follow at your own pace.

Here’s what to expect

When you complete this journey, you’ll be able to:

  • Understand the value of performance testing with k6
  • Install k6 on your machine
  • Write your first k6 test script
  • Run a test locally and view results
  • Send test results to Grafana Cloud
  • Analyze test results in Grafana Cloud dashboards

Before you begin

Before you run your first k6 performance test, ensure that you have:

  • Basic knowledge of JavaScript or TypeScript (k6 scripts are written in JavaScript/TypeScript).
  • A code editor to write your scripts, such as Visual Studio Code or Cursor editors.
  • Access to a terminal or command line interface.
  • A basic understanding of HTTP requests and web applications.

Troubleshooting

If you get stuck, we’ve got your back! Where appropriate, troubleshooting information is just a click away.

More to explore

We understand you might want to explore other capabilities not strictly on this path. We’ll provide you opportunities where it makes sense.

Are you ready?
Let's go!