---
title: "First test learning path | Grafana Labs"
description: "Hands-on learning path to run your first k6 performance test"
---

> For a curated documentation index, see [llms.txt](/llms.txt). For the complete documentation index, see [llms-full.txt](/llms-full.txt).

## Learning path: Run your first k6 performance test

| Step                            | What you’ll do                                                         | Outcome                                       |
|---------------------------------|------------------------------------------------------------------------|-----------------------------------------------|
| **1. Install k6**               | Download and install the k6 CLI                                        | k6 available in your terminal                 |
| **2. Write a test script**      | Create a JavaScript file with HTTP requests and checks                 | A complete test script                        |
| **3. Run locally**              | Execute `k6 run test.js` and read the output                           | Terminal metrics: latency, throughput, errors |
| **4. Connect to Grafana Cloud** | Authorize the CLI with a Grafana Cloud k6 API token (`k6 cloud login`) | Ready for Grafana Cloud k6                    |
| **5. Run on Grafana Cloud k6**  | Execute `k6 cloud run test.js`                                         | Stored 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](/docs/grafana-cloud/testing/k6/author-run/k6-script-authoring-mode/); the [Prerequisites](../../01-intro/06-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](/docs/learning-paths/run-first-k6-test/)