Testing

# Via token
k6 cloud login --token <your-grafana-cloud-token>

# Via environment variable
export K6_CLOUD_TOKEN=<your-token>

# Verify
k6 cloud login --show

# Run in cloud (full cloud execution)
k6 cloud script.js

# Run locally, stream results to cloud
k6 run --out cloud script.js

# Run with environment variables
k6 cloud -e API_URL=https://api.example.com script.js

# Run with specific project
k6 cloud --project-id 123456 script.js

# Local execution (run on cloud infra but with local VUs)
k6 cloud run --local-execution script.js

export const options = {
  cloud: {
    // Required
    projectID: 3456789,

    // Optional
    name: 'API Load Test - Release v2.0',
    note: 'Testing new checkout flow',

    // Load zone distribution
    distribution: {
      loadZone1: { loadZone: 'amazon:us:ashburn',    percent: 40 },
      loadZone2: { loadZone: 'amazon:us:portland',   percent: 20 },
      loadZone3: { loadZone: 'amazon:eu:dublin',     percent: 20 },
      loadZone4: { loadZone: 'amazon:ap:singapore',  percent: 20 },
    },

    // Static IPs (Enterprise)
    staticIPs: false,
  },
};

- name: Run k6 Cloud Test
  uses: grafana/[email protected]
  with:
    filename: tests/load.js
    cloud: true
    token: ${{ secrets.K6_CLOUD_TOKEN }}

k6-cloud:
  image: grafana/k6
  script:
    - k6 cloud login --token $K6_CLOUD_TOKEN
    - k6 cloud tests/load.js
  only:
    - main

- run:
    name: Run k6 Cloud Test
    command: |
      k6 cloud login --token $K6_CLOUD_TOKEN
      k6 cloud tests/load.js

BASE=https://api.k6.io/v3
TOKEN=your-token

# List projects
curl $BASE/projects -H "Authorization: Token $TOKEN"

# List test runs for a project
curl "$BASE/projects/{projectId}/test-runs" -H "Authorization: Token $TOKEN"

# Get test run details + results
curl "$BASE/runs/{runId}" -H "Authorization: Token $TOKEN"

# Get metrics for a run
curl "$BASE/runs/{runId}/metrics" -H "Authorization: Token $TOKEN"

# Stop a running test
curl -X POST "$BASE/runs/{runId}/stop" -H "Authorization: Token $TOKEN"

# Create a scheduled test
curl -X POST "$BASE/projects/{projectId}/schedules" \
  -H "Authorization: Token $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Nightly load test",
    "script_id": 123,
    "cron": "0 2 * * *",
    "timezone": "UTC"
  }'

# View results summary after cloud run
k6 cloud --results-id {runId}

# Export results as JSON
k6 cloud --results-export results.json